Company check

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.

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.

Verification statuses

You can receive the following statuses for the company check:

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.

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

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.

   https://docs.adyen.com/platforms/onboarding-and-verification/verification-checks/company-check#upload-a-company-document

   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.

   https://docs.adyen.com/platforms/onboarding-and-verification/verification-checks/company-check#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