Country-specific details

When creating recipients for cross-border transfers, the required fields vary by destination country. This guide provides detailed information about the recipient and financial account requirements for each supported country.

Overview

All recipients require these base fields:

FieldTypeRequiredDescription
given_namestringRecipient’s first name
family_namestringRecipient’s last name
typestringEither individual or business
addressobjectAddress information
address.line_1stringStreet address line 1
address.line_2stringStreet address line 2
address.citystringCity
address.statestringState or province
address.postal_codestringPostal code
address.countrystringISO 3166-1 alpha-2 country code (case insensitive)
financial_accountobjectFinancial account details
emailstringRecipient’s email address (required for some countries)
phonestringRecipient’s phone number with country code (required for some countries)
documentobjectIdentity document (required for some countries)
date_of_birthstringRecipient’s date of birth in YYYY-MM-DD format

Providing date_of_birth is optional but strongly recommended: it materially improves the accuracy of compliance screening and reduces the chance of a false-positive match delaying a payout.


Additional requirements for on-ramp and off-ramp

When you create an individual with product_types containing on_ramp and/or off_ramp, the country-specific fields below still apply, but the following fields are also required for every country:

FieldTypeDescription
emailstringRecipient’s email address
phonestringRecipient’s phone number with country code
date_of_birthstringDate of birth in YYYY-MM-DD format
idv_consent_recorded_atstringISO 8601 timestamp when the end user accepted identity verification consent
documentobjectIdentity document. Always required for on-ramp and off-ramp, including for countries where the section below marks it optional. The accepted document.type is determined by the country.

For off-ramp (and combined on-ramp + off-ramp), financial_accounts must additionally contain exactly one bank_account (matching the destination country’s shape — see below) and exactly one crypto_wallet on the network the end user will off-ramp from. The wallet is also where Latitude returns stablecoins if a transfer cannot be completed.

For supported on-ramp and off-ramp corridors and their availability (Live, Beta, Coming Soon), see On-Ramps and Off-Ramps.


Argentina (AR)

Send transfers to Argentina in ARS via bank account using CBU/CVU.

Required Fields

Field PathTypeRequiredDescription
document.numberstringDocument identification number
document.typestringDocument type: cuit or cuil
financial_account.typestringMust be bank_account
financial_account.details.account_numberstring22-digit CBU or CVU account number
financial_account.details.account_typestringAccount type: cbu or cvu

Document Types

  • cuit — Clave Única de Identificación Tributaria (Tax ID for businesses)
  • cuil — Código Único de Identificación Laboral (Labor ID for individuals)

Example Request

POST /v1/recipients:

1{
2 "given_name": "Carlos",
3 "family_name": "Mendez",
4 "type": "individual",
5 "address": {
6 "line_1": "Av. Corrientes 1234",
7 "city": "Buenos Aires",
8 "state": "Buenos Aires",
9 "postal_code": "C1043",
10 "country": "ar"
11 },
12 "document": {
13 "type": "cuit",
14 "number": "20345678901"
15 },
16 "financial_account": {
17 "type": "bank_account",
18 "details": {
19 "account_number": "0170099220000067839043",
20 "account_type": "cbu"
21 }
22 }
23}

Validation Notes

  • Account number must be exactly 22 digits

Brazil (BR)

Send transfers to Brazil in BRL via PIX (instant payment system).

Required Fields

Field PathTypeRequiredDescription
document.numberstringDocument identification number (CPF or CNPJ)
document.typestringDocument type: cpf or cnpj
financial_account.typestringMust be pix
financial_account.details.pix_keystringPIX key for the recipient
financial_account.details.pix_key_typestringType of PIX key

Document Types

  • cpf — Cadastro de Pessoas Físicas (Individual Taxpayer ID, 11 digits)
  • cnpj — Cadastro Nacional da Pessoa Jurídica (Business Tax ID, 14 digits)

PIX Key Types

The pix_key_type field must match the format of the provided pix_key:

pix_key_typeDescriptionExample
emailEmail address[email protected]
phonePhone number with country code+5511999998888
tax_idCPF (11 digits) or CNPJ (14 digits)12345678901
bank_random_idUUID from recipient’s bank606effd5-59a9-431e-bc99-32a1ee4dd1f4

Example Request

POST /v1/recipients:

1{
2 "given_name": "João",
3 "family_name": "Silva",
4 "type": "individual",
5 "address": {
6 "line_1": "Rua das Flores 456",
7 "city": "São Paulo",
8 "state": "SP",
9 "postal_code": "01310-100",
10 "country": "br"
11 },
12 "document": {
13 "type": "cpf",
14 "number": "12345678901"
15 },
16 "financial_account": {
17 "type": "pix",
18 "details": {
19 "pix_key": "[email protected]",
20 "pix_key_type": "email"
21 }
22 }
23}

Validation Notes

  • PIX is Brazil’s instant payment system and supports 24/7 transfers
  • CPF must be exactly 11 digits; CNPJ must be exactly 14 digits

Colombia (CO)

Send transfers to Colombia in COP via ACH.

Required Fields

Field PathTypeRequiredDescription
emailstringRecipient’s email address
document.numberstringDocument identification number
document.typestringDocument type (see below)
financial_account.typestringMust be bank_account
financial_account.details.bank_codestringColombian bank code
financial_account.details.account_numberstringBank account number
financial_account.details.account_typestringAccount type: checking or savings

Document Types

  • cc — Cédula de Ciudadanía (Citizenship Card)
  • ce — Cédula de Extranjería (Foreigner ID)
  • nit — Número de Identificación Tributaria (Tax ID for businesses)
  • pep — Permiso Especial de Permanencia (Special Residence Permit)
  • passport — International passport

Example Request

POST /v1/recipients:

1{
2 "given_name": "Juan",
3 "family_name": "Diego",
4 "type": "individual",
5 "email": "[email protected]",
6 "address": {
7 "line_1": "Calle 100 #15-20",
8 "city": "Bogotá",
9 "state": "Cundinamarca",
10 "postal_code": "110111",
11 "country": "co"
12 },
13 "document": {
14 "type": "cc",
15 "number": "1020304050"
16 },
17 "financial_account": {
18 "type": "bank_account",
19 "details": {
20 "bank_code": "007",
21 "account_number": "1234567890",
22 "account_type": "checking"
23 }
24 }
25}

Validation Notes

  • Email is required for Colombia
  • Document is required for Colombia

India (IN)

Send transfers to India in INR via UPI (Unified Payments Interface).

Required Fields

Field PathTypeRequiredDescription
emailstringRecipient’s email address
phonestringPhone number with country code (must start with +91)
financial_account.typestringMust be upi
financial_account.details.upi_idstringUPI Virtual Payment Address

Example Request

POST /v1/recipients:

1{
2 "given_name": "Rahul",
3 "family_name": "Patel",
4 "type": "individual",
5 "email": "[email protected]",
6 "phone": "+919876543210",
7 "address": {
8 "line_1": "Flat 304, Building B, Sunshine Apartments",
9 "line_2": "12/A, MG Road",
10 "city": "Bengaluru",
11 "state": "Karnataka",
12 "postal_code": "560001",
13 "country": "in"
14 },
15 "financial_account": {
16 "type": "upi",
17 "details": {
18 "upi_id": "9876543210@paytm"
19 }
20 }
21}

Validation Notes

  • Email is required for India
  • Phone is required for India (must start with +91, max 20 characters)
  • UPI ID must contain exactly one @ symbol (format: identifier@provider)
  • UPI ID cannot exceed 45 characters

Mexico (MX)

Send transfers to Mexico in MXN via SPEI (Sistema de Pagos Electrónicos Interbancarios).

Required Fields

Field PathTypeRequiredDescription
financial_account.typestringMust be bank_account
financial_account.details.clabestring18-digit CLABE interbank account number

Document

For off-ramp, document is required. For other product types it is optional. The only accepted document.type is curp (Clave Única de Registro de Población).

The CURP must be 18 characters: 4 uppercase letters, 6 digits, H or M, 2 uppercase letters, 3 uppercase letters, 1 alphanumeric character, and 1 digit.

Example Request

POST /v1/recipients:

1{
2 "given_name": "Maria",
3 "family_name": "Lopez",
4 "type": "individual",
5 "address": {
6 "line_1": "Paseo de la Reforma 505",
7 "city": "Ciudad de México",
8 "state": "CDMX",
9 "postal_code": "06500",
10 "country": "mx"
11 },
12 "financial_account": {
13 "type": "bank_account",
14 "details": {
15 "clabe": "002180701234567895"
16 }
17 }
18}

Validation Notes

  • CLABE must be exactly 18 digits
  • Transfers are processed via Mexico’s SPEI system

Philippines (PH)

Send transfers to the Philippines in PHP via InstaPay. Recipients can be funded into either a bank account or a digital wallet.

Document

For off-ramp, document is required. For other product types it is optional. The only accepted document.type is tin (Tax Identification Number).

Bank Account

Field PathTypeRequiredDescription
financial_account.typestringMust be bank_account
financial_account.details.account_numberstringBank account number
financial_account.details.issuerstringIdentifier of the receiving bank (see below)

The issuer must be one of a fixed set of bank identifiers. Common values include:

ValueBank
bpiBPI
bdoBDO Network Bank
bdouniBDO Bank
metrobankMetrobank
unionbankUnion Bank of the Philippines
chinabankChina Bank
landbankLANDBANK
pnbPNB
rcbcRCBC
securitySecurity Bank
gotymeGoTyme Bank
seabankSeabank
tonikTonik Bank
mayabankMaya Bank

Contact support for the full list of supported bank identifiers.

Example Request — Bank Account

POST /v1/recipients:

1{
2 "given_name": "Joseph",
3 "family_name": "Fajagut",
4 "type": "individual",
5 "address": {
6 "line_1": "123 Rizal Avenue",
7 "city": "Manila",
8 "state": "Metro Manila",
9 "postal_code": "1000",
10 "country": "ph"
11 },
12 "financial_account": {
13 "type": "bank_account",
14 "details": {
15 "account_number": "1234567890",
16 "issuer": "bpi"
17 }
18 }
19}

Digital Wallet

Field PathTypeRequiredDescription
financial_account.typestringMust be digital_wallet
financial_account.details.account_numberstringWallet account number (typically the recipient’s mobile number)
financial_account.details.issuerstringIdentifier of the e-wallet provider (see below)

Supported issuer values for digital wallets include:

ValueWallet
gcashGCash
paymayaPayMaya / Maya Wallet
grabpayGrabPay
shopeepayShopeePay
coins.phCoins.ph
starpayStarpay
palawanpayPalawanPay
tayocashTayoCash

Contact support for the full list of supported e-wallet identifiers.

Example Request — Digital Wallet

POST /v1/recipients:

1{
2 "given_name": "Joseph",
3 "family_name": "Fajagut",
4 "type": "individual",
5 "address": {
6 "line_1": "123 Rizal Avenue",
7 "city": "Manila",
8 "state": "Metro Manila",
9 "postal_code": "1000",
10 "country": "ph"
11 },
12 "financial_account": {
13 "type": "digital_wallet",
14 "details": {
15 "account_number": "09171234567",
16 "issuer": "gcash"
17 }
18 }
19}

Validation Notes

  • Transfers are processed via the InstaPay network

United Kingdom (GB)

Send transfers to the United Kingdom in GBP via Faster Payments.

Required Fields

Field PathTypeRequiredDescription
financial_account.typestringMust be bank_account
financial_account.details.bank_account_countrystringCountry of the recipient’s bank account — must be GB
financial_account.details.sort_codestring6-digit UK sort code
financial_account.details.account_numberstring8-digit UK bank account number
financial_account.details.bank_account_holder_namestringName on the bank account (2-140 characters)

Example Request

POST /v1/recipients:

1{
2 "given_name": "James",
3 "family_name": "Smith",
4 "type": "individual",
5 "address": {
6 "line_1": "10 Downing Street",
7 "city": "London",
8 "state": "England",
9 "postal_code": "SW1A 2AA",
10 "country": "gb"
11 },
12 "financial_account": {
13 "type": "bank_account",
14 "details": {
15 "bank_account_country": "GB",
16 "sort_code": "200000",
17 "account_number": "55779911",
18 "bank_account_holder_name": "James Smith"
19 }
20 }
21}

Validation Notes

  • bank_account_country must be GB
  • Sort code must be exactly 6 digits
  • Account number must be exactly 8 digits
  • Bank account holder name must be between 2 and 140 characters
  • Transfers are processed via the Faster Payments network

SEPA Countries (EUR)

Send transfers in EUR via SEPA Instant to any of the supported SEPA zone countries. All SEPA countries share the same recipient requirements.

Supported Countries

Eurozone (21 countries): Austria (AT), Belgium (BE), Bulgaria (BG), Croatia (HR), Cyprus (CY), Estonia (EE), Finland (FI), France (FR), Germany (DE), Greece (GR), Ireland (IE), Italy (IT), Latvia (LV), Lithuania (LT), Luxembourg (LU), Malta (MT), Netherlands (NL), Portugal (PT), Slovakia (SK), Slovenia (SI), Spain (ES)

Non-Eurozone SEPA (EU): Czech Republic (CZ), Denmark (DK), Hungary (HU), Poland (PL), Romania (RO), Sweden (SE)

Non-EU SEPA (EEA): Iceland (IS), Liechtenstein (LI), Norway (NO), Switzerland (CH)

Required Fields

Field PathTypeRequiredDescription
financial_account.typestringMust be bank_account
financial_account.details.bank_account_countrystringISO 3166-1 alpha-2 code of the bank account’s country — must be a supported SEPA country
financial_account.details.ibanstringIBAN (International Bank Account Number)
financial_account.details.bank_account_holder_namestringName on the bank account (2-140 characters)
financial_account.details.bicstringBIC/SWIFT code (8 or 11 characters, optional)

Example Request

POST /v1/recipients:

1{
2 "given_name": "Anna",
3 "family_name": "Mueller",
4 "type": "individual",
5 "address": {
6 "line_1": "Friedrichstraße 123",
7 "city": "Berlin",
8 "state": "Berlin",
9 "postal_code": "10117",
10 "country": "de"
11 },
12 "financial_account": {
13 "type": "bank_account",
14 "details": {
15 "bank_account_country": "DE",
16 "iban": "DE89370400440532013000",
17 "bank_account_holder_name": "Anna Mueller"
18 }
19 }
20}

Validation Notes

  • bank_account_country must be a supported SEPA country code; it does not need to match address.country (e.g. a recipient living in France can be paid into a German IBAN)
  • IBAN must be between 15 and 34 characters, starting with a 2-letter country code followed by 2 check digits
  • BIC/SWIFT is optional; if provided, must be 8 or 11 characters (e.g., COBADEFFXXX)
  • Bank account holder name must be between 2 and 140 characters
  • Transfers are processed via SEPA Instant

Country Requirements Summary

In addition to the base fields required for all recipients (including full address), some countries require extra fields:

This table reflects requirements for global payouts. For on-ramp and off-ramp, email, phone, document, date_of_birth, and idv_consent_recorded_at are required for every country — see Additional requirements for on-ramp and off-ramp.

CountryEmailPhoneDocument
Argentina (AR)
Brazil (BR)
Colombia (CO)
India (IN)
Mexico (MX)
Philippines (PH)
United Kingdom (GB)
SEPA Countries (EUR)

Financial Account Types Summary

CountryCurrencyFinancial Account TypePayment MethodKey Details Fields
ArgentinaARSbank_accountCBU/CVUaccount_number, account_type
BrazilBRLpixPIXpix_key, pix_key_type
ColombiaCOPbank_accountACHbank_code, account_number, account_type
IndiaINRupiUPIupi_id
MexicoMXNbank_accountSPEIclabe
PhilippinesPHPbank_accountInstaPayaccount_number, issuer
PhilippinesPHPdigital_walletInstaPayaccount_number, issuer
United KingdomGBPbank_accountFaster Paymentsbank_account_country, sort_code, account_number, bank_account_holder_name
SEPA CountriesEURbank_accountSEPA Instantbank_account_country, iban, bank_account_holder_name