Senegal
How to on-ramp and off-ramp XOF in Senegal: mobile money, airtime, wave, KYC, limits and API examples.
SN
XOF
Beta
2026-10-09
Start with Countries: it has the keys, the signing helpers, the order statuses and the retry rules that every country page uses. To take payments without the API, open the Pay Widget with countryIsoCode=SN, see URL params.
Payment channels
Each channel has its own page with the walkthrough. Open a channel:
On-ramp means the user pays local currency and gets crypto. Off-ramp means the user pays crypto and gets local currency.
Quirks
Verify the user
Before the first order, read the user's KYC state. requiredKycType says which level the user must pass, and kycDocuments lists the documents to submit. Without the order amounts in the request it answers for the user's past orders only, so send them when you have a quote: see Get user KYC state. The rules for Senegal are in the reference.
Reference (production, 2026-10-09)
Limits
Per order, for a merchant on the default limits, with CELO_USDT on the crypto leg. Another asset, another carrier or your own account limits can change them: Get order limits answers for your request.
On-ramp, Mobile money (sn_orange)
647
323,241
1
500
Off-ramp, Mobile money (sn_orange)
583
200,000
1
343.33
Off-ramp, Airtime (sn_expresso)
2,000
25,000
3.95
49.35
On-ramp, Wave (sn_wave)
632
315,581
1
500
Off-ramp, Wave (sn_wave)
568
25,252
1
44.46
KYC rules
Off-ramp KYC is off in Senegal. A rule fires when one order falls in its per-order range, or when the user's lifetime successful orders pass its allowance. When several rules fire, the higher level wins. See KYC.
On-ramp
advanced
$1 to any amount
over $1
—
The documents production accepts:
advanced
Driving License
first_name, last_name, dob, images
advanced
National IDs, Consular IDs & Diplomat IDs
first_name, last_name, dob, images
advanced
Passports
first_name, last_name, dob, images
Fees
Every quote lists its fees in cashout.feeSettings and charges them in cashout.chargedFees. The amounts depend on your account, so this page names the fees and not their values. When your account sets a fee of its own, the quote also lists a merchant_fee that goes to merchant.
service_fee
platform
On-ramp, Mobile money (sn_orange); Off-ramp, Mobile money (sn_orange); Off-ramp, Airtime (sn_expresso); On-ramp, Wave (sn_wave); Off-ramp, Wave (sn_wave)
gas
blockchain
On-ramp, Mobile money (sn_orange); On-ramp, Wave (sn_wave)

