Drop-In and Checkout API use country-specific fields that ensure compliance with local regulations and enhance user experience. This document explains the necessary fields for processing billing and shipping information based on the customer's country.
Argentina
BillingProfile.NationalIdentifier: Requires a DNI (Documento Nacional de Identidad).
Brazil
BillingProfile.NationalIdentifier: Requires a CPF (Cadastro de Pessoas Físicas) or CNPJ (Cadastro Nacional da Pessoa Jurídica). If you provide the CNPJ, include the BillingProfile.Company.
BillingProfile.Company: Provide this field if a CNPJ is the BillingProfile.NationalIdentifier.
BillingProfile.Birthdate: Provide a valid birthdate in the format: yyyy-MM-dd.
BillingProfile.Postcode: Requires an eight-digit numeric Brazilian postal code.
Canada
BillingProfile.Postcode: Requires a valid Canadian Postal code (e.g., A1B 2C3).
BillingProfile.Region: Requires a two-letter valid Canadian province or territory code. See Canadian regions for a list of valid codes.
Canadian regions
Value
Description
AB
Alberta
BC
British Columbia
MB
Manitoba
NB
New Brunswick
NL
Newfoundland and Labrador
NS
Nova Scotia
NT
Northwest Territories
NU
Nunavut
ON
Ontario
PE
Prince Edward Island
QC
Quebec
SK
Saskatchewan
YT
Yukon
India
BillingProfile.NationalIdentifier: Requires a PAN (Permanent Account Number), a 10-digit unique identification alphanumeric number.
Mexico
BillingProfile.NationalIdentifier: expects an RFC (Registro Federal de Contribuyentes) or CURP (Clave Única de Registro de Población).
BillingProfile.Postcode: Requires a five-digit numeric Mexican postal code.
BillingProfile.Region: Requires a two or three-letter valid Mexican state. See Mexican regions for a list of valid Mexican states.
Mexican regions
Value
Description
AGS
Aguascalientes
BC
Baja California
BCS
Baja California Sur
CAM
Campeche
COA
Coahuila
COL
Colima
CHS
Chiapas
CHI
Chihuahua
DF
Distrito Federal
DGO
Durango
GTO
Guanajuato
GRO
Guerrero
HGO
Hidalgo
JAL
Jalisco
MEX
Mexico
MIC
Michoacan
MOR
Morelos
NAY
Nayarit
NL
Nuevo Leon
OAX
Oaxaca
PEU
Puebla
QRO
Queretaro
ROO
Quintana Roo
SLP
San Luis Potosi
SIN
Sinaloa
SON
Sonora
TAB
Tabasco
TAM
Tamaulipas
TLA
Tlaxcala
VER
Veracruz
YUC
Yucatan
ZAC
Zacatecas
United States
BillingProfile.Postcode: Requires a five-digit numeric ZIP code.
BillingProfile.Region: Requires a two-letter valid American state/territory. See United States regions for a list of valid American states/territories.