Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Senegal

How to on-ramp and off-ramp XOF in Senegal: mobile money, airtime, wave, KYC, limits and API examples.

countryIsoCode
currencyIsoCode
Status
Generated on

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.

Channel
paymentChannel
On-ramp
Off-ramp
On-ramp transfer type
carrierCode
Typical settlement

mobile_money

Yes

Yes

stk_push

sn_orange, sn_wave

—

airtime

No

Yes

—

sn_expresso, sn_orange

—

digital_wallet

Yes

Yes

redirect

sn_wave

—

Quirks

The carrier sn_wave exists, but every Senegalese offer that carries it is switched off. Take the carriers from carriers on the channel, not from the country.

XOF is shared by several countries. Always send countryIsoCode with currencyCode.

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.

Route
Min (XOF)
Max (XOF)
Min (USD)
Max (USD)

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.

Route
Level
Per order (USD)
Lifetime volume (USD)
Lifetime orders

On-ramp

advanced

$1 to any amount

over $1

—

The documents production accepts:

Level
Document
Fields to collect

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.

Fee id
Recipient
Routes

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)