Request KYC Errors

🚧

Under Construction

These documents are a still a work in progress. The missing endpoint and fields will be completed as soon as possible and updates to the information will be made as needed.

Request KYC - DOC_KYC, KYB

Errors pertaining to request_kyc endpoint for DOC_KYC, 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 CodeDescriptionTroubleshootingError Status Code
DOCUMENT_UPLOAD_REQUIREDDocument 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_STATEThe 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_CODEThe 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_BIRTHDATEThe 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_ADDRESSThe 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_FIELDThe 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_SSNThe 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_NAMEThe 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_SURNAMEThe 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_EMAILThe 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_PHONEThe 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_NAMEThe 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_EINThe 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_MEMBERThe 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_DNEThe 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 CodeDescriptionTroubleshootingError Status Code
MISSING_SSNUser 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_RETURNSEntity identity has returns for previous entity.This user has returns in their transaction history and does not qualify for Instant ACH.403
MISSING_DEVICE_IDENTIFIERThe 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_FINGERPRINTThe 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.