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. |