> ## Documentation Index
> Fetch the complete documentation index at: https://docs-v2.reeple.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Supported currencies

> Currencies you can create orders in, and how amounts are expressed

The currency is fixed at [order creation](/api-reference/orders/create-order) and cannot be
changed afterwards. It also determines which payment methods the customer is offered.

## Currencies

<CardGroup cols={3}>
  <Card title="NGN" icon="naira-sign">Nigerian Naira</Card>
  <Card title="USD" icon="dollar-sign">US Dollar</Card>
</CardGroup>

<Note>
  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.
</Note>

## 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`   |

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

## 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.

```json theme={null}
{
  "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](/api-reference/orders/get-order-fee) to show the customer the
real total before they commit.

<Tip>
  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.
</Tip>
