Fees
One price per rail and per operation, operator fees included, published by GET /v1/rails.
221 Pay charges one price per rail and per operation type. This price includes the operator's fees: nothing is added on top.
Senegal
Wave and Orange Money (sn_wave, sn_orange): 2% of the amount, for
every operation.
| Operation | Rate | Example on 10,000 CFA francs |
|---|---|---|
| Collection | 2% | 200 CFA francs |
| Payout | 2% | 200 CFA francs |
| Refund | 2% | 200 CFA francs |
A payout to a bank account follows a tiered scale, described below.
Payout to a bank account
The rate of the tier that contains the amount applies to the whole amount. The transfer arrives in 3 to 5 business days.
| Payout amount | Rate | Example |
|---|---|---|
| 200,000 to 499,999 CFA francs | 5% | 15,000 CFA francs on 300,000 CFA francs |
| 500,000 to 999,999 CFA francs | 4% | 24,000 CFA francs on 600,000 CFA francs |
| 1,000,000 to 2,499,999 CFA francs | 3% | 45,000 CFA francs on 1,500,000 CFA francs |
| 2,500,000 to 5,000,000 CFA francs | 2.5% | 75,000 CFA francs on 3,000,000 CFA francs |
GET /v1/fees publishes these tiers in bank_tiers (from, to, bps), along with bank_min, bank_max and bank_monthly_cap.
| Limit | Value |
|---|---|
| Minimum per payout | 200,000 CFA francs |
| Maximum per payout | 5,000,000 CFA francs |
| Total per month | 10,000,000 CFA francs |
Details, errors and a request example: Payouts.
Other countries
Each rail's rates are published by GET /v1/rails, a public route:
curl "$API_URL/v1/rails"In each item of data, the fees object gives:
| Field | Description |
|---|---|
collection_bps | Collection rate, in basis points. |
withdrawal_bps | Payout rate, in basis points. |
refund_bps | Refund rate, in basis points. |
example_10000 | Fees computed for 10,000 CFA francs: amount, collection_fee, withdrawal_fee, refund_fee. |
One basis point is 0.01%: 200 bps = 2%.
Calculation and rounding
Fee = amount × rate ÷ 10,000, rounded to the nearest franc (a half rounds up). XOF has no subunit.
Where fees show
| Operation | When | Fields |
|---|---|---|
| Collection | On payment confirmation. | fee, net (credited amount) = amount − fee. |
| Payout | In the quote, before any movement. | fee, net (amount received by the number or bank account). |
| Refund | In the quote, before any movement. | fee, customer_receives, merchant_debited, depending on fee_payer. |
The quote is binding: the amount shown is the one applied during its 2 minutes of validity.
Who pays
- Collection: the merchant. The customer pays
amount; the merchant receivesnet. - Payout: the merchant. The payout number or bank account receives
net. - Refund:
merchantorcustomer, as chosen. See Refunds.
The dashboard shows each payment's fees, and the fees of a payout or refund before confirmation.