Are you looking for test card numbers?

Would you like to contact support?

Issuin icon

Remediating action codes

Remediating actions provide instructions to resolve an error. There can be multiple remediating actions to resolve an error. Whenever possible, Adyen sends remediation codes and messages within the following:

  • verificationErrors array. The remediating actions are only sent in this array when there are common actions for the subErrors.
  • subErrors array.

The range of remediation codes are divided into the types of issues.

  • 1_1xx: Remediation for general issues
  • 1_3xx: Remediation for individual check issues
  • 1_5xx: Remediation for organization check issues
  • 1_7xx: Remediation for bank account check issues
  • 2_xxx: Remediation for dataMissing error type

General remediation codes

Remediating action code Message
1_100
1_101 Contact Support
1_102 Upload a different document

Individual checks

Remediating action code Message
1_300 Update individual details
1_301 Upload an ID document
1_302 Upload a different ID document
1_303 Upload a different image of the ID document
1_304 Upload proof of residency
1_305 Upload a different proof of residency
1_306 Upload a different image of the proof of residency
1_307 Upload a proof of national ID number
1_308 Upload a different proof of national ID number
1_309 Upload a different image of the proof of national ID number

Organization checks

Remediating action code Message
1_500 Update organization details
1_501 Upload a registration document
1_502 Upload a different registration document
1_503 Upload a tax document
1_504 Upload a different tax document
1_505 Upload a proof of address
1_506 Upload a different proof of address
1_507 Update organization ownership details
1_508 Upload a proof of ownership
1_509 Upload a different affiliation document
1_510 Ensure signing person has the rights to represent the organization or is a listed professional member (lawyer, accountant) in your country of business and upload the right document
1_511 Upload a document that proves the payout entity is 100% affiliated with the legal entity
1_512 Upload a VAT document
1_513 Upload a different VAT document

Bank account checks

Remediating action code Message
1_700 Update bank account details
1_701 Use different bank account
1_702 Use other means of bank account verification
1_703 Upload a bank statement
1_704 Upload a different bank statement
1_705 Upload an official bank statement

Missing data

The following remediation codes may be returned when the error type is dataMissing.

Remediating action code Message
2_101 Add individual.identificationData to legal entity.
2_102 Add individual.name.firstName to legal entity.
2_103 Add individual.name.lastName to legal entity.
2_104 Add individual.residentialAddress.country to legal entity.
2_105 Add individual.residentialAddress.stateOrProvince to legal entity.
2_106 Add individual.residentialAddress.street to legal entity.
2_107 Add individual.residentialAddress.city to legal entity.
2_108 Add individual.residentialAddress.postalcode to legal entity.
2_109 Add individual.residentialAddress.street2 to legal entity.
2_110 Add individual.nationality to legal entity.
2_111 Add individual.webData.webAddress to legal entity.
2_112 Add individual.birthData.dateOfBirth to legal entity.
2_113 Add bankAccount.iban to bank account.
2_114 Add bankAccount.accountNumber to bank account.
2_115 Add bank account.
2_116 Add bankAccount.branchCode to bank account.
2_117 Add organization.registrationNumber to legal entity.
2_118 Add organization.taxId to legal entity.
2_119 Add attachments to document.
2_120 Add individual.name to legal entity.
2_121 Add individual.birthData to legal entity.
2_122 Add individual.residentialAddress to legal entity.
2_123 Add organization.entityAssociations of type uboThroughOwnership to legal entity.
2_124 Add organization.entityAssociations of type signatory to legal entity.
2_125 Add organization.type to legal entity.
2_126 Upload a document.
2_127 Upload a drivers license.
2_128 Upload the front of a drivers license.
2_129 Upload the back of a drivers license.
2_130 Upload the front of a drivers license.
2_131 Upload the back of a drivers license.
2_132 Add organization.legalName to legal entity.
2_133 Add organization.doingBusinessAs to legal entity.
2_134 Upload a VAT document.
2_135 Add bankAccount.sortCode to bank account.
2_136 Add business line.
2_137 Upload a proof of registration.

Remediating actions array example

Example remediating actions array
{
   ...
    "problems": [
        {
            ...
            "verificationErrors": [
                {
                    "code": "1_30",
                    "message": "Individual details couldn't be verified",
                    "{hint:Sent when there is a common remediating action}remediatingActions{/hint}": [
                        {
                            "code": "1_300",
                            "message": "Update individual details"
                        }
                    ],
                    "subErrors": [
                        {
                            "code": "1_3001",
                            "message": "The name and date of birth couldn't be verified.",
                            "remediatingActions": [
                                {
                                    "code": "1_301",
                                    "message": "Upload an ID document"
                                },
                                {
                                    "code": "1_300",
                                    "message": "Update individual details"
                                }
                            ],
                            "type": "invalidInput"
                        },
                        {
                            "code": "1_3000",
                            "message": "The user couldn't be verified.",
                            "remediatingActions": [
                                {
                                    "code": "1_300",
                                    "message": "Update individual details"
                                },
                                {
                                    "code": "1_301",
                                    "message": "Upload an ID document"
                                }
                            ],
                            "type": "invalidInput"
                        }
                    ],
                    "type": "invalidInput"
                }
            ]
        }
    ],
    ...
}