Request KYC Errors

Request KYC - KYC-LITE, DOC_KYC, RECEIVE_ONLY, KYB

Errors pertaining to request_kyc endpoint for KYC-LITE, DOC_KYC, RECEIVE_ONLY, KYB
> WIP: Error Handling in Progress

  • Unlike with KYC, with KYB the KYC_LEVEL does not need to be specified explicitly by your API request. Instead, KYB levels are applied to the business entity based on the business type.*

Error Code

Description

Troubleshooting

Error Status Code

DOCUMENT_UPLOAD_REQUIRED

Document upload required.

Please upload the necessary documents for review.

400

MULTIPLE_APP_KYC_LEVELS

    Possible reasons this error could be received:
  • Custom KYC levels are configured for your app.
  • Multiple custom KYC levels are configured for your app as default levels.
  • Please reach out to support if you need additional assistance with your app configuration.
  • Please specify a kyc level in your request.
  • 400
  • 500

INVALID_STATE

The end user or business cannot be verified due to the an invalid state abbreviation in the street address.

Please update the state abbreviation on the end user's profile and request KYC again.

400

INVALID_POSTAL_CODE

The end user or business cannot be verified due to an invalid postal code in the street address.

Please update the postal code on the end user or business profile and request KYC again.

400

MISSING_BIRTHDATE

The end user or business cannot be verified due not having a date of birth registered.

Please update the date of birth on the end user or business profile and request KYC again.

400

MISSING_ADDRESS

The end user or business cannot be verified due not having a street address registered.

Please update the street address on the end user or business profile and request KYC again.

400

MISSING_ADDRESS_FIELD

The end user or business cannot be verified due missing a required field related to the street address.

Please ensure all required fields are filled in on the end user or business profile and request KYC again.

400

MISSING_SSN

The end user or business cannot be verified due not having a social security number registered.

Please update the social security number on the end user or business profile and request KYC again.

400

MISSING_FIRST_NAME

The end user or business cannot be verified due not having a first name registered.

Please update the first name on the end user or business profile and request KYC again.

400

MISSING_SURNAME

The end user or business cannot be verified due not having a surname or last name registered as required by the KYC level.

Please update the surname or last name on the end user or business profile and request KYC again.

400

MISSING_EMAIL

The end user or business cannot be verified due not having a email address registered.

Please update the email address on the end user or business profile and request KYC again.

400

MISSING_PHONE

The end user or business cannot be verified due not having a phone number registered.

Please update the phone number on the end user or business profile and request KYC again.

400

MISSING_BUSINESS_NAME

The end user is a business and cannot be verified due not having a business name (entity name) registered.

Please update the business (entity) name on the business profile and request KYC again.

400

MISSING_EIN

The business cannot be verified due not having a employer identification number registered.

Please update the employer identification number on the business profile and request KYC again.

400

MISSING_CONTROLLING_OFFICER_MEMBER

The business cannot be verified due to not having a controlling officer linked as a business member.

Please link a controlling officer as a business member to the business profile and request KYC again.

400

KYC_LEVEL_DNE

The KYC level used is not a valid KYC level for this business entity.

Please request /check_kyc for valid kyc levels and try again.

403

Key not present in response.

There is a misconfigured requirement in KYC LEVEL secret.

500

Request KYC - INSTANT-ACH

Errors pertaining to request_kyc for all Instant-ACH KYC levels

Error Code

Description

Troubleshooting

Error Status Code

MISSING_SSN

User cannot be ID-verified; no social security number registered.

Please update user's profile to include the SSN and run request_kyc again.

400

IDENTITY_HAS_RETURNS

Entity identity has returns for previous entity.

This user has returns in their transaction history and does not qualify for Instant ACH.

403

MISSING_DEVICE_IDENTIFIER

The end user or business cannot be verified due not having a session identifier registered.

Check your Iovation integration and ensure that you have included the device fingerprint.

400

MISSING_DEVICE_FINGERPRINT

The end user or business cannot be verified due not having a device fingerprint registered.

Check your Iovation integration and ensure that you have included the device fingerprint.

400


What’s Next

Return to Error Handling cover page.

Did this page help you?