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.

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_5009 The registration number was provided as tax ID 1_500
1_5010 The company details couldn't be verified 1_500
1_5011 The trade name (doing business as) was entered 1_500
1_5012 The submitted company type didn't match the one on the registry 1_500, 1_501
1_5013 The company was not found in the database 1_500
1_5014 The registration number couldn't be verified 1_500
1_5015 The registration number didn't match the legal business name 1_500
1_5017 The tax ID number didn't match the legal business name 1_500
1_5018 The business address couldn't be verified 1_500
1_5019 The trade name (doing business as) was entered 1_500
1_5020 Registration document is missing 1_501
1_5021 The registration document was too low quality. 1_502
1_5022 The registration document was too old 1_502
1_5023 The submitted company type didn't match the one on the registration document 1_500, 1_502
1_5024 The registration document did not show the company type 1_502, 1_500
1_5025 The address on the company registration document was a residential address 1_500
1_5026 The address on the company registration document was a PO box 1_502, 1_500
1_5027 The business address didn't match the one on the company registration document 1_502, 1_500
1_5028 The registration number didn't match the one on the company registration document 1_502, 1_500
1_5029 The legal business name didn't match the one on the company registration document 1_502, 1_500
1_5030 The country didn't match the one on the company registration document 1_502, 1_500
1_5031 The company registration document didn't show a legal business name 1_502
1_5032 The company registration document didn't show a registration number 1_502
1_5033 The state didn't match the one on the company registration document 1_505, 1_500
1_5034 The company registration document wasn't a supported document type 1_506
1_5035 The company registration document is not supported. 1_502, 1_500
1_5036 Tax document is missing 1_503
1_5037 The country didn't match the one on the tax document. 1_504, 1_500
1_5038 The tax document wasn't a supported document type. 1_504
1_5039 The tax document was too low quality 1_504
1_5040 The tax document was too old. 1_504
1_5041 The legal name didn't match the one on the tax document 1_504, 1_500
1_5042 The tax ID number didn't match the legal business name 1_500, 1_503
1_5043 The tax document didn't show a tax ID number 1_504
1_5044 The tax document didn't show a legal business name 1_504
1_5045 The state didn't match the one on the proof of address 1_506, 1_500
1_5046 Ownership data seems incorrect 1_508, 1_507
1_5047 Ownership data seems to be missing 1_508, 1_507
1_5048 Provide official ownership documentation 1_508
1_5049 The affiliation document was not sufficient to prove the 100% affiliation 1_511
1_5051 Signing person on the affiliation document could not be verified 1_510
1_5052 The affiliation document verifies the payout entity is not 100% affiliated with the company. Setup can't be continued 1_100
1_5054 The VAT number couldn't be verified 1_500, 1_513
1_5055 VAT document is missing 1_513
1_5056 The VAT document was too low quality 1_513
1_5057 The VAT document wasn't a supported document type 1_513
1_5058 The VAT document was too old 1_513
1_5059 The VAT document didn't show a legal name 1_513
1_5060 The VAT document didn't show a VAT number 1_513
1_5061 The country didn't match the one on the VAT document 1_500, 1_513
1_5062 The legal name didn't match the one on the VAT document 1_500, 1_513
1_5063 The organization VAT details couldn't be verified 1_500, 1_513
1_5064 The VAT number didn't match the one on the registry 1_500, 1_513
1_5065 The registration number was provided as VAT number 1_500, 1_513
1_5066 The trade name (doing business as) was entered instead of the legal name 1_500, 1_513
1_5067 The legal name didn't match the one on the VAT registry 1_500, 1_512
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_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

Suberrors array example