Building a Local Checkout Experience for Cote d'Ivoire
For a Côte d'Ivoire-optimised Paystack checkout: (1) enable channels: ["mobile_money", "card"] — Orange Money and MTN MoMo first; (2) set currency: "XOF" (CFA franc used across francophone West Africa); (3) XOF amounts go to Paystack multiplied by 1 (XOF has no decimal subdivision in practice); (4) include the customer phone number (05/07/01 numbers for Orange, 05 numbers for MTN CI); (5) French-language checkout text improves conversion with Ivorian customers.
Côte d'Ivoire-Optimised Checkout Configuration
// Côte d'Ivoire-optimised transaction initialization
var response = await fetch('https://api.paystack.co/transaction/initialize', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + process.env.PAYSTACK_SECRET_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
email: customer.email,
phone: customer.phone, // e.g., '0712345678' (Orange) or '0512345678' (MTN)
amount: Math.round(orderAmountXOF), // XOF — no decimal subdivision
currency: 'XOF',
reference: generateReference(),
channels: ['mobile_money', 'card'],
metadata: {
order_id: order.id,
},
}),
});Mobile money operators in Côte d'Ivoire on Paystack:
- Orange Money CI — 07/05/01 numbers (Orange Côte d'Ivoire)
- MTN MoMo CI — 05/07 numbers (MTN Côte d'Ivoire)
- Wave — growing digital wallet, popular with younger urban customers
Localisation Tips for Ivorian Users
- Language: French is the official language of Côte d'Ivoire. Translate your checkout UI to French for maximum conversion. Paystack's popup supports multiple languages.
- Currency display: Show as "5 000 FCFA" or "XOF 5,000" — use the "FCFA" suffix which is widely understood in francophone West Africa.
- Currency note: XOF is technically divided into centimes but amounts below 1 XOF are not used in practice. Pass whole numbers.
- Phone number format: Ivorian numbers are 10 digits (07 XX XX XX XX). International format is +225 07 XX XX XX XX.
Learn More
This guide is part of the Paystack by country guide.
Key Takeaways
- ✓Orange Money and MTN MoMo CI are the dominant payment methods in Côte d'Ivoire — enable mobile_money channel.
- ✓XOF (CFA franc) is the currency — used across 8 francophone West African countries including Côte d'Ivoire.
- ✓XOF does not have a sub-unit in common use — pass the amount as-is to Paystack (no kobo conversion needed for XOF).
- ✓Include the customer phone number for mobile money routing.
- ✓French-language localisation significantly improves checkout conversion for Ivorian customers.
- ✓Paystack operates in Côte d'Ivoire under BCEAO (Central Bank of West African States) oversight.
Frequently Asked Questions
- Does Paystack support Orange Money in Côte d'Ivoire?
- Yes. Paystack supports Orange Money CI and MTN MoMo CI via the mobile_money channel. The customer's phone number determines which operator is used. Côte d'Ivoire is a supported Paystack market.
- Is XOF different from CFA franc used in Central Africa?
- Yes. There are two CFA franc currencies: XOF (West African CFA franc, used in Côte d'Ivoire, Senegal, Mali, Burkina Faso, and others) and XAF (Central African CFA franc). Both are pegged to the euro at the same rate but are separate currencies and not interchangeable. Paystack uses XOF for Côte d'Ivoire.
- Can I use the same Paystack account for multiple francophone West African countries?
- Paystack accounts are country-specific — your Côte d'Ivoire account processes XOF transactions and settles to an Ivorian bank account. To serve multiple countries, you would typically use separate Paystack accounts per country, each configured for the local currency and banking details.
- What is Wave and does Paystack support it in Côte d'Ivoire?
- Wave is a digital financial services app popular in Côte d'Ivoire and Senegal. It offers low-fee mobile money transfers. Paystack's current mobile_money channel in Côte d'Ivoire primarily covers Orange Money and MTN MoMo CI. Wave integration may be available — check the latest Paystack documentation for Côte d'Ivoire channel support.
Ready to build real-world apps?
Join the McTaba Labs full-stack marathon (4 months full-time · 6 months part-time). Learn M-Pesa, USSD, and WhatsApp engineering while shipping 8 production apps.
Apply to the McTaba Marathon