The company verification only applies to account holders with legal entity type Business or NonProfit.
You can provide the required information through a /createAccountHolder or /updateAccountHolder call.
Required fields for businesses
To get the verification status DATA_PROVIDED for a company check, send the required information in the accountHolderDetails
object of your /createAccountHolder or /updateAccountHolder call.
The required information depends on the country and legal entity type. Select the country from the drop-down box below.
{ "dropdownOptions":[ { "id":"US", "displayName":"US - United States", "imageName":"us.png", "tabs":[ { "displayName":"For businesses", "sections":[ { "displayName":"", "fields":[ "email", "fullPhoneNumber", "", "businessDetails.registrationNumber (See note 1)", "businessDetails.legalBusinessName", "", "address.country", "address.stateOrProvince", "address.city", "address.postalCode", "address.street", "address.houseNumberOrName" ] } ] } ] }, { "id":"BR", "displayName":"BR - Brazil", "imageName":"br.png", "tabs":[ { "displayName":"", "sections":[ { "displayName":"", "fields":[ "", "address.country", "address.city", "address.houseNumberOrName", "address.postalCode", "address.stateOrProvince", "address.street", "", "businessDetails.legalBusinessName", "businessDetails.registrationNumber (See note 1)", "", "email", "fullPhoneNumber" ] } ] } ] }, { "id": "CA", "displayName": "CA - Canada", "imageName": "ca.png", "tabs": [{ "displayName": "For businesses", "sections": [{ "displayName": "", "fields":[ "", "email", "fullPhoneNumber", "", "businessDetails.registrationNumber (See note 1)", "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 (See note 1)", "businessDetails.legalBusinessName", "", "address.country", "address.city", "address.postalCode", "address.street", "address.houseNumberOrName" ] } ] } ] } ] }
1 For more information on what you need to provide, see Providing a business registration number.
Additional guidelines when collecting information
When collecting information from the account holder, make sure that:
- They do not provide PO boxes for addresses. PO boxes are not accepted as addresses.
Providing a registration number for businesses
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 |
Required fields for nonprofits
You can onboard nonprofits operating in the US, Canada, Germany, Spain, France, United Kingdom, and Italy.
To get the verification status DATA_PROVIDED for the COMPANY_VERIFICATION and NONPROFIT_VERIFICATION checks, send the required information in the accountHolderDetails
object of your /createAccountHolder or /updateAccountHolder call.
The required information depends on the country and legal entity type. Select the country from the drop-down box below.
{ "dropdownOptions":[ { "id":"US", "displayName":"US - United States", "imageName":"us.png", "tabs":[ { "displayName":"For nonprofits", "sections":[ { "displayName":"", "fields":[ "", "email", "fullPhoneNumber", "", "businessDetails.registrationNumber (See note 1)", "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 nonprofits", "sections":[ { "displayName":"", "fields":[ "", "email", "fullPhoneNumber", "", "businessDetails.registrationNumber (See note 1)", "businessDetails.legalBusinessName", "", "address.country", "address.stateOrProvince", "address.city", "address.postalCode", "address.street", "address.houseNumberOrName" ] } ] } ] }, { "id":"DE", "displayName":"DE - Germany", "imageName":"de.png", "tabs":[ { "displayName":"For nonprofits", "sections":[ { "displayName":"", "fields":[ "", "email", "fullPhoneNumber", "", "businessDetails.registrationNumber (See note 2)", "businessDetails.legalBusinessName", "", "address.country", "address.city", "address.postalCode", "address.street", "address.houseNumberOrName" ] } ] } ] }, { "id":"ES", "displayName":"ES - Spain", "imageName":"es.png", "tabs":[ { "displayName":"For nonprofits", "sections":[ { "displayName":"", "fields":[ "", "email", "fullPhoneNumber", "", "businessDetails.registrationNumber (See note 1)", "businessDetails.legalBusinessName", "", "address.country", "address.city", "address.postalCode", "address.street", "address.houseNumberOrName" ] } ] } ] }, { "id":"FR", "displayName":"FR - France", "imageName":"fr.png", "tabs":[ { "displayName":"For nonprofits", "sections":[ { "displayName":"", "fields":[ "", "email", "fullPhoneNumber", "", "businessDetails.registrationNumber (See note 1)", "businessDetails.legalBusinessName", "", "address.country", "address.city", "address.postalCode", "address.street", "address.houseNumberOrName" ] } ] } ] }, { "id":"GB", "displayName":"GB - United Kingdom", "imageName":"gb.png", "tabs":[ { "displayName":"For nonprofits", "sections":[ { "displayName":"", "fields":[ "", "email", "fullPhoneNumber", "", "businessDetails.registrationNumber (See note 2)", "businessDetails.legalBusinessName", "", "address.country", "address.city", "address.postalCode", "address.street", "address.houseNumberOrName" ] } ] } ] }, { "id":"IT", "displayName":"IT - Italy", "imageName":"it.png", "tabs":[ { "displayName":"For nonprofits", "sections":[ { "displayName":"", "fields":[ "", "email", "fullPhoneNumber", "", "businessDetails.registrationNumber (See note 1)", "businessDetails.legalBusinessName", "", "address.country", "address.city", "address.postalCode", "address.street", "address.houseNumberOrName" ] } ] } ] } ] }
1 For more information on what you need to provide, see Providing a registration number for nonprofits.
2 Not required, but we strongly recommend providing this to increase the likelihood of passing the verification. See Providing a registration number for nonprofits.
Providing a registration number for nonprofits
Specify the registration number in businessDetails.registrationNumber
. For some countries, you can upload documents if a nonprofit does not have a registration number.
Country | Registration number or document | Example number |
---|---|---|
Canada | GST/HST number If not available, provide a federal or provincial incorporation number. |
123456789 |
France | RNA number or SIRET number or SIREN number |
RNA: W833201200 SIRET: 542051180-00066 SIREN: 542051180 |
Germany | Handelsregisternummer If not available, upload copy of Articles of Association. |
HRB 100484 |
Italy | Codice fiscale or CCIAA number |
Codice fiscale: 00470400011 CCIAA number: TO0091712 |
Spain | Número de Identificación Fiscal (NIF) | A39000013 |
United Kingdom | Company Number or Charity number If not available, upload copy of Governing or Constitutional Document. |
04366849 |
United States | Employer Identification Number (EIN) | 101002749 |
Uploading documents for nonprofits
For some countries such as Germany and United Kingdom, you can upload documents if a nonprofit does not have a registration number.
To upload a document, send a POST /uploadDocument request with the documentDetail.documentType set to COMPANY_REGISTRATION_SCREENING.
Here's an example of how you would upload an Articles of Association document for accountHolderCode
AH1901.
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":"AH1901",
"documentType":"COMPANY_REGISTRATION_SCREENING",
"filename": "ArticlesOfAssociation.pdf"
}
}'
If the document was successfully uploaded, you receive a status
DATA_PROVIDED for type
COMPANY_VERIFICATION and NONPROFIT_VERIFICATION in the response.
{
"invalidFields": [],
"pspReference": "8816092311242510",
"accountHolderCode": "AH1901",
...
"legalEntity": "NonProfit",
"verification": {
"accountHolder": {
"checks": [
{
"type": "COMPANY_VERIFICATION",
"status": "DATA_PROVIDED"
},
{
"type": "NONPROFIT_VERIFICATION",
"status": "DATA_PROVIDED"
}
]
},
...
}
}
Documents for nonprofits are verified asynchronously. On average, the check will take about two days to complete. You receive the results in an ACCOUNT_HOLDER_VERIFICATION webhook. When the details are validated, the COMPANY_VERIFICATION and NONPROFIT_VERIFICATION check will have a PASSED status.
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 account holder. 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 national 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