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)

Argentina (AR)

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

Required Fields

Field PathTypeRequiredDescription
document.idstringDocument 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

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 "id": "20345678901",
14 "type": "cuit"
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
  • CUIT/CUIL must be exactly 11 digits

Brazil (BR)

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

Required Fields

Field PathTypeRequiredDescription
document.idstringDocument 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

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 "id": "12345678901",
14 "type": "cpf"
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.idstringDocument 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

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 "id": "1020304050",
15 "type": "cc"
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.vpastringUPI Virtual Payment Address

Example Request

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 "vpa": "9876543210@paytm"
19 }
20 }
21}

Validation Notes

  • Email is required for India
  • Phone is required for India (must start with +91, max 20 characters)
  • VPA must contain exactly one @ symbol (format: identifier@provider)
  • VPA 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

Example Request

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.

Required Fields

Field PathTypeRequiredDescription
financial_account.typestringMust be bank_account
financial_account.details.account_numberstringBank account number
financial_account.details.bank_codestringPhilippine bank code

Example Request

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 "bank_code": "BPI"
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.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

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 "sort_code": "200000",
16 "account_number": "55779911",
17 "bank_account_holder_name": "James Smith"
18 }
19 }
20}

Validation Notes

  • 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: Austria (AT), Belgium (BE), 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-Euro SEPA: Bulgaria (BG), Czech Republic (CZ), Denmark (DK), Hungary (HU), Iceland (IS), Liechtenstein (LI), Norway (NO), Poland (PL), Romania (RO), Sweden (SE), Switzerland (CH)

Required Fields

Field PathTypeRequiredDescription
financial_account.typestringMust be bank_account
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

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 "iban": "DE89370400440532013000",
16 "bank_account_holder_name": "Anna Mueller"
17 }
18 }
19}

Validation Notes

  • 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
  • The address.country must match a supported SEPA country code

Country Requirements Summary

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

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
IndiaINRupiUPIvpa
MexicoMXNbank_accountSPEIclabe
PhilippinesPHPbank_accountInstaPayaccount_number, bank_code
United KingdomGBPbank_accountFaster Paymentssort_code, account_number, bank_account_holder_name
SEPA CountriesEURbank_accountSEPA Instantiban, bank_account_holder_name