Are you looking for test card numbers?

Would you like to contact support?

Marketpay 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_6xx: Remediation for sole proprietorship issues
  • 1_7xx: Remediation for bank account check issues
  • 1_9xx: Remediation for business line check issues
  • 2_xxx: Remediation for dataMissing error type

General remediation codes

Remediating action code Message
1_100 No remediation possible
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
1_310 Update the name (Katakana) with only full-width Katakana characters and remove any invalid characters such as spaces, restricted or special characters
1_311 Update the name (Kanji) with only full-width Katakana, Kanji or Latin characters, and remove any invalid characters such as spaces, restricted or special characters
1_312 Update the residency street in full-width Kanji and remove any invalid characters such as spaces, restricted or special characters
1_313 Upload a different image of the proof of the individual tax ID
1_314 Upload a proof of the individual tax ID
1_315 Upload a different proof of the individual tax ID
1_316 Update the national Id number to a 9 digit SSN

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 ID document
1_504 Upload a different tax ID 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
1_514 Update the organization name (Katakana) with only full-width Katakana characters and remove any invalid characters such as spaces, restricted or special characters
1_515 Update the organization name (Kanji) with only full-width Katakana, Kanji or Latin characters, and remove any invalid characters such as spaces, restricted or special characters
1_516 Update the registered street in full-width Kanji and remove any invalid characters such as spaces, restricted or special characters

Sole proprietorship checks

Remediating action code Message
1_600 Update legal entity details
1_601 Upload a constitutional document
1_602 Upload a different constitutional 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

Business lines checks

Remediating action code Message
1_900 Upload a proof of industry
1_901 Update industry
1_902 Update the web address with a website or application that represents your business
1_903 Upload a different proof of industry
1_904 Upload a different image of the proof of industry

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"
        }
      ]
    }
  ]
  ...
}