Skip to main content

Documentation

Identity Verification Errors

Error Code

Description

ERROR_ID_VERIFICATION

The request tried to validate identity, but the operation failed. The request was rejected. Corrective action: Check all parameters and provide a unique reference ID for each identity verification operation, whether successful or unsuccessful.

ERROR_ID_VERIFICATION_ALREADY_COMPLETE

The request tried to verify the identity of a wallet contact, but the identity was already verified and cannot be verified twice. The request was rejected. Corrective action: None. Determine why multiple attempts were made to verify the same identity.

ERROR_ID_VERIFICATION_ALREADY_IN_PROGRESS

The request tried to verify the identity of a wallet contact, but the verification process is still pending. The request was rejected. Corrective action: Wait for the process to complete.

ERROR_ID_VERIFICATION_AUTHENTICITY_FAILED

The request tried to validate identity, but the operation failed due to the authenticity of the document. The request was rejected. Corrective action: Upload a scan of a legal and valid ID document that passes the authenticity tests. If issue persists, contact support.

ERROR_ID_VERIFICATION_BACK_SIDE_IMAGE_ENCODING_INVALID

The request tried to validate identity, but the back side image provided was not properly encoded into Base64. The request was rejected. Corrective action: Convert the image into Base64 encoding, using all options that are required, as verified by your testing.

ERROR_ID_VERIFICATION_BACK_SIDE_IMAGE_MIME_TYPE_INVALID

The request tried to validate identity, but the back side image provided was not the correct MIME type. The request was rejected. Corrective action: Use a JPEG or PNG image.

ERROR_ID_VERIFICATION_BACK_SIDE_IMAGE_MISSING

The request tried to validate identity, but the required back side image was not found. The request was rejected. Corrective action: Submit the back side image with JPEG or PNG format, Base-64 encoded.

ERROR_ID_VERIFICATION_BARCODE_NOT_DECODED

The request tried to validate identity, but the barcode on the image was not decoded. The request was rejected. Corrective action: Upload an image with a clear, readable, and decodable barcode.

ERROR_ID_VERIFICATION_BARCODE_NOT_READABLE

The request tried to validate identity, but the barcode on the image was not readable. The request was rejected. Corrective action: Upload an image with a clear and readable barcode.

ERROR_ID_VERIFICATION_COUNTRY_MISMATCH

The request tried to validate identity, but the operation failed due to a country mismatch. The request was rejected. Corrective action: Upload a document that matches the declared country.

ERROR_ID_VERIFICATION_DOCUMENT_BLOCKED

The request tried to validate identity, but the document is in a blocked list. The request was rejected. Corrective action: Upload another document.

ERROR_ID_VERIFICATION_DOCUMENT_FLAGGED

The request tried to validate identity, but the document is in a flagged list. The request was rejected. Corrective action: Upload another document.

ERROR_ID_VERIFICATION_DUPLICATE_REFERENCE_ID

The request tried to validate identity, but the 'reference_id' body parameter was previously used. The request was rejected. Corrective action: Provide a unique reference ID for each identity verification operation, whether successful or unsuccessful.

ERROR_ID_VERIFICATION_EXPIRED

The request tried to validate the identity, but the operation failed since the document expired. The request was rejected. Corrective action: Upload a valid ID document.

ERROR_ID_VERIFICATION_GRAYSCALE_IMAGE

The request tried to validate identity, but the image is in grayscale format. The request was rejected. Corrective action: Use clear, readable images that are in color.

ERROR_ID_VERIFICATION_INCOMPLETE_DOCUMENT_UPLOAD

The request tried to validate identity, but the document is incomplete. The request was rejected. Corrective action: Upload a complete document.

ERROR_ID_VERIFICATION_INTERNAL_PROCESSING_ERROR

The document was not processed due to an internal error. Corrective action: Use a clear, readable document and upload it again.

ERROR_ID_VERIFICATION_INVALID_IMAGE_MIME_TYPE_OR_SIZE

The request tried to parse a document, but the image provided was not the correct MIME type or the correct size. The request was rejected. Corrective action: Use a JPEG or PNG image that is not larger than the maximum size.

ERROR_ID_VERIFICATION_IMAGE_NOT_RECOGNIZED

The request tried to validate identity, but the image was not recognized. The request was rejected. Corrective action: Use clear, readable images.

ERROR_ID_VERIFICATION_IMAGE_NOT_VALID

The request tried to validate identity, but an image was not valid. The request was rejected. Corrective action: Use clear, readable images.

ERROR_ID_VERIFICATION_INVALID_BACK_SIDE_IMAGE_ENCODING

The request tried to validate identity, but the back side image provided was not properly encoded into Base64. The request was rejected. Corrective action: Convert the image into Base64 encoding, using all options that are required, as verified by your testing.

ERROR_ID_VERIFICATION_BACK_SIDE_IMAGE_IS_REQUIRED

The request tried to validate identity, but the back side image was not provided. The request was rejected. Corrective action: Upload a back side image of the ID that matches the front side image.

ERROR_ID_VERIFICATION_BACK_SIDE_IMAGE_NOT_SUPPORTED

The request tried to validate identity, but the back side image is not supported for this ID. The request was rejected. Corrective action: Upload a back side image of the ID that supports the front side image.

ERROR_ID_VERIFICATION_INVALID_BACK_SIDE_IMAGE_MIME_TYPE

The request tried to parse a document, but the back side image provided was not the correct MIME type. The request was rejected. Corrective action: Use a JPEG or PNG image.

ERROR_ID_VERIFICATION_INVALID_DOCUMENT_TYPE

The request tried to validate identity, but the document provided was not a supported type. The request was rejected. Corrective action: Run 'List Official Identification Documents' to find the documents supported in the country.

ERROR_ID_VERIFICATION_INVALID_EWALLET

The request tried to validate identity, but the associated wallet was not found. Corrective action: In the 'ewallet' field, provide the wallet ID, a string starting with 'ewallet'.

ERROR_ID_VERIFICATION_INVALID_FACE_IMAGE_ENCODING

The request tried to validate identity, but the face image provided was not properly encoded into Base64. The request was rejected. Corrective action: Convert the image into Base64 encoding, using all options that are required, as verified by your testing.

ERROR_ID_VERIFICATION_INVALID_FACE_IMAGE_MIME_TYPE

The request tried to validate identity, but the face image provided was not the correct MIME type. The request was rejected. Corrective action: Use a JPEG or PNG image.

ERROR_ID_VERIFICATION_INVALID_FRONT_SIDE_IMAGE_ENCODING

The request tried to verify identity, but the front side image provided was not properly encoded into Base64. The request was rejected. Corrective action: Convert the image into Base64 encoding using all options that are required, as verified by your testing.

ERROR_ID_VERIFICATION_INVALID_FRONT_SIDE_IMAGE_MIME_TYPE

The request tried to verify identity, but the front side image provided was not the correct MIME type. The request was rejected. Corrective action: Use a JPEG or PNG image.

ERROR_ID_VERIFICATION_INVALID_IDENTIFICATION_TYPE

The request tried to validate identity, but the document type was missing or not recognized. The request was rejected. Corrective action: Provide the required document type. To determine valid types, run 'List Official Identification Documents'.

ERROR_ID_VERIFICATION_INVALID_REFERENCE_ID

The request tried to verify identity, but the reference ID contains more than 36 characters. The request was rejected. Corrective action: Use a reference ID with 36 characters or less.

ERROR_ID_VERIFICATION_LOW_QUALITY_IMAGE

The request tried to validate identity, but the image scan was of low quality. The request was rejected. Corrective action: Use clear, readable images.

ERROR_ID_VERIFICATION_MISSING_BACK_SIDE_IMAGE

The request tried to parse a document, but the required back side image was not found. The request was rejected. Corrective action: Submit the back side image with JPEG or PNG format, Base-64 encoded.

ERROR_ID_VERIFICATION_MISSING_COUNTRY

The request tried to validate identity, but the 'country' body parameter was empty or missing. Corrective action: Provide the 2-letter ISO code for the country in uppercase letters.

ERROR_ID_VERIFICATION_MISSING_DOCUMENT_TYPE

The request tried to validate identity, but the 'document_type' body parameter was empty or missing. Corrective action: Use 'List Official Identification Documents' to find the document types that are supported in the country.

ERROR_ID_VERIFICATION_MISSING_EWALLET

The request tried to validate identity, but the 'ewallet' body parameter was empty or missing. Corrective action: Provide the wallet ID, a string starting with 'ewallet_'.

ERROR_ID_VERIFICATION_MISSING_EWALLET_ID

The request tried to validate identity, but the 'ewallet' body parameter was empty or missing. Corrective action: Provide the wallet ID, a string starting with 'ewallet_'.

ERROR_ID_VERIFICATION_MISSING_FACE_IMAGE

The request tried to validate identity, but the face image was missing. The request was rejected. Corrective action: Provide the face image.

ERROR_ID_VERIFICATION_MISSING_FRONT_SIDE_IMAGE

The request tried to parse a document, but the required front side image was not found. The request was rejected. Corrective action: Submit the front side image with JPEG or PNG format, Base-64 encoded.

ERROR_ID_VERIFICATION_MISSING_REFERENCE_ID

The request tried to validate identity, but the 'reference_id' body parameter was empty or missing. Corrective action: Provide the merchant's reference ID for the identity verification operation.

ERROR_ID_VERIFICATION_MULTIPLE_IMAGE_UPLOAD

The request tried to validate identity, but the document has multiple images. The request was rejected. Corrective action: Upload a document with one image.

ERROR_ID_VERIFICATION_MULTIPLE_PAGE_DOCUMENT

The request tried to validate identity, but document provided has multiple pages. The request was rejected. Corrective action: Upload a single page document.

ERROR_ID_VERIFICATION_MULTIPLE_PAGE_MISMATCH

The request tried to validate identity, but the multiple page document has a mismatch. The request was rejected. Corrective action: Provide the document with no mismatch.

ERROR_MAX_NUMBER_OF_IDENTITY_VERIFICATIONS

The request tried to validate identity, but the maximum number of requests for this individual has been reached. The request was rejected. Corrective action: None. Contact Client Support.

INVALID_DATE_OF_BIRTH

The request tried to add or update a date of birth, but it was not in the correct format or was a date in the future. The request was rejected. Corrective action: Provide a valid birthdate in mm/dd/yyyy format.

INVALID_IDENTIFICATION_NUMBER

The request tried to validate identity, but the ID number was missing or not recognized. The request was rejected. Corrective action: Provide the ID number and verify that it contains only alphanumeric characters and spaces.

INVALID_IDENTIFICATION_TYPE

The request tried to validate identity, but the document type was missing or not recognized. The request was rejected. Corrective action: Provide the required document type. To determine valid types, use 'List Official Identification Documents'.

INVALID_IMAGE_URL

The request attempted an operation that processed a URL for an image, but the operation failed. Corrective action: Provide a valid HTTP or HTTPS URL with a JPG or PNG file extension.