Guides
API Reference

Our reference library for integrating with our API

FAQ

Find answers to our most frequently asked questions

Classic Docs

Documentation for our Classic API

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, amount = 100 is equal to 100 Japanese Yen.

Currency codeCurrency name
BIFBurundian Franc
CLFChilean Unidad de Fomentos
DJFDjiboutian Franc
GNFGuinean Franc
ISKIcelandic Krona
JPYJapanese Yen
KMFComoran Franc
KRWSouth Korean Won
PYGParaguayan Guarani
RWFRwandan Franc
UGXUgandan Shilling
VUVVanuatu Vatu
VNDVietnamese Dong
XAFCentral African Franc
XOFWest African CFA franc
XPFComptoirs Français du Pacifique

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 codeCurrency name
BHDBahraini Dinar
IQDIraqi Dinar
JODJordanian Dinar
KWDKuwaiti Dinar
LYDLibyan Dinar
OMROmani Rial
TNDTunisian 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"
}