Pesquisar

Are you looking for test card numbers?

Would you like to contact support?

Atenção, esta página não se encontra disponível em Português
Marketpay icon

Company check

Understand the requirements for the business entity verification.

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.

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

1Provide 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

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
Bulgaria ЕИК/UIC number 812114069
Canada Business Number 123456789
Croatia MBS 080020970
Cyprus Αριθμός Εγγραφής C337518
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
ΑΡΙΘΜΟΣ Γ.Ε.ΜΗ ( Γενικού Εμπορικού Μητρώου)
757001000000
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
Lichtenstein Įmonės kodas 166451720
Lithuania Įmonės kodas 210316340
Luxembourg RCS number
Registernummer
Numéro RCS
9999999999999
Malta Company registration number C 43070
Monaco Numéro de RCI 56S00448
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
Romania Numar de ordine in registrul comertului J40/8302/1997
Singapore UEN 201688888A
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.

uiComponent-dropdownAndTabs
        {
    "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 Provide a registration number.
2 Not required, but we strongly recommend providing a registration number to increase the likelihood of passing the verification.

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.

Upload a 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":"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.

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 automatic verification fails, Adyen sends a kycCheckCode field.

  • For API version 5 and later, refer to Company check verification codes for a full list.
  • For API version 4 and earlier, Adyen sends:

    kycCheckCode Description
    1604 The submitted Taxpayer Identification Number and legal business name do not match. Correct any errors.

If you receive any of the company check verification codes described above, 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 after three attempts you still receive any of kycCheckCode described above, 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 account holder. 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 registration 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 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

See also