Calculating the amount

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

The amount field in a payment 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:

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

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"
}

With the below currencies, divide the amount by 1000 to work out the value amount. For example, amount = 1000 is the same as 1 Bahraini 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"
}

For all other currencies, divide the amount by 100 to calculate the payment request amount. For example, amount = 100 is equivalent to 1 US Dollar.

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"
}