Calculating the value

Our payment gateway determines the charge amount by assessing the value and the currency contained in the charge request.

The value field in a charge request must be a non-zero positive integer — no decimals. Depending on the currency of the payment, there are three options for calculating the value amount:

📘
Please note:
The amount field accepts a minimum of one and a maximum of nine digits; this is true for all currencies.

Option 1: The full value

For the following currencies, the value is the same as the full charge amount; for example, value = 100 is equal to 100 Japanese Yen.

Currency code	Currency name
BIF	Burundian Franc
DJF	Djiboutian Franc
GNF	Guinean Franc
ISK	Icelandic Krona
KMF	Comoran Franc
XAF	Central African Franc
CLF	Chilean Unidad de Fomentos
XPF	Comptoirs Français du Pacifique
JPY	Japanese Yen
PYG	Paraguayan Guarani
RWF	Rwandan Franc
KRW	South Korean Won
VUV	Vanuatu Vatu
VND	Vietnamese Dong
XOF	West African CFA franc

Below is an example payment request for 5000 Japanese Yen.

{
  "source": {
    "type": "card",
    "number": "4242424242424242",
    "expiry_month": 6,
    "expiry_year": 2022
  },
  "amount": 5000,
  "currency": "JPY"
}

Option 2: The value divided by 1000

With the below currencies, divide the value by 1000 to work out the value amount; for example, value = 1000 is the same as 1 Bahraini Dinar.

📘
Please note:
The last digit must always be a 0. For example, a value of 1310 would be processed, whereas 1312 will fail.

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

The example below shows a payment request for 50 Bahraini Dinars.

{
  "source": {
    "type": "card",
    "number": "4242424242424242",
    "expiry_month": 6,
    "expiry_year": 2022
  },
  "amount": 50000,
  "currency": "BHD"
}

Option 3: The value divided by 100

For all other currencies, divide the value by 100 to calculate the charge amount; for example, value = 100 is equivalent to 1 US Dollar.

🚧
For Chilean Peso (CLP) payments:
The last two digits must be 00. For example, a value of 500100 would be processed successfully whereas 500095 would not.

The following example is a payment request for 50.95 US Dollars.

{
  "source": {
    "type": "card",
    "number": "4242424242424242",
    "expiry_month": 6,
    "expiry_year": 2022
  },
  "amount": 5095,
  "currency": "USD"
}

Can we help?

Thanks for using Checkout.com. If you need any help or support, then message our support team at [email protected].