Format the payment amount
Last updated: October 9, 2024
When you send a payment request, our payment gateway assesses the amount and currency values you provide to determine the final charge amount.
The value you provide in the payment request's amount field must:
- Be greater than zero
- Not contain decimals
- Not contain more than 9 digits
To ensure we charge the correct amount, you must format the amount field according to the currency you specify. Depending on the currency, you may need to provide:
For the following currencies, the value you provide in the amount field determines the full charge amount, without any additional calculations. For example, to charge 100 Japanese Yen, specify "amount": 100 in the payment request.
| Currency code | Currency name |
|---|---|
BIF | Burundian Franc |
DJF | Djiboutian Franc |
GNF | Guinean Franc |
ISK | Icelandic Krona |
JPY | Japanese Yen |
KMF | Comoran Franc |
KRW | South Korean Won |
PYG | Paraguayan Guarani |
RWF | Rwandan Franc |
UGX | Ugandan Shilling |
VUV | Vanuatu Vatu |
VND | Vietnamese Dong |
XAF | Central African Franc |
XOF | West African CFA franc |
XPF | Comptoirs Français du Pacifique |
For the following currencies, the value you provide in the amount field is divided by 1000 to determine the full charge amount. For example, to charge 100 Bahraini Dinar, specify "amount": 100000 in the payment request.
Information
The last digit must always be a 0. For example, an amount value of 1001 is invalid.
| Currency code | Currency name |
|---|---|
BHD | Bahraini Dinar |
IQD | Iraqi Dinar |
JOD | Jordanian Dinar |
KWD | Kuwaiti Dinar |
LYD | Libyan Dinar |
OMR | Omani Rial |
TND | Tunisian Dinar |
For all other currencies, the value you provide in the amount field is divided by 100 to determine the full charge amount. For example, to charge 100 US Dollars, specify "amount": 10000 in the payment request.
Note
If the payment request currency is the Chilean Peso (CLP), the last two digits of the amount must be 00. For example, an amount value of 100010 is invalid.