The company verification only applies to account holders where the legalEntity
is Business.
You can provide the required information about the company associated with the account holder through a /createAccountHolder or /updateAccountHolder call.
Required fields
To get the verification status DATA_PROVIDED for the company check, include the following fields in the accountHolderDetails
object of your /createAccountHolder or /updateAccountHolder call:
{ "dropdownOptions":[ { "id":"US", "displayName":"US - United States", "imageName":"us.png", "tabs":[ { "displayName":"For businesses", "sections":[ { "displayName":"", "fields":[ "email", "fullPhoneNumber", "", "businessDetails.registrationNumber (*)", "businessDetails.legalBusinessName", "", "address.country", "address.stateOrProvince", "address.city", "address.postalCode", "address.street", "address.houseNumberOrName" ] } ] } ] }, { "id": "CA", "displayName": "CA - Canada", "imageName": "ca.png", "tabs": [{ "displayName": "For businesses", "sections": [{ "displayName": "Company check", "fields":[ "email", "fullPhoneNumber", "", "businessDetails.registrationNumber (*)", "businessDetails.legalBusinessName", "", "address.country", "address.stateOrProvince", "address.city", "address.postalCode", "address.street", "address.houseNumberOrName" ] } ] } ] }, { "id":"Other", "displayName":"Other countries", "imageName":"world.png", "tabs":[ { "displayName":"For businesses", "sections":[ { "displayName":"", "fields":[ "email", "fullPhoneNumber", "", "businessDetails.registrationNumber (*)", "businessDetails.legalBusinessName", "", "address.country", "address.city", "address.postalCode", "address.street", "address.houseNumberOrName" ] } ] } ] } ] }
( * ) For more information, see Providing a business registration number below.
When collecting information from a sub-merchant, make sure that they do not provide PO boxes for addresses. PO boxes are not accepted as addresses.
Providing a business registration number
Specify the local registration number of the business in businessDetails.registrationNumber
. Use the following table to identify which registration number is required. For some countries, you can provide any of the registration numbers in the list.
Country | Registration number | Example |
---|---|---|
Australia | Australian Business Number (ABN) or Australian Company Number (ACN) |
ABN: 51 064 874 531 ACN: 064 874 531 |
Austria | Firmenbuchnummer | FN123456m |
Belgium | Company Number/Numéro d'entreprise | 1234567890 |
Brazil | CNPJ | 42.318.949/0001-84 |
Canada | Business Number | 123456789 |
Czech Republic | IČO | 123 45 678 |
Denmark | CVR-nummer | 22756214 |
Estonia | Registrikood | 10345833 |
Finland | Y-TUNNUS | 1234567-8 |
France | SIRET number or SIREN number |
SIRET: 542051180-00066 SIREN: 542051180 |
Germany | Handelsregisternummer | HRB 100484 |
Greece | GEMI number ΑΡΙΘΜΟΣ Γ.Ε.ΜΗ ( Γενικού Εμπορικού Μητρώου) |
757001000 |
Hungary | Cégjegyzékszám | 01-17-000705 |
Ireland | Company Number | 123456 |
Italy | Codice fiscale or CCIAA number |
Codice fiscale: 00470400011 CCIAA number: TO0091712 |
Latvia | Reģistrācijas numurs | 50003251661 |
Lithuania | Įmonės kodas | 210316340 |
Luxembourg | RCS number Registernummer Numéro RCS |
9999999999999 |
Netherlands | Kamer van Koophandel (KvK) | 34179503 |
Norway | Organisasjonsnummer | 923 609 016 |
Poland | Numer KRS or Numer identyfikacyjny REGON |
Numer KRS: 0000123456 Numer identyfikacyjny REGON: 610188201 |
Portugal | NIPC | 123456789 |
Spain | Número de Identificación Fiscal (NIF) | A39000013 |
Slovakia | Identifikačné číslo (IČO) | 12345679 |
Slovenia | Matična številka | 0101006500006 |
Sweden | Organisationsnummer | 202100-5489 |
Switzerland | UID/IDE/IDI or CH-number |
UID/IDE/IDI: CHE123456789 CH-number: CH-550.0.067.293-5 |
United Kingdom | Company Number | 04366849 |
United States | Employer Identification Number (EIN) | 101002749 |
Verification statuses
You can receive the following statuses for the company check:
Status | Description | Action to take |
---|---|---|
AWAITING_DATA | We can't start the verification because some data is missing. | Provide the missing data. |
DATA_PROVIDED | All the required data has been provided, but the verification has not started because it is not required. | None. |
PENDING | Verification is in progress. | Wait for an ACCOUNT_HOLDER_VERIFICATION notification with a new status. |
INVALID_DATA | We can't verify the account holder with the provided data. | Ask the sub-merchant to review their information and update if needed. Check kycCheckCode and see if you can retry the verification by uploading documents. If so, ask the sub-merchant to provide a company registration document. |
PASSED | The provided information has passed the verification. | None. This is the final state. |
FAILED | Adyen has verified the information, but has found reasons to refuse working with this entity. | If you think this state was reached in error, reach out to Support Team. |
Retrying the verification
Adyen uses company name and business registration number to automatically verify a company. However, in some cases, automatic verification might fail. This could be due to incorrect company name or business registration number, or the data can't be verified. When this happens, Adyen sends one of the kycCheckCode
values in the following table.
kycCheckCode |
Description |
---|---|
2101 | Business registration number and/or company name and/or the shareholders appear to be incorrect. |
2130 | Business registration number and/or company name and/or the shareholders appear to be incorrect or can't be verified. |
2153 | Business registration number could not be verified. |
2154 | Business VAT number could not be verified. |
1604 | Returned for v4 and below: The submitted Taxpayer Identification Number and legal business name do not match. Correct any errors. |
If you receive any of the above kycCheckCode
, then you should:
- Ask the sub-merchant to review if their company name and business registration number are correct, and update if needed. If they update the data, submit the new data in an /updateAccountHolder request.
- In case the sub-merchant is certain that their company name and business registration number are correct, you should provide them the option to upload a company registration document.
- If you still receive any of the above
kycCheckCode
after two attempts, require the sub-merchant to upload a company registration document in addition to reviewing and updating their company name and registration number.
Adyen will use the company registration document to manually verify the company. You can submit the document to Adyen using the /uploadDocument endpoint version 5 and later.
Upload company registration document
Upload the company registration document only when you need to retry the verification. You should always collect the company name and the business registration number first.
- Collect the company registration document from your sub-merchant. Make sure that the document complies with the requirements.
-
Make a POST /uploadDocument request, specifying the following information:
documentDetail.accountHolderCode
: The code of the account holder.documentDetail.documentType
: Set to COMPANY_REGISTRATION_SCREENING. Supported from v5 and later.documentDetail.filename
: The name of the company registration file.documentContent
: The company registration document, encoded as a Base64 string.
Here's an example of how you would upload the company registration document for
accountHolderCode
AH6323.curl https://cal-test.adyen.com/cal/services/Account/v6/uploadDocument \ -H "x-API-key: YOUR_X-API-KEY" \ -H "content-type: application/json" \ -d '{ "documentContent":"dGVzdCBkb2N1bWVudCBjb250ZW50...VcdCB=", "documentDetail":{ "accountHolderCode":"AH6323", "documentType":"COMPANY_REGISTRATION_SCREENING", "filename": "companyRegistration.pdf" } }'
If the document was successfully uploaded, you receive a
status
DATA_PROVIDED fortype
COMPANY_VERIFICATION in the response. - Wait for the ACCOUNT_HOLDER_VERIFICATION notification to confirm the status. Company documents are verified asynchronously. On average, the check will take about two days to complete. When the company details are validated, the COMPANY_VERIFICATION check will have a PASSED status.
Requirements and supported documents
The company registration document must be:
- Issued by a reliable, independent source (RIS) such as the local commercial register of the country where the business is registered in.
- Issued within the last one year, or contains a signature and a state of affairs with the date not older than one year.
When you upload a company registration document, it must meet the following requirements:
- Allowed formats: JPEG, JPG, PNG, or PDF (max. 2 pages)
- Minimum allowed size: 1 KB for PDF, 100 KB for other formats
- Maximum allowed size: 4 MB