The Drop-In and Checkout API uses country-specific fields to 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.

If the BillingProfile.Country contains any of the below countries, ensure the additional field requirements listed under that country are met.

All fields will be contained within the BillingProfile object.

Argentina

If Argentina (AR) is listed as the BillingProfile.Country the following field is required:

• BillingProfile.NationalIdentifier: Requires a DNI (Documento Nacional de Identidad).

Brazil

If Brazil (BR) is listed as the BillingProfile.Country the following fields are required:

• 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

If Canada (CA) is listed as the BillingProfile.Country the following fields are required:

• 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

India

If India (IN) is listed as the BillingProfile.Country the following field is required:

• BillingProfile.NationalIdentifier: Requires a PAN (Permanent Account Number), a 10-digit unique identification alphanumeric number.

Mexico

If Mexico (MX) is listed as the BillingProfile.Country the following fields are required:

• 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

United States

If the United States (US) is listed as the BillingProfile.Country the following fields are required:

• 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.

United States regions