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.

Requirements

If you have an Adyen for Platforms or Adyen Issuing integration, there are no additional requirements, limitations, or preparations.

Types of error codes

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 legal arrangement issues
1_7xx: Remediation for bank account check issues
1_8xx: Remediation for proof of signatory checks
1_9xx: Remediation for business line check issues
2_1xx - 2_2xx: Remediation for missing data issues
2_9xx: Remediation for contract issues
3_1xx: Remediating for data review issues

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
1_317	Upload a different live selfie
1_318	Upload a different photo ID document
1_319	Update individual details
1_320	Upload proof of residency
1_321	Update the residential address

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 `proofOfOrganizationTaxInfo`
1_504	Upload a different `proofOfOrganizationTaxInfo`
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_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
1_518	Update organization `legalName`
1_519	Update source of funds
1_520	Upload a proof of source of funds
1_521	Upload a different proof of source of funds
1_522	Add a director
1_523	Update organization details
1_524	Make sure the registered business address is correct, and that the principal place of business address is a physical, non-PO box address
1_525	Add the physical address of the principal place of business

Legal arrangement checks

The actual error message will correspond to the specific type of legal arrangement. For example, "Update sole proprietership details."

Remediating action code	Message
1_600	Update legal arrangement details
1_601	Upload a constitutional document
1_602	Upload a different constitutional document
1_603	Update legal arrangement's affiliated member's details

Bank account checks

Remediating action code	Message
1_700	Update bank account details
1_701	Use different bank account
1_703	Upload a bank statement
1_704	Upload a different bank document
1_705	Upload an official bank document

Proof of signatory checks

Remediating action code	Message
1_800	Upload a proof of signatory
1_801	Upload a different proof of signatory
1_802	Update signatory details
1_803	Upload a proof of director document to legal entity
1_804	Upload a different proof of director document
1_805	Update director details

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
1_905	Add `webData.webAddress` to business line

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_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 an identity card
2_131	Upload the back of an identity card
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
2_138	Add `individual.identificationData.number` to legal entity
2_139	Add `individual.identificationData.type` to legal entity
2_140	Add `bankAccount.accountType` to bank account
2_141	Add `bankAccount.bankBicSwift` to bank account
2_142	Add `bankAccount.bankCity` to bank account
2_143	Add `bankAccount.bankCode` to bank account
2_144	Add `bankAccount.bankName` to bank account
2_145	Add `bankAccount.checkCode` to bank account
2_146	Add `bankAccount.bankCountry` to bank account
2_147	Add `bankAccount.currencyCode` to bank account
2_148	Add `organization.stockData.marketIdentifier` to legal entity
2_149	Add `organization.stockData.stockNumber` to legal entity
2_150	Add `organization.stockData.tickerSymbol` to legal entity
2_151	Add `organization.entityAssociations` of type `uboThroughControl` to legal entity
2_152	Add `individual.email` to legal entity
2_153	Add `phone.number` to legal entity
2_154	Add `phone.type` to legal entity
2_155	Add `phone.countryCode` to legal entity
2_156	Add `entityAssociation.jobTitle` to legal entity
2_157	Upload a passport
2_158	Add `organization.vatNumber` to legal entity
2_159	Add source of funds to business line
2_160	Add `businessLine.sourceOfFunds.type` to business line
2_161	Add `businessLine.sourceOfFunds.dateOfFundsReceived` to business line
2_162	Add `businessLine.sourceOfFunds.dateOfSourceEvent` to business line
2_163	Add `businessLine.sourceOfFunds.purpose` to business line
2_164	Add `businessLine.sourceOfFunds.adyenProcessedFunds` to business line
2_165	Add `businessLine.sourceOfFunds.cryptocurrencyExchange` to business line
2_166	Add `businessLine.sourceOfFunds.description` to business line
2_167	Add `businessLine.sourceOfFunds.relationship` to business line
2_169	Add `businessLine.sourceOfFunds.amount` to business line
2_170	Add tax information to legal entity
2_171	Add `taxInformation.number` to legal entity
2_172	Add `taxInformation.type` to legal entity
2_173	Add `taxInformation.country` to legal entity
2_174	Add `proofOfIndividualTaxId` to legal entity
2_175	Add `vatDocument` to legal entity
2_176	Add `industryCode` to business line
2_177	Add `channel` to business line
2_178	Add `webAddress` to business line
2_179	Add `taxReportingClassification` to legal entity
2_180	Add `taxReportingClassification.type` to legal entity
2_181	Add `taxReportingClassification.businessType` to legal entity
2_182	Add `taxReportingClassification.mainSourceOfIncome` to legal entity
2_183	Add `taxReportingClassification.financialInstitutionNumber` to legal entity
2_184	Add constitutional document for verification to legal entity
2_185	Add `organization.entityAssociations` of type `director` to legal entity
2_186	Add `trust.entityAssociations` of type `settlor` to legal entity
2_187	Add `trust.entityAssociations` of type `definedBeneficiary` to legal entity
2_188	Add `proofOfOwnership` document document for verification to legal entity
2_189	Add `soleProprietorship.registrationNumber` to legal entity
2_190	Add `partnership.entityAssociations` of type `secondaryPartner` to legal entity
2_191	Add `organization.dateOfIncorporation` to legal entity
2_192	Add `soleProprietorship.dateOfIncorporation` to legal entity
2_193	Add `trust.entityAssociations` of type `undefinedBeneficiary` to legal entity
2_194	Add `organization.registeredAddress.postalCode` to legal entity
2_195	Add `organization.principalPlaceOfBusiness.country` to legal entity
2_196	Add `organization.registeredAddress.country` to legal entity
2_197	Add `organization.principalPlaceOfBusiness.stateOrProvince` to legal entity
2_198	Add `organization.registeredAddress.stateOrProvince` to legal entity
2_198	Add `organization.principalPlaceOfBusiness.street` to legal entity
2_206	Add `organization.registeredAddress.street` to legal entity
2_207	Add `organization.principalPlaceOfBusiness.city` to legal entity
2_208	Add `organization.registeredAddress.city` to legal entity
2_209	Add `organization.principalPlaceOfBusiness.postalCode` to legal entity
2_210	Add `organization.registeredAddress.street2` to legal entity
2_211	Add `organization.principalPlaceOfBusiness.street2` to legal entity
2_212	Add `trust.description` to legal entity
2_213	Add `taxInformation` from the `registeredAddress.country` to legal entity
2_214	Upload a proof of funding or wealth source
2_215	Upload a live selfie
2_216	Update Legal Entity Type
2_217	Add tax information to legal entity
2_218	Add `taxInformation.number` to legal entity
2_219	Add `taxInformation.type` to legal entity
2_220	Add `taxInformation.country` to legal entity
2_221	Add `individual.entityAssociations` of type `legalRepresentative` to legal entity
2_222	Upload a proof of relationship to individual
2_223	Add `organization.countryOfGoverningLaw` to legal entity
2_224	Add `taxInformation` or `legalArrangement` to legal entity
2_225	Add financial report to legal entity
2_226	Provide number of employees for legal entity
2_227	Provide balance sheet total for legal entity
2_228	Provide annual turnover for legal entity
2_229	Add `businessLine.sourceOfFunds.annualTurnover` to business line
2_230	Add `businessLine.sourceOfFunds.originatorLegalEntityId` to business line
2_231	Add `businessLine.sourceOfFunds.financiers` to business line
2_232	Add `businessLine.sourceOfFunds.website` to business line
2_233	Add `legalArrangement.doingBusinessAs` to legal entity
2_234	Add `organization.support.email` to legal entity
2_235	Add `individual.support.email` to legal entity
2_236	Add `organization.support.phone.number` to legal entity
2_237	Add `individual.support.phone.number` to legal entity

Missing contracts

Remediating action code	Message
2_901	Sign PCI
2_902	Accept TOS
2_903	Add `organization.stockData` to legal entity.
2_904	Contact support

Data review

Remediating action code	Message
3_100	Use the /legalEntities/{id}/confirmDataReview to indicate that the data is confirmed