Are you looking for test card numbers?

Would you like to contact support?

No momento, esta página não está disponível em português
Marketpay icon

Suberror codes

Suberrors are more granular error codes that you can use to provide the specific cause of a verification error. Adyen sends the general error codes and messages in the subErrors array. When applicable, an entry contains remediating actions that you can use to resolve the KYC error.

The range of error codes are divided into the types of check.

  • 1_1xxx: General issues
  • 1_3xxx: Issues with the individual check
  • 1_5xxx: Issues with the organization check

General issues

Suberror code Message Remediating action codes
1_1000 Verification failed. Legal entity declined 1_101
1_1001 There were some technical issues in the verification process 1_101
1_1002 There are more questions about the submitted information 1_101

Individual identity check

Suberror code Message Remediating action codes
1_3000 The user couldn't be verified 1_300
1_3001 The name and date of birth couldn't be verified 1_300
1_3004 The name and residence country couldn't be verified 1_300
1_3053 The name (Katakana) couldn't be verified due to invalid characters 1_310
1_3054 The name (Kanji) couldn't be verified due to invalid characters 1_311
1_3055 The residency address couldn't be verified due to invalid characters. 1_312

Organization check

Suberror code Message Remediating action codes
1_5000 The legal business name couldn't be verified 1_500
1_5001 The tax ID number couldn't be verified 1_500
1_5016 The tax ID number couldn't be verified 1_500
1_5017 The tax ID number didn't match the legal business name 1_500
1_5068 The legal name (Katakana) couldn't be verified due to invalid characters 1_514
1_5069 The legal name (Kanji) couldn't be verified due to invalid characters 1_515
1_5070 The registered address couldn't be verified due to invalid characters 1_516
1_5071 The registered city didn't match the one on the proof of address 1_500, 1_506
1_5072 The registered city didn't match the one on the registry 1_500, 1_506
1_5073 Proof of address is missing 1_505
1_5074 The proof of address didn't show a business legal name 1_506
1_5075 The proof of address didn't show the registered city 1_506
1_5076 The organization tax ID document didn't show a business legal name 1_504
1_5077 The organization tax ID number didn't match the legal business name 1_503, 1_500
1_5078 The legal name couldn't be verified 1_501, 1_500
1_5079 The submitted organization tax ID number does not exist 1_503, 1_500

Suberrors array example

Example problems array 
{
  ...
  "problems": [
    {
      "entity": {
        "id": "LE00000000000000000000001",
        "type": "LegalEntity"
      },
      "verificationErrors": [
        {
          "code": "1_42",
          "message": "Individual details didn't meet the format requirements",
          "subErrors": [
            {
              "code": "1_3055",
              "message": "The residency address couldn't be verified due to invalid characters.",
              "remediatingActions": [
                {
                  "code": "1_312",
                  "message": "Update the residency street in full-width Kanji and remove any invalid characters such as spaces, restricted or special characters"
                }
              ],
              "subErrors": [],
              "type": "invalidInput"
            },
            {
              "code": "1_3054",
              "message": "The name (Kanji) couldn't be verified due to invalid characters",
              "remediatingActions": [
                {
                  "code": "1_311",
                  "message": "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"
                }
              ],
              "subErrors": [],
              "type": "invalidInput"
            }
          ],
          "type": "invalidInput"
        }
      ]
    }
  ],
  ...
}