Format the amount value
Last updated: November 26, 2025
When you specify an amount in an API request, format the value based on the specified currency to ensure Checkout.com processes the correct amount.
For example, when you request a payment or request an authentication session.
Depending on the currency, you may need to provide:
Additionally, the amount value must:
- Be greater than zero
- Not contain decimals
- Not contain more than nine digits
For the following currencies, the amount you specify is the final amount, without any additional calculations.
For example, the following payment request with amount set to 100 is for 100 Japanese Yen:
BIFBurundian FrancDJFDjiboutian FrancGNFGuinean FrancISKIcelandic KronaJPYJapanese YenKMFComoran FrancKRWSouth Korean WonPYGParaguayan GuaraniRWFRwandan FrancUGXUgandan ShillingVUVVanuatu VatuVNDVietnamese DongXAFCentral African FrancXOFWest African CFA francXPFComptoirs Français du Pacifique
For the following currencies, the amount you specify is divided by 1000 to determine the final amount. For example, the following payment request with amount set to 100000 is for 100 Bahraini Dinar.
Information
The last digit must always be a 0. For example, an amount value of 1001 is invalid.
BHDBahraini DinarIQDIraqi DinarJODJordanian DinarKWDKuwaiti DinarLYDLibyan DinarOMROmani RialTNDTunisian Dinar
For all other currencies, the amount you specify is divided by 100 to determine the final amount.
For example, the following payment request with amount set to 10000 is for 100 US Dollars.
Note
For CLP (Chilean Peso), the last two digits of the amount must be 00. For example, an amount value of 100010 is invalid.