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.
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:
Supporting (non-ID) documents use the same field:
liveness_report (liveness/face verification, individuals and business representatives), proof_of_address (business representatives), and the business-customer documents incorporation_cert, shareholder_registry, and proof_of_address. 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)