Format the amount value
Last updated: November 10, 2026
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:
1{2"source": {3"type": "card",4"number": "4242424242424242",5"expiry_month": 12,6"expiry_year": 20307},8"amount": 100,9"currency": "JPY"10}
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.
1{2"source": {3"type": "card",4"number": "4242424242424242",5"expiry_month": 12,6"expiry_year": 20307},8"amount": 100000,9"currency": "BHD"10}
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.
1{2"source": {3"type": "card",4"number": "4242424242424242",5"expiry_month": 12,6"expiry_year": 20307},8"amount": 10000,9"currency": "USD"10}
For the CLP Chilean Peso currency, the last two digits of the amount must always be 00. Multiply the intended payment amount by 100 to get the amount value. For example, to request a payment of 1050 Chilean pesos, set amount to 105000.
Information
Payment amounts that do not end in 00 are invalid but may still be accepted by Checkout.com. This could result in the incorrect amount being charged or captured.
The CLP format rule does not apply to authentication requests sent using the Standalone API.
1{2"source": {3"type": "card",4"number": "4242424242424242",5"expiry_month": 12,6"expiry_year": 20307},8"amount": 105000,9"currency": "CLP"10}
CLPChilean Peso