Search

Are you looking for test card numbers?

Would you like to contact support?

Marketpay icon

Company check

Understand the requirements for the business entity verification.

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:

uiComponent-dropdownAndTabs
        {
   "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:

  1. 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.
  2. 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.
  3. 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.

  1. Collect the company registration document from your sub-merchant. Make sure that the document complies with the requirements.
  2. 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.

    Upload a company document
    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 for type COMPANY_VERIFICATION in the response.

    Response
    {
     "invalidFields": [],
     "pspReference": "8816092311242510",
     "accountHolderCode": "AH6323",
     ...
     "legalEntity": "Business",
     "verification": {
       "accountHolder": {
         "checks": [
           {
             "type": "COMPANY_VERIFICATION",
             "status": "DATA_PROVIDED"
           }
         ]
       },
       ...
     }
    }
  3. 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

See also