In addition to the below table, please refer to Visa Developer Error Codes to learn more about common VDP errors and how to resolve them.
| HTTP Status | Error Code | Message | Description | Recommended Handling |
|---|---|---|---|---|
| 400 | Invalid value, must be an ISO 3166 three-letter country code | The value for country doesn't follow the ISO-3166 standard | Input a value for country using standard ISO-3166 | |
| 400 | Invalid value, must be an ISO 4217 three-letter currency code | The value for currency doesn't follow the ISO-4217 standard | Input a value for currency using standard ISO-4217 | |
| 400 | X must not be blank because the fields Y,Z are present | A specific field can't be blank because other related fields have values | Input a value for X | |
| 400 | X must not be empty | A specific field can't be blank | Input a value for X | |
| 400 | X must not be null | Indicates that a field must be filled or null. | Input a value for X | |
| 400 | There are duplicate elements: X,Y | Remove one of the duplicate values. | Remove one of the duplicate value and re-submit. | |
| 400 | X: size must be between Y and Z | The inputed value is not within the range of the allowed values | Input a value for X between Y and Z | |
| 500 | Internal Server Error | The server encountered an unexpected condition that prevented it from fulfilling the request | Contact your Visa production support contact for investigation and assistance. | |
| 400 | JSON parse error: Cannot deserialize request | N/A | Please refer to API specifications and input a valid JSON request. | |
| 400 | X, invalid value format for this field | A field has an incorrect format | Please refer to API specifications for the proper format and re-submit. | |
| 400 | line: X, column: Y , invalid JSON format | JSON format is incorrect at the indicated position | Fix the JSON format at the indicated position | |
| 400 | X is not a valid value. Valid values are: Y,Z | The inputed value is not one of the allowed values | Use one of the allowed values for this field. | |
| 422 | LDS-30000 | Alias already exists | Alias already exists | Use another Alias value |
| 404 | LDS-30002 | Alias not found | Alias not found | Verify the Alias Id used in the request |
| 422 | LDS-30004 | alias.externalId already exists | External ID for the Alias already exists | Use another External ID |
| 422 | LDS-30005 | paymentCredential.externalId[{0}] already exists | External ID for the payment credential already exists | Use another External ID |
| 422 | LDS-30006 | paymentCredential.externalId[{0}] is duplicated in the request | The same External ID for payment credentials occurs more than once in the request | Use another External ID |
| 422 | LDS-30008 | paymentCredential.externalId already exists | External ID for the payment credential already exists | Use another External ID |
| 422 | LDS-30009 | Type not allowed | The value for "type" is not valid. Valid values are ALIAS, PAYMENT_CREDENTIAL. | Use a correct value for the "type" object in the request. (ALIAS, PAYMENT_CREDENTIAL) |
| 422 | LDS-30010 | Id not found | The Id provided in the request was not found | Verify the Id and type used in the "getByExternalId" request. The combination must match to return results. |
| 422 | LDS-30011 | The ID of the payment credential provided was not found | The ID of the payment credential provided was not found | Use the Get Payment Credentials API to get a list of all payment credentials associated with the Alias. |
| 422 | LDS-30012 | Destination type does not match the source type of the payment credential | Indicates that the payment credential to update has a different "type" than the requested type. | Use the Get Payment Credential API to get the information on the payment credential and use the correct "type" value. |
| 422 | CVC-30000 | Error while decrypting PAN | Indicates that was not possible decrypt the PAN | Data inconsistence. Contact your Visa production support contact for investigation and assistance. |
| 422 | CVC-30001 | Error while decrypting Expiration Date | Indicates that was not possible decrypt the Expiration Date | Data inconsistence. Contact your Visa production support contact for investigation and assistance. |
| 422 | CVC-30002 | Wrong PAN format | PAN has an incorrect format | Use a proper format for PAN |
| 422 | CVC-30003 | Expiration Date is invalid. Must be in YYYY-MM format. | Expiration Date is invalid. Must be in YYYY-MM format. | Use proper format for expiration date. |
| 422 | CVC-30004 | Card does not exist | The specific card was not found. | Contact your Visa production support contact for investigation and assistance. |
| 422 | CVC-30005 | Error while encrypting PAN | Not possible to encrypt the PAN | Contact your Visa production support contact for investigation and assistance. |
| 422 | CVC-30006 | Error while encrypting Expiration Date | Not possible to encrypt the Expiration Date | Contact your Visa production support contact for investigation and assistance. |
| 422 | CVC-30007 | Expired card | Expiration date is before than current date | Use an expiration date in the future |
| 422 | DCC-30002 | No directories responded within the response timeout period | No directories responded within the response timeout period | Try again. If the error still exists, please contact your Visa production support contact for investigation and assistance. |
| 422 | DCC-30003 | Alias not found | Alias not found | N/A |
| 422 | DCC-30004 | Multiple results found, but unable to resolve Alias. | Multiple results were found, but the resolution rules could not narrow the multiple results into a single result. | N/A |
| 422 | DCC-30006 | No directory was found using the configured polling rules. | No directory was found using the configured polling rules. | Client onboarding inconsistence. Contact your Visa production support contact for investigation and assistance. |
| 422 | DCC-30008 | Selected directory doesn't exist | Not possible to find the specified directory. | The Directory Name used in the request doesn't exist. Contact your Visa production support contact to validate the available remote directories. |
| 422 | DCC-30009 | Selected directory is not available for Alias resolution. | indicates that the directory is disabled and not available for Alias resolution. | The Directory Name used in the request is not available for the program. Contact your Visa production support contact to validate the available remote directories. |
Start a Project
API Overview
API Reference