Payment Creation

The Payments API allows you to programmatically initiate fund transfers to your beneficiary's account, giving you full control over the payment lifecycle from creation through to settlement.

We support two payment scenarios depending on the currencies you hold and the currencies you need to send.

---

Scenario 1: Standard Payment

Send money in the same currency you hold — straightforward, with no conversion required.

Example: You hold USD and want to send USD to your beneficiary.

Funding your payment

• E-wallet balance — Funds are automatically deducted from your available balance at the time of payment.
• Deposit on demand — Prefer to fund later? Simply initiate a deposit immediately after the payment ticket is created, and the funds will be applied to the payment.

---

Scenario 2: FX Payment

Send money in a different currency from the one you hold. We automatically handle the currency conversion behind the scenes, so your beneficiary receives the exact currency they need.

Example: You hold USD but need to send EUR to your beneficiary.

Funding your payment

• E-wallet balance — Funds are automatically deducted from your available balance in your held currency, and converted at the applicable exchange rate.
• Deposit on demand — You can also initiate a deposit in your held currency immediately after the payment ticket is created to fund the conversion and transfer.

---

How It Works: Payment Creation Steps

Getting a payment from creation to completion involves three simple steps:

1. Set up your beneficiary — Add the person or business you want to pay by entering their account details, such as their bank account number and routing information. Already paid them before? Look them up and go.

2. Create your payment — Enter the payment amount and currency. For FX payments, you will need to include a valid quotation ID to lock in the exchange rate for the conversion. A quotation ID can be obtained by requesting an FX quote prior to payment creation, and contains the agreed exchange rate and converted amount that will be applied to your payment.

3. Fund your payment — Cover the payment using your balance for instant processing, or make a deposit after the ticket is created if you prefer to fund it manually.

---

Payment capabilities

Capay supports paying 30+ currencies, and follows international standard (ISO 4217 ) for representation of currencies.

Currency Code	Currency Name	Country	Global Payment	Local Payment
AED	United Arab Emirates Dirham	United Arab Emirates	√	√
AUD	Australian Dollar	Australia	√	√
BHD	Bahraini Dinar	Bahrain	√
BRL	Brazilian Real	Brazil		√
CAD	Canadian Dollar	Canada	√	√
CHF	Swiss Franc	Switzerland	√
CNH	Chinese Yuan (Offshore)	China	√
CNY	Chinese Yuan	China		√
CZK	Czech Koruna	Czech Republic	√	√
DKK	Danish Krone	Denmark	√	√
EUR	Euro	SEPA Countries	√	√
GBP	Pound Sterling	United Kingdom	√	√
HKD	Hong Kong Dollar	Hong Kong	√	√
HUF	Hungarian Forint	Hungary	√
IDR	Indonesian Rupiah	Indonesia		√
ILS	Israeli Shekel	Israel	√
INR	Indian Rupee	India		√
JPY	Japanese Yen	Japan	√
KES	Kenyan Shilling	Kenya	√
KRW	South Korean Won	South Korea		√
KWD	Kuwaiti Dinar	Kuwait	√
MXN	Mexican Peso	Mexico	√
MYR	Malaysian Ringgit	Malaysia		√
NOK	Norwegian Krone	Norway	√	√
NZD	New Zealand Dollar	New Zealand	√
OMR	Omani Rial	Oman	√
PHP	Philippine Peso	Philippines		√
PLN	Polish Złoty	Poland	√	√
QAR	Qatari Rial	Qatar	√
RON	Romanian Leu	Romania	√	√
SAR	Saudi Riyal	Saudi Arabia	√
SEK	Swedish Krona	Sweden	√	√
SGD	Singapore Dollar	Singapore	√	√
THB	Thai Baht	Thailand	√
TRY	Turkish Lira	Turkey	√	√
UGX	Ugandan Shilling	Uganda	√
USD	US Dollar	United States	√	√
VND	Vietnamese Dong	Vietnam		√
ZAR	South African Rand	South Africa	√

The table above lists the currencies technically supported by our API. The final capability of money collection available is subject to the valid commercial agreement.

Charged fee

For each payment transaction, a specific fee will be charged depending on the payment method associated with it.

Fee Type	Deducted From	Method
SHARED	Payment amount & Payment Fee	SWIFT
OURS	Payment Fee	SWIFT
LOCAL	Payment Fee	Local
INNER	-	CAPAY

INNER means that your beneficiary is a client of CAPAY as well, you are identified by uniquePayId as known as CAPAY FastID. It allows you to make payments with Capay‘s clients without charged fee.