Senegal
Split a payment between parties in Senegal
Yes, for collecting. Split a payment between parties works in Senegal on Wave, Orange Money, Free Money, settling in XOF. Paying out to a Senegal wallet is not live yet, so money leaves by wire to a bank account instead, which works from any country.
What this looks like in Senegal
3
networks a payer can use
XOF
whole units, no cents
Wave
provider code for Wave
The call
Amounts in XOF are whole units, not cents, which is the thing most integrations get wrong here.
curl https://api.ultraner.com/v1/payments/express/mno \
-H "X-API-Key: $ULTRANER_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-d provider="Wave" \
-d account_number="221000000000" \
-d currency="XOF" \
-d amount=50005,000 means 5,000 XOF. The payer confirms on their handset, so the result arrives by webhook rather than in this response.
What this is built on
Onboard your own sellers, take a cut, and pay out the rest.
Refunding a split payment reverses the platform fee too. If the money has already been withdrawn the balance can go below zero, and it has to be topped up before any further payout.
Charge a mobile money wallet, card, bank account or PayPal.
Move your balance to your own bank account by wire.
Common questions
- How do I take a commission and pay the rest to a seller?
- Yes, for collecting. Split a payment between parties works in Senegal on Wave, Orange Money, Free Money, settling in XOF. Paying out to a Senegal wallet is not live yet, so money leaves by wire to a bank account instead, which works from any country.
- Which networks can I charge in Senegal?
- Wave, Orange Money and Free Money. All of them behind one integration; the provider code you send picks the rail.
- How do I write the amount for XOF?
- XOF has no minor unit. Send whole numbers: 5000 means 5000 XOF, not 50.00. There are no cents to divide by.
- Can I pay out to a Senegal mobile money wallet?
- Not yet. Disbursement is live in Tanzania and the other markets are being brought up one verified rail at a time. Settling your balance to your own bank account by wire works from Senegal today, as it does everywhere.
- Anything to know about split payouts (streamline)?
- Refunding a split payment reverses the platform fee too. If the money has already been withdrawn the balance can go below zero, and it has to be topped up before any further payout.