Get order fee

Returns the fee breakdown for an amount, currency and payment method. Fees are charged on top of the order amount, so call this before the customer commits if you want to show them the real total. You do not need an existing order to call this.

Endpoint

POST https://api-v4.reeple.ai/charge/order/fee

Authenticate with your public key. See Authentication.

Request body

Field	Type	Description
`data`	String	Required. The RSA-encrypted payload described below.

Payload (before encryption)

Field	Type	Description
`amount`	Number	Required. In the currency’s standard unit — see Amount units.
`currency`	String	Required. See Supported currencies.
`paymentoption`	String	Required. The method code — `C`, `BANK-TRANSFER` or `USSD`.

{
  "amount": 100,
  "paymentoption": "C",
  "currency": "NGN"
}

Request example

curl -X POST https://api-v4.reeple.ai/charge/order/fee \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_PUBLIC_KEY" \
  -d '{ "data": "YOUR_ENCRYPTED_PAYLOAD" }'

Response

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

Response fields

Field	Description
`amount`	The amount you asked about, unchanged.
`fee`	The total fee.
`subsidiaryFee`	The portion of the fee charged to you.
`customerFee`	The portion of the fee charged to the customer.
`totalChargedAmount`	What the customer’s card or account is debited: `amount` + `customerFee`.
`paymentOption`	Echoes the method you asked about.

Fees differ by method. Quote the fee for the option the customer has actually selected — re-call this endpoint when they switch between card and bank transfer.

subsidiaryFee + customerFee = fee. When subsidiaryFee is 0, the customer bears the whole fee; when customerFee is 0, you absorb it and totalChargedAmount equals amount.

Get Started

Orders

Payment Methods

Banks

Payment Links

Tokenized Charge

Verification

Refunds

Utility

Endpoint

Request body

Payload (before encryption)

Request example

Response

Response fields

​Endpoint

​Request body

​Payload (before encryption)

​Request example

​Response

​Response fields

Endpoint

Request body

Payload (before encryption)

Request example

Response

Response fields