API Reference
Log In
API Reference

Customers can pay international beneficiaries quickly and easily, just as they can for domestic beneficiaries.

Customers authorise the money to be paid from their bank account in GBP, just as they do for domestic payments, but instead of being paid directly to the beneficiary, international payments are paid to a funding wallet held in the customer's name. The funds are then exchanged for the target currency and automatically paid out to the international beneficiary.

To be able to pay international beneficiaries, an Organisation requires the InternationalPayments feature to be enabled. You can check the enabled features of an Organisation using Get Organisation.

Prerequisites

  • The Organisation needs to have connected a bank account using Connect
    • This enables the DomesticPayments feature
  • The Organisation needs to have completed KYC/KYB verification using Verification flow
    • Once checks are complete, this enables the InternationalPayments feature

Pay Runs

👍

Pay runs can contain a mix of domestic and international payments

All payments are sent from the customer's bank account in GBP currency, to the sending bank an international payment looks like any other domestic payment.

🚧

Scheduled pay runs cannot contain international payments

Due to the volatility of foreign exchange markets, scheduling international payments is not supported. Pay runs containing international payments must be paid immediately upon authorisation.

Rates and Fees

There are two types of fees charged on international payments:

  • Provider Fixed Fees - These are fixed fees that vary by the payment network used to send the money internationally
  • Provider Variable Fees - These are proportional to the value of the payment and can vary by target currency

Each of these fees and the exchange rate used to exchange currencies are given together with the payable in every context a payable is seen - Get pay run, and in webhook events for Payable updates.

See Get pay run for a detailed explanation of the currencyConversion response object and Collecting Fees for more info about the fees response object.

Reversed Payables

Sometimes when an international payment fails to deliver, it must be reversed and sent back to the payer. Depending on how far through processing a payment was when it failed, it could incur bank charges or losses in converting back to the funding currency, and the funds returned may be less than the funds sent.

When the status of a Payable is Returned then the amount returned will be shown in the payable's details in Get pay run and Payable status changed webhook events.

Supported Payments

We are in the process of rolling out support for currencies, countries, and payment networks.

We currently support the following currencies:

Currency CodeCurrency
AUDAustralian Dollar
BHDBahraini Dinar
CADCanadian Dollar
CHFSwiss Franc
CZKCzech Koruna
DKKDanish Krone
EUREuro
GBPGreat British Pound Sterling
HKDHong Kong Dollar
HUFHungarian Forint
IDRIndonesian Rupiah
ILSNew Israeli Sheqel
JPYJapanese Yen
KESKenyan Shilling
KWDKuwaiti Dinar
OMROmani Rial
MXNMexican Peso
NOKNorwegian Krone
NZDNew Zealand Dollar
PHPPhilippine Peso
RONRomanian Leu
QARQatari Riyal
SARSaudi Riyal
SEKSwedish Krona
SGDSingapore Dollar
THBThai Baht
TRYTurkish Lira
PLNPolish Złoty
UGXUgandan Shilling
USDUnited States Dollar
ZARSouth African Rand

GBP payments to countries other than GB (United Kingdom) are not supported.

GBP is the only supported funding currency for any payment, domestic or international.

Currency Info

Different currencies have different trading cut-off times after which currency conversion is typically performed at midnight the following day. This means that any funding that occurs after the cut-off time will delay the Payable reaching Processed state until the following day.

Different payment networks have varying delivery times, there might also be some limitations from banks for minimum amounts not readily available.

See below for guidance per currency, with specific rail information if applicable:

CurrencyTrading Cut-off Time (GB local time)Local Network Est. Delivery TimeSWIFT Network Est. Delivery TimeAmount Limits (Max)Amount Limits (Min)
Euro (EUR)14:3015 mins (SEPA Instant)< 24 hours€100,000 per transaction (SEPA Instant)
US Dollar (USD)16:30ACH: up to 2 days
Fedwire: up to 24hrs (FedNow can be 15 mins)
< 24 hours (often 2 hrs)USD 1,000,000
Australian Dollar (AUD)14:00Up to 24hrsUp to 24hrsAUD 1,000,000
South African Rand (ZAR)10:30< 24 hoursZAR 125
Canadian Dollar (CAD)16:45< 24 hoursSub 24hr (most common between 2-6 hrs)CAD 25,000 (Interac e-Transfer)
Bahrain Dinar (BHD)14:00Up to 24hrs
Chinese Yuan (CNY)09:00Up to 24hrsCNY 50,000 (Domestic Transfers)
Czech Koruna (CZK)09:00< 24hrs< 24hrsCZK 500,000
Danish Krone (DKK)10:30< 24hrs< 24hrsDKK 500,000
Hong Kong Dollar (HKD)14:00Up to 24hrsUp to 24hrsHKD 1,000,000
Hungarian Forint (HUF)09:00< 24hrs< 24hrsHUF 10,000,000
Indian Rupee (INR)< 24hrsINR 2,000,000 (RTGS)INR 200,000 (RTGS)
Indonesian Rupiah (IDR)< 24hrsIDR 1,000,000,000
Israeli Shekel (ILS)14:00Up to 24hrsILS 1,000,000
Japanese Yen (JPY)14:00Up to 24hrsJPY 100,000,000
Kenyan Shilling (KES)14:00Up to 24hrsKES 1,000,000
Kuwait Dinar (KWD)14:00Up to 24hrsKWD 30,000
Malaysian Ringgit (MYR)< 24hrsMYR 1,000,000
Mexican Peso (MXN)09:00< 24hrsMXN 500,000
New Zealand Dollar (NZD)14:00Up to 24hrsNZD 1,000,000
Norwegian Krone (NOK)10:30< 24hrs< 24hrsNOK 1,000,000
Omani Rial (OMR)14:00Up to 24hrs
Philippine Peso (PHP)< 24hrsPHP 500,000
Polish Zloty (PLN)09:30< 24hrs< 24hrsPLN 1,000,000
Qatar Rial (QAR)14:00Up to 24hrsQAR 100,000
Romanian Leu (RON)09:00< 24hrs< 24hrsRON 500,000
Saudi Riyal (SAR)14:00Up to 24hrsSAR 500,000
Singapore Dollar (SGD)14:00Up to 24hrsUp to 24hrsSGD 200,000
Swedish Krona (SEK)10:30< 24hrs< 24hrsSEK 1,000,000
Swiss Franc (CHF)10:30< 24hrsCHF 1,000,000
Thai Baht (THB)09:00Up to 24hrsTHB 2,000,000
Turkish Lira (TRY)09:30< 24hrsTRY 1,000,000
Ugandan Shilling (UGX)09:00Up to 24hrsUGX 50,000,000
United Arab Emirates Dirham (AED)14:00Up to 24hrsAED 500,000