You can use the general error codes to broadly identify the cause of an error. Adyen sends the general error codes and messages in the verificationErrors array. This array also usually contains corresponding suberrors.
The range of error codes are divided into the types of check.
- 1_1x: General issues
- 1_3x: Issues with the individual check
- 1_5x: Issues with the organization check
- 1_7x: Issues with the bank account check
- 2_8x: Issues with missing data
General issues
| General error code |
Message | Possible suberrors |
|---|---|---|
| 1_10 | Information couldn't be verified | 1_1002 |
| 1_11 | Document didn't meet requirements | 1_1003 |
| 1_12 | Legal entity declined | 1_1000 |
Individual identity check
| General error code |
Message | Possible suberrors |
|---|---|---|
| 1_30 | Individual details couldn't be verified | 1_3000, 1_3001, 1_3002, 1_3003, 1_3004, 1_3005, 1_3006, 1_3007, 1_3057, 1_3058 |
| 1_31 | ID document is needed | 1_3052 |
| 1_32 | ID document couldn't be processed | 1_3012 |
| 1_33 | ID document didn't meet requirements | 1_3009, 1_3013, 1_3015, 1_3019, 1_3020, 1_3024, 1_3026, 1_3027, 1_3029, 1_3030, 1_3031 |
| 1_34 | Image of the ID document didn't meet requirements | 1_3008, 1_3010, 1_3011, 1_3014, 1_3036, 1_3016, 1_3017, 1_3018, 1_3021, 1_3022, 1_3023 |
| 1_35 | Individual details didn't match the ID document | 1_3032, 1_3033, 1_3034, 1_3035, 1_3025, 1_3028 |
| 1_36 | Proof of residency didn't meet requirements | 1_3040, 1_3041, 1_3042, 1_3043, 1_3044 |
| 1_37 | Image of the proof of residency didn't meet the requirements | 1_3045 |
| 1_38 | Individual details didn't match the proof of residency | 1_3037, 1_3038, 1_3039, 1_3046 |
| 1_39 | Proof of national ID number didn't meet requirements | 1_3047 |
| 1_40 | Image of the proof of national ID number didn't meet the requirements | 1_3051 |
| 1_41 | Individual details didn't match the proof of national ID number | 1_3048, 1_3049, 1_3050 |
| 1_43 | Image of the proof of the individual tax ID didn't meet the requirements | 1_3056 |
| 1_44 | Proof of the individual tax ID didn't meet requirements | 1_3059 |
| 1_45 | Individual details didn't match the proof of the individual tax ID | 1_3060, 1_3061 |
Organization check
| General error code |
Message | Possible suberrors |
|---|---|---|
| 1_50 | Organization details couldn't be verified | 1_5000, 1_5001, 1_5002, 1_5003, 1_5004, 1_5005, 1_5006, 1_5007, 1_5008, 1_5009, 1_5010, 1_5011, 1_5012, 1_5013, 1_5014, 1_5015, 1_5016, 1_5017, 1_5018, 1_5019, 1_5020, 1_5025, 1_5026, 1_5033, 1_5036, 1_5042, 1_5054, 1_5055 |
| 1_51 | Organization details didn't match the document | 1_5023, 1_5027, 1_5028, 1_5029, 1_5030, 1_5031, 1_5032, 1_5037, 1_5041, 1_5043, 1_5044, 1_5045, 1_5061, 1_5062, 1_5063, 1_5064, 1_5065, 1_5066, 1_5067 |
| 1_52 | Registration document didn't meet requirements | 1_5021, 1_5022, 1_5024, 1_5035 |
| 1_53 | Tax document didn't meet requirements | 1_5038, 1_5039, 1_5040 |
| 1_54 | Proof of address didn't meet requirements | 1_5034 |
| 1_55 | Proof of ownership is needed | 1_5048 |
| 1_56 | Organization ownership couldn't be verified | 1_5046, 1_5047 |
| 1_57 | Submitted affiliation document didn't meet the requirements | 1_5049, 1_5050, 1_5051, 1_5052, 1_5053 |
| 1_58 | VAT document didn't meet requirements | 1_5056, 1_5057, 1_5058, 1_5059, 1_5060 |
Bank account check
| General error code |
Message | Possible suberrors |
|---|---|---|
| 1_70 | Bank account couldn't be verified | 1_7000, 1_7003 |
| 1_71 | Bank account details couldn't be verified | 1_7001, 1_7002, 1_7004, 1_7015, 1_7017, 1_7020, 1_7007 |
| 1_72 | Verification could not be completed | 1_1001 |
| 1_73 | Bank account access could not be authenticated | 1_7005, 1_7006 |
| 1_74 | Bank statement is needed | 1_7008 |
| 1_75 | Bank statement didn't meet requirements | 1_7009, 1_7010, 1_7012, 1_7013, 1_7014, 1_7018, 1_7019, 1_7021, 1_7022 |
| 1_76 | Bank details didn't match the bank statement | 1_7011, 1_7016 |
Missing data
| General error code | Message | Remediating action code |
|---|---|---|
| 2_8009 | No first name available to perform verification | 2_102 |
| 2_8011 | No last name available to perform verification | 2_103 |
| 2_8017 | No country available to perform verification | 2_104 |
| 2_8018 | No stateOrProvince available to perform verification | 2_105 |
| 2_8019 | No street available to perform verification | 2_106 |
| 2_8020 | No city available to perform verification | 2_107 |
| 2_8021 | No postalCode available to perform verification | 2_108 |
| 2_8022 | No street2 available to perform verification | 2_109 |
| 2_8023 | No webAddress available to perform verification | 2_111 |
| 2_8025 | No nationality available to perform verification | 2_110 |
| 2_8028 | No dateOfBirth available to perform verification | 2_112 |
| 2_8030 | No IBAN available to perform verification | 2_113 |
| 2_8032 | No accountNumber available to perform verification | 2_114 |
| 2_8036 | No bankAccount available to perform verification | 2_115 |
| 2_8037 | No bankStatement available to perform verification | 1_701 |
| 2_8038 | No branch code available to perform verification | 2_116 |
| 2_8041 | No MCC available to perform verification | 1_100 |
| 2_8043 | No registration number available to perform verification | 2_117 |
| 2_8045 | No tax ID available to perform verification | 2_118 |
| 2_8052 | No document attachment available to perform verification | 2_119 |
| 2_8058 | No name available to perform verification | 2_120 |
| 2_8059 | No birth data available to perform verification | 2_121 |
| 2_8060 | No identification data available to perform verification | 2_101 |
| 2_8062 | No address available to perform verification | 2_122 |
| 2_8064 | No shareholder available to perform verification | 2_123 |
| 2_8067 | No signatory available to perform verification | 2_124 |
| 2_8068 | No business registration available to perform verification | 2_117 |
| 2_8069 | No company type available to perform verification | 2_125 |
| 2_8070 | No document available to perform verification | 2_126 |
| 2_8071 | No identity document available to perform verification | 1_301 |
| 2_8072 | No business document available to perform verification | 1_501 |
| 2_8073 | No company document available to perform verification | 2_126 |
| 2_8076 | No drivers license available to perform verification | 2_127 |
| 2_8077 | No front image of drivers license available to perform verification | 2_128 |
| 2_8078 | No back image of drivers license available to perform verification | 2_129 |
| 2_8079 | No ID card available to perform verification | 1_301 |
| 2_8080 | No back image of ID card available to perform verification | 2_131 |
| 2_8081 | No front image of ID card available to perform verification | 2_130 |
| 2_8082 | No ID number available to perform verification | 2_101 |
| 2_8085 | No legal business name available to perform verification | 2_132 |
| 2_8086 | No trading name available to perform verification | 2_133 |
| 2_8100 | No VAT document available to perform verification | 2_134 |
| 2_8107 | No proof of residency available to perform verification | 1_304 |
| 2_8108 | No continuous payout entity available to perform verification | 1_100 |
| 2_8109 | No full affiliation proof available to perform verification | 1_100 |
| 2_8110 | No constitutional document available to perform verification | 1_100 |
| 2_8112 | No sort code available to perform verification | 2_135 |
| 2_8128 | No legal arrangement registration available to perform verification | 1_100 |
| 2_8129 | No legal arrangement name available to perform verification | 1_100 |
| 2_8130 | No legal arrangement type available to perform verification | 1_100 |
| 2_8131 | No legal arrangement subtype available to perform verification | 1_100 |
| 2_8132 | No business line available to perform verification | 2_136 |
| 2_8138 | No ID document report available to perform verification | 1_100 |
| 2_8139 | No proof of national ID number available to perform verification | 1_307 |
| 2_8140 | No business proof of address available to perform verification | 1_505 |
| 2_8141 | No proof of registration number available to perform verification | 2_137 |
| 2_8142 | No company registration screening available to perform verification | 1_100 |
| 2_8143 | No KVK available to perform verification | 1_100 |
| 2_8147 | No proof of registered status available to perform verification | 1_100 |
General verification errors array example
...
"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": [
{
...
}
]
}
]
}
]