Payment Instructions

When withdrawing fiat funds from Borderless, you need to specify where you’d like the funds to be sent. Since Borderless supports a wide range of countries with different payout methods - such as bank transfers, PIX, Mobile Money, and others - this is done through Payment Instructions. A Payment Instruction is created for a specific identity, and contains the method and destination details for where funds should be sent during a withdrawal.

If you’re just getting started, please check out our quick start guide.

Payment Method

The core of the Payment Instruction is the payment method, which defines how the transfer will be made. Each country may support different methods. Please see a list below of local payment rails.

Global & Multi-Region

Rail	Region	Currency	Type
SWIFT MT / ISO 20022	Global	Multi-currency	Messaging / interbank
Card networks (Visa, Mastercard, Amex, etc.)	Global	Multi-currency	Card schemes
T2 (Eurosystem RTGS)	Eurozone	EUR	RTGS
TIPS (TARGET Instant Payment Settlement)	Europe (SEPA)	EUR, SEK, DKK	Instant
Buna	Arab region (selected MENA)	AED, SAR, JOD, EGP, USD, EUR	Cross-border / regional
CIPS	Global (RMB-focused)	CNY (RMB)	Cross-border RTGS

Americas

Core account-based rails across North and South America.United States & Canada

Rail	Country	Currency	Type
ACH	US	USD	Batch ACH
Fedwire	US	USD	High-value RTGS
RTP	US	USD	Instant
FedNow	US	USD	Instant
Zelle	US	USD	Scheme / overlay
Interac e-Transfer	Canada	CAD	Instant
Lynx (RTGS)	Canada	CAD	High-value RTGS
Real-Time Rail (RTR)	Canada	CAD	Instant

Latin America

Rail	Country	Currency	Type
Pix	Brazil	BRL	Instant
TED / DOC	Brazil	BRL	RTGS / batch
SPEI	Mexico	MXN	Instant
CoDi (overlay on SPEI)	Mexico	MXN	Instant / QR
PSE (Pagos Seguros en Línea)	Colombia	COP	Near real-time
Local ACH/RTGS rails	Colombia	COP	Batch / RTGS
Local ACH/RTGS rails	Argentina	ARS	Batch / RTGS
COELSA	Argentina	ARS	Batch / RTGS
Local ACH/RTGS rails	Chile	CLP	Batch / RTGS
SPAV	Chile	CLP	Batch / RTGS
Local ACH/RTGS rails	Peru	PEN	Batch / RTGS

Europe

Euro-area SEPA rails plus major national systems.Pan-European (SEPA / Eurozone)

Rail	Region	Currency(ies)	Type
SEPA Credit Transfer	SEPA zone	EUR	Batch credit transfer
SEPA Instant Credit Transfer	SEPA zone	EUR	Instant
SEPA Direct Debit	SEPA zone	EUR	Batch debit
TARGET2	Eurozone	EUR	High-value RTGS
TIPS	Eurozone	EUR	Instant

United Kingdom & other Europe

Rail	Country	Currency(ies)	Type
Faster Payments Service (FPS)	UK	GBP	Instant
Bacs	UK	GBP	Batch ACH
CHAPS	UK	GBP	High-value RTGS
Swish	Sweden	SEK	Instant / mobile

Asia-Pacific

Rail / Scheme	Country / Region	Currency	Type
UPI (Unified Payments Interface)	India	INR	Instant
IMPS / NEFT	India	INR	Faster / batch
New Payments Platform (NPP)	Australia	AUD	Instant
FAST	Singapore	SGD	Fast ACH
PayNow (on FAST)	Singapore	SGD	Instant overlay
PromptPay	Thailand	THB	Instant
DuitNow	Malaysia	MYR	Instant
BI-FAST	Indonesia	IDR	Instant
InstaPay	Philippines	PHP	Instant
PESONet	Philippines	PHP	Batch ACH
Faster Payment System (FPS)	Hong Kong SAR	HKD, CNY	Instant
CNAPS	China (domestic)	CNY	RTGS / ACH
CIPS	Global (RMB cross-border)	CNY (RMB)	Cross-border RTGS

Middle East & North Africa

GCC and MENA rails, including instant and cross-border systems.

Rail	Country	Currency	Type
Sarie / SARIE	Saudi Arabia	SAR	Instant + batch
UAEFTS / local RTGS & ACH	UAE	AED (multi-currency for some flows)	RTGS / batch
Buna	Arab region (cross-border)	AED, SAR, EGP, USD, EUR (and others)	Cross-border RTGS / instant
InstaPay (overlay)	Egypt	EGP	Instant
Other GCC instant rails	GCC (e.g. Qatar, Bahrain, Oman, Kuwait)	Local currencies	Instant

Sub-Saharan Africa

Account-based rails alongside mobile money ecosystems.

Rail	Country	Currency	Type
NIBSS Instant Payment (NIP)	Nigeria	NGN	Instant
GhIPSS Instant Pay (GIP)	Ghana	GHS	Instant
PayShap	South Africa	ZAR	Instant
RTGS / ACH systems	Various African markets	Local currencies	RTGS / batch
Mobile money rails (M-Pesa, MTN MoMo, Airtel Money, etc.)	Kenya, TZ, UG, GH, others	KES, TZS, UGX, GHS, etc.	Wallet rails

Required Fields The required fields for a Payment Instruction depend on the payment method and the country. Each method has its own set of required data.

Usage

To create a payment instruction simply ensure the correct combination of country, currency, payment method, and required fields. You can submit payment instructions for an identity with the following endpoint:

Endpoint: POST /identities/{id}/payment-instructions

payment-instruction

{
  "country": "CountryCode",
  "currency": "FiatCurrencyId",
  "name": "Name of Payment Instruction",
  "paymentMethod": "PaymentMethod",
  "details": "PaymentInstructionDetails"
}

Payment Instructions

US
Europe
Africa
LatAm

In the United States, Payment Instructions offer two methods: ACH and Wire. The data required for both payment methods is the same:

We require a valid street address when creating US payment instructions. Address should start with a street number.

Example: 99 Central Street

{
  "country": "US",
  "currency": "USD",
  "name": "Personal USD Account",
  "paymentMethod": "ACH", // ACH, Wire

  "details": {
    "accountHolderName": "John Doe",
    "bankAccountNumber": "123456789",
    "bankAccountType": "Checking", // Savings
    "bankName": "Bank of America",
    "bankRoutingNumber": "026009593",

    "address": {
      "street1": "123 Main St",
      "street2": "Apt 4B",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US",
      "postalCode": "90001"
    }
  }
}

The SEPA (Single Euro Payments Area) payment method is available for all European countries that support payments in Euros (EUR).

{
  "country": "NL",
  "currency": "EUR",
  "name": "Personal EUR Account",
  "paymentMethod": "Sepa",

  "details": {
    "bankName": "Rabobank",
    "accountHolderName": "John Doe",
    "bankAccountNumber": "NL39RABO0301234567",
    "swiftOrBicNumber": "RABONL2U",
    "accountOwnerType": "Personal",
    "firstName": "John",
    "lastName": "Doe",

    "address": {
      "street1": "Keizersgracht 123",
      "street2": "Apt 4B",
      "city": "Amsterdam",
      "country": "NL",
      "postalCode": "1015CW"
    }
  }
}

Africa has a few different systems for payments and money transfer across the continent.

+ is required for phone fields

MobileMoney
BankTransfer (EFT)

{
  "country": "GH",
  "currency": "GHS",
  "name": "Personal GHS Account",
  "paymentMethod": "MobileMoney",

  "details": {
    "accountHolderName": "Kwame Mensah",
    "phone": "+254701234567",
    "networkProvider": "MPESA" // deprecated please use networkSlug instead
  }
}

{
  "country": "ZA",
  "currency": "ZAR",
  "name": "ZAR BankTransfer",
  "paymentMethod": "EFT", // BankTransfer, EFT (for South Africa only)
  
  "details": {
    "bankSlug": "0fPrRVk7mkkCDKpzE2oOZXhlUjgKW7bEII2pz4crGX0",
    "bankAccountNumber": "1111111111",
  
    "address": {
      "street1": "45 Sandton Drive",
      "street2": "Sandhurst",
      "city": "Johannesburg",
      "state": "Gauteng",
      "country": "ZA",
      "postalCode": "2196"
    }
  }
}

SPEI is the primary payment method in Mexico.

{
  "country": "MX",
  "currency": "MXN",
  "name": "Personal MXN Account",
  "paymentMethod": "SPEI",

  "details": {
    "bankCode": "002",
    "bankAccountNumber": "12345678901234567890123456",
    "bankName": "BBVA México",
    "taxId": "HEGJ8507157M9",
    "businessDescription": "Software Engineer",
    
    "address": {
      "street1": "Avenida Insurgentes Sur 1234",
      "street2": "Colonia del Valle",
      "city": "Mexico City",
      "state": "MX",
      "country": "MX",
      "postalCode": "03100"
    }
  }
}

PIX is the primary payment method for Brazil.

{
  "country": "BR",
  "currency": "BRL",
  "name": "Personal BRL Account",
  "paymentMethod": "PIX",

  "details": {
    "identifierType": "CPF",
    "identifierValue": "12345678901",

    "address": {
      "street1": "Avenida Paulista 1000",
      "street2": "Bela Vista",
      "city": "São Paulo",
      "state": "SP",
      "country": "BR",
      "postalCode": "01310-100"
    }
  }
}

{
  "country": "BR",
  "currency": "BRL",
  "name": "Personal BRL Account",
  "paymentMethod": "PIX",

  "details": {
    "identifierType": "PhoneNumber",
    "identifierValue": "1123456789",

    "address": {
      "street1": "Avenida Paulista 1000",
      "street2": "Bela Vista",
      "city": "São Paulo",
      "state": "SP",
      "country": "BR",
      "postalCode": "01310-100"
    }
  }
}

COELSA is a primary payment method in Argentina.

{
  "country": "AR",
  "currency": "ARS",
  "name": "Personal ARS Account",
  "paymentMethod": "COELSA",

  "details": {
    "bankCode": "072",
    "bankAccountNumber": "12345678901234567890123456",
    "bankName": "Banco Nación Argentina",
    "accountHolderName": "Carlos Martínez",
    "bankAccountNumberType": "CVU", // CBU, ALIAS
    
    "address": {
      "street1": "Calle Ficticia 456",
      "street2": "Piso 5",
      "city": "Buenos Aires",
      "country": "AR",
      "postalCode": "C1000"
    }
  }
}

Colombia can use their local PSE rails for withdrawals.

{
  "country": "CO",
  "currency": "COP",
  "name": "Personal COP Account",
  "paymentMethod": "PSE",

  "details": {
    "bankCode": "001",
    "bankAccountNumber": "12345678901234567890123456",
    "bankName": "Bancolombia",
    "accountHolderName": "Carlos Martínez",
    
    "address": {
      "street1": "Carrera 7 # 123",
      "street2": "Oficina 7A",
      "city": "Bogotá",
      "state": "DC",
      "country": "CO",
      "postalCode": "110010"
    }
  }
}

CCE payment method supports Peru.

{
  "country": "PE",
  "currency": "PEN",
  "name": "Personal PEN Account",
  "paymentMethod": "CCE",

  "details": {
    "bankCode": "003",
    "bankAccountNumber": "12345678901234567890123456",
    "bankName": "Banco de Crédito del Perú",
    "bankAccountType": "Checking",

    "address": {
      "street1": "Avenida Pardo y Aliaga 1234",
      "street2": "Oficina 302",
      "city": "Lima",
      "state": "LI",
      "country": "PE",
      "postalCode": "15073"
    }
  }
}

SPAV supports Chilean withdrawals of Peso.

{
  "country": "CL",
  "currency": "CLP",
  "name": "Personal CLP Account",
  "paymentMethod": "SPAV",

  "details": {
    "bankCode": "003",
    "bankAccountNumber": "12345678901234567890123456",
    "bankName": "BancoEstado",
    
    "address": {
      "street1": "Avenida Apoquindo 1234",
      "street2": "Oficina 404",
      "city": "Santiago",
      "state": "RM",
      "country": "Chile",
      "postalCode": "7550000"
    }
  }
}

Borderless does not validate the accuracy of the provided payment instruction details upon creation, only the format is checked.The primary validation is performed by the PFI at the time of transaction execution. This means that if the payment instruction contains incorrect details, you may receive a failureReason during the withdrawal process.It is responsibility of Integrator to validate the correctness of the provided data when creating payment instructions.

If you have any questions, please don’t hesitate to reach out to us via email or slack.

Getting Started

Core Concepts

Transaction Types

Products

Payment Instructions

Payment Method

Usage

​Payment Method

​Usage

Payment Method

Usage