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

# Amounts, ids and lists

> The rules every endpoint follows.

## Amounts

Amounts are **whole numbers in the currency's smallest unit**, always with
an ISO 4217 currency code. Never send decimals.

| Currency | Smallest unit | 5 000 XAF / ₦1 500.50 is sent as |
| - | - | - |
| XAF | the franc (no smaller unit) | `{ "amount": 5000, "currency": "XAF" }` |
| NGN | the kobo (1/100 naira) | `{ "amount": 150050, "currency": "NGN" }` |

Every payment shows its `fee`, fixed when the payment is created:

* a payin's `net_amount` is what you keep: `amount` minus `fee`;
* a payout's `total_debited` is what leaves your balance: `amount` plus `fee`.

## Format

* JSON in and out, UTF-8.
* Field names in `snake_case`: `net_amount`, `created_at`.
* Times in ISO 8601, UTC: `2026-10-29T09:51:36.516Z`.
* `metadata`: up to 20 keys of your own (text up to 500 characters,
  numbers, true/false), returned as sent. Never put personal or secret
  data in it.

## Ids

Every object has an id with a prefix that says what it is:

| Prefix | Object |
| - | - |
| `mer_` | Your account |
| `pay_` | Payin |
| `po_` | Payout |
| `rcp_` | Payout recipient |
| `whk_` | Webhook endpoint |
| `evt_` | Event |
| `req_` | Request (in the `X-Request-Id` header) |

Quote the request id when you contact One Pay about a request: it leads
straight to it in our logs.

## Lists

Lists are newest first, a page at a time:

```json theme={null}
{ "data": [ ... ], "has_more": true }
```

* `limit`: how many per page, 1 to 100 (20 by default).
* `starting_after`: the id of the last item you have, for the next page.

```bash theme={null}
curl "https://onepay-api-eiy9.onrender.com/v1/payins?limit=50&starting_after=pay_ec9175c124d840169818b5cee976fc2b" \
  -H "Authorization: Bearer $ONEPAY_KEY"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.