Fees
What you're charged, when, and how fees show up in your balance and reports.
The platform charges a fee on deposits and withdrawals only - payment-link payments are deposits and every bulk payout is a withdrawal, so they are charged the same way, one transaction at a time. Refunds, KYC lookups, status checks, crypto trades and your own top-ups are free.
How a fee is worked out
Your fees are set per service on your account. GET /api/v1/configuration shows them for each
service you can use:
{ "serviceCode": "MOMO_WITHDRAWAL", "feePercent": 1, "feeFlat": 0, "feeMinimum": 100 }fee = max(amount × feePercent / 100 + feeFlat, feeMinimum) rounded to a whole XAFWith the settings above, a 2,000 XAF payout is charged 100 XAF (1% is 20, below the minimum) and a 50,000 XAF payout 500 XAF.
When you're charged
- Only when the transaction succeeds. A failed, expired or cancelled payment is never charged.
- The fee is taken from your balance automatically, at the moment the transaction settles, as a separate line - never netted out of the amount the customer pays or receives.
- A deposit credits the full amount and debits its fee: a 10,000 XAF deposit at 1.5% adds 9,850 XAF to your balance.
- A withdrawal debits the amount and its fee. While it is pending, both are held: a payout is
refused with
400 GW-400-BAD-REQUESTif your available balance can't cover the amount plus its fee, and the error says how much is needed. A bulk payout batch is checked against the total of its amounts and fees.
Every transaction's status (GET /api/v1/transactions/{orderId}) includes its fee.
Refunds give the fee back
When you refund a deposit, its fee is given back in proportion: refunding 4,000 of a 10,000 XAF deposit charged 150 XAF returns 60 XAF; refunding the rest returns the remaining 90. The refund itself is not charged. If a fee should be returned for any other reason, ask us - we can give it back from our side, and it shows in your ledger the same way.
In your balance and reports
Fees are their own ledger entries, so you can always tell them apart:
kind | What it is |
|---|---|
SETTLEMENT | The money the transaction moved. |
FEE | The platform's fee on it (a debit). |
FEE_REFUND | A fee given back (a credit). |
- The monthly statement (
GET /api/v1/ledger/statement) lists fees on their own lines and addstotalFeesfor the month; the dashboard's CSV has a Type column and a Fees this month line. - The dashboard's Reports page shows the fees part of each day or month.
- Ledger history (
GET /api/v1/ledger/history) carries thekindof each entry.
