Skip to main content
When onboarding customers, the Customers API and Documents API accept a fixed set of identity document types and country-specific tax identification number types. This page is the reference for both.
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.
Los números de registro de la empresa (businessInformation.registrationNumber y registrationNumberType) se almacenan y verifican por separado del ID fiscal. No envíes un número de IVA o fiscal como número de registro. Consulta Empresas EEA+ para los tipos de número de registro aceptados.

Identity document types

Government-issued ID documents are uploaded via POST /v2/document using the documentType field. Accepted ID document types depend on the upload target:
br_digital_drivers y br_digital_id se aceptan solo con country: "BRA". Son de una sola cara: sube una imagen y omite el campo side. Estos tipos cubren los documentos digitales brasileños (CNH digital, RG digital). Los documentos físicos brasileños siguen usando drivers e id_card con anverso y reverso.
Supporting (non-ID) documents use the same field: 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 of number, type, and country are required together. The type is one of the codes below; which codes are valid depends on the country.
  • Individual customerspersonalInformation.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.

Full country reference

Última modificación el 24 de agosto de 2026