MobileWalletPartner Gateway Docs

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 XAF

With 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-REQUEST if 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:

kindWhat it is
SETTLEMENTThe money the transaction moved.
FEEThe platform's fee on it (a debit).
FEE_REFUNDA fee given back (a credit).
  • The monthly statement (GET /api/v1/ledger/statement) lists fees on their own lines and adds totalFees for 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 the kind of each entry.