These values feed identity verification (KYC/KYB). The accepted tax ID type depends on the customer’s country of residence (or country of incorporation, for businesses). When a country is not listed, any tax ID type is accepted as a fallback.
Company registration numbers (
businessInformation.registrationNumber and registrationNumberType) are stored and verified separately from the tax ID. Do not submit a VAT or tax number as the registration number. See EEA+ businesses for accepted registration number types.Identity document types
Government-issued ID documents are uploaded viaPOST /v2/document using the documentType field. Accepted ID document types depend on the upload target:
br_digital_drivers and br_digital_id are accepted only with country: "BRA". They are single-sided: upload one image and omit the side field. These types cover Brazilian digital documents (CNH digital, RG digital). Physical Brazilian documents continue to use drivers and id_card with front and back.liveness_report_document (liveness/face verification, individuals and business representatives), proof_of_address_document (business representatives), and the business-customer documents incorporation_cert_document, shareholder_registry_document, and proof_of_address_document. See the Upload a document reference for the full per-target list.
Accepted ID document types can be further restricted by the issuing country. Always send the issuing-country ISO 3166-1 alpha-3 code in the
country field; if a document type is not enabled for that country, the upload is rejected.Tax identification number types
When you provide tax identification details on a customer, all ofnumber, type, and country are required together. The type is one of the codes below; which codes are valid depends on the country.
- Individual customers —
personalInformation.taxIdentification.type(e.g."ssn","cpf"). - Business customers — the business tax ID type for the country of incorporation (e.g.
"ein","cnpj").
United States: the individual tax ID type is always treated as
ssn and a tax identification number is required. Other countries: if the country is not in the tables below, any tax ID type string is accepted (allowAnyTaxIdType fallback).Common examples
Tax ID type glossary
Full names for every tax ID type code referenced in the tables on this page.Tax ID type glossary (all codes)
Tax ID type glossary (all codes)
Full country reference
Individual tax ID types by country (154 countries)
Individual tax ID types by country (154 countries)
Business tax ID types by country (138 countries)
Business tax ID types by country (138 countries)