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
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_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 |
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 |
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": [
{
...
}
]
}
]
}
]