Supported currencies

The currency is fixed at order creation and cannot be changed afterwards. It also determines which payment methods the customer is offered.

Currencies

NGN

Nigerian Naira

USD

US Dollar

NGN and USD are the currencies confirmed against the API. Support for additional currencies is account-dependent — contact Reeple to find out what is enabled for you, and always read otherPaymentOptions from the create-order response to see what a given currency actually offers.

Amount units

amount is a plain decimal number in the currency’s standard unit — not kobo, not cents.

You want to charge	Send
₦500.00	`"amount": 500`
₦10.50	`"amount": 10.5`
$10.00	`"amount": 10`

Sending 50000 when you meant ₦500.00 will charge the customer ₦50,000.00. There is no minor-unit conversion anywhere in this API.

Fees are added on top

The amount you send is what you receive; the fee is charged to the customer in addition. An NGN 500 order with a 30 fee charges 530 and settles 500 to you.

{
  "data": {
    "fee": 1.40,
    "amount": 100.0,
    "subsidiaryFee": 0.00,
    "customerFee": 1.40,
    "totalChargedAmount": 101.40,
    "paymentOption": "C"
  },
  "status": "success",
  "statusCode": "00",
  "message": "Operation successful"
}

subsidiaryFee is the portion charged to you, customerFee the portion charged to the customer. Use Get order fee to show the customer the real total before they commit.

Fees vary by currency and payment method. Quote the fee for the method the customer has actually selected, not a single figure for the whole order.

Get Started

Integration Guide

Help

Currencies

NGN

USD

Amount units

Fees are added on top

​Currencies

NGN

USD

​Amount units

​Fees are added on top

Currencies

Amount units

Fees are added on top