Paystack in Cote d'Ivoire: Complete Developer Guide

Cote d'Ivoire is the largest economy in the UEMOA (West African Economic and Monetary Union) zone, with Abidjan serving as the commercial capital. The country uses the CFA Franc (XOF), a currency shared with Senegal, Mali, Burkina Faso, Benin, Niger, Togo, and Guinea-Bissau. This shared currency creates opportunities for cross-border commerce within the zone.

Key characteristics:

• Mobile money is the primary payment method. Orange Money leads the market, followed by MTN Mobile Money and Moov Money (now part of Moov Africa). Mobile money adoption in Cote d'Ivoire is among the highest in West Africa.
• French is the business language. All customer-facing communications, checkout UIs, and error messages should be in French. English-only checkout pages will lose conversions.
• The CFA Franc (XOF) is pegged to the Euro at a fixed rate (1 EUR = 655.957 XOF). This peg provides currency stability and makes the XOF predictable for businesses dealing with European partners.
• Card penetration is limited. Visa and Mastercard are available but used primarily by urban professionals and the business community. The vast majority of consumer payments happen through mobile money.
• Regulatory oversight is through the BCEAO (Banque Centrale des Etats de l'Afrique de l'Ouest), which regulates payment services across all UEMOA member states.

Paystack expanding into Cote d'Ivoire signals its commitment to Francophone Africa. For developers, it means building payment flows that work with XOF, French-language UIs, and a mobile money-first customer base.

Setting up Paystack for an Ivorian business follows the standard Paystack flow with country-specific verification.

Step 1: Create your account

Sign up at paystack.com and select Cote d'Ivoire. Test mode is immediately available.

Step 2: Business verification

To go live, provide your RCCM (Registre du Commerce et du Credit Mobilier) registration, tax identification documents from the DGI (Direction Generale des Impots), a government-issued ID of the business director, and your Ivorian bank account details for settlement.

Step 3: Initialize a transaction

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: 'client@example.ci',
    amount: 1000000, // Check Paystack docs for XOF amount handling
    currency: 'XOF',
    reference: 'ci_commande_' + Date.now(),
    callback_url: 'https://votresite.ci/paiement/callback',
  }),
});

var data = await response.json();
// Redirect to data.data.authorization_url

Always pass currency: 'XOF' explicitly. Verify how XOF amounts are handled in Paystack's API, as the CFA Franc does not use subunits in practice.

For full onboarding requirements, see Paystack onboarding and compliance in Cote d'Ivoire.

Mobile Money (Orange Money, MTN Mobile Money, Moov Money)

Mobile money is the channel you should build around. Orange Money has the largest user base in Cote d'Ivoire. The customer selects their provider, enters their phone number, and receives a USSD prompt to authorize the payment with their PIN. The flow is the same across providers, though the USSD menu experience differs slightly.

Cards (Visa, Mastercard)

Card payments serve customers with bank-issued cards. Card penetration is growing but remains secondary to mobile money for consumer transactions. Cards are more relevant for B2B payments and transactions involving international customers.

// Mobile money first for Ivorian market
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: 'client@example.ci',
    amount: 500000,
    currency: 'XOF',
    channels: ['mobile_money', 'card'],
    reference: 'ci_' + Date.now(),
  }),
});

For details on each channel, see payment methods available on Paystack in Cote d'Ivoire.

The CFA Franc (XOF) does not use subunits in everyday commerce. Prices are quoted in whole francs: 5,000 XOF, 10,000 XOF, 250,000 XOF. There are no "centimes" in practical use.

This affects your integration in two ways:

• Amount handling in the API. Check Paystack documentation for whether XOF amounts should be passed in francs directly or in a subunit. Different currencies on Paystack can have different smallest-unit rules.
• Display formatting. Ivorian customers expect to see prices as whole numbers: "5 000 FCFA" or "5 000 XOF". Note the space as a thousands separator (French formatting convention) rather than a comma.

The Euro peg (1 EUR = 655.957 XOF) means you can calculate XOF equivalents for Euro-denominated products with stable precision. This is useful if you are pricing against European SaaS products or international services:

// Convert EUR to XOF (fixed rate)
function eurToXof(eur) {
  return Math.round(eur * 655.957);
}

// Examples
eurToXof(10);   // 6560 XOF
eurToXof(50);   // 32798 XOF
eurToXof(100);  // 65596 XOF

Always verify transaction amounts after payment completion, regardless of currency:

var verifyData = await verifyTransaction(reference);

if (verifyData.data.status === 'success') {
  if (verifyData.data.currency !== 'XOF') {
    console.error('Unexpected currency');
    return;
  }
  // Verify amount matches expected value
  // Grant value
}

Cote d'Ivoire is a Francophone country. Your payment experience should reflect this.

Checkout localization:

• Button text: "Payer maintenant" instead of "Pay now"
• Loading state: "Traitement en cours..." instead of "Processing..."
• Success message: "Paiement reussi" instead of "Payment successful"
• Error messages in French with clear instructions

Number and currency formatting:

• Use a space as thousands separator: 10 000 FCFA (not 10,000)
• Use a comma for decimal separator if needed: 1 499,50 (not 1,499.50)
• Currency symbol placement: "5 000 FCFA" or "5 000 F CFA" (symbol comes after the number)

Date formatting:

• Use DD/MM/YYYY format: 22/07/2026 (not 07/22/2026)
• Month names in French: janvier, fevrier, mars, avril, mai, juin, juillet, aout, septembre, octobre, novembre, decembre

If your product serves multiple African markets, implement a localization system that switches between English and French based on the customer's market. Do not serve an English checkout to Ivorian customers and expect good conversion rates.

Mobile money in Cote d'Ivoire works through USSD authorization, similar to other African markets but with provider-specific details.

Orange Money: The largest mobile money provider. Customers authorize via USSD after entering their Orange phone number. The USSD menus are in French.

MTN Mobile Money: The second largest provider. Same USSD-based authorization flow. MTN numbers in Cote d'Ivoire have specific prefixes.

Moov Money: Moov Africa (formerly Moov) operates in several West African countries. Authorization via USSD on Moov numbers.

Engineering considerations:

• Phone number format: Ivorian numbers follow the format +225 XX XX XX XX XX (10 digits after the country code). Normalize phone numbers before sending to Paystack.
• USSD authorization takes time. The customer switches to their dialer, enters the USSD code, navigates French-language menus, and enters their PIN. This can take 30 to 60 seconds. Do not timeout prematurely.
• Error messages in French. When a mobile money payment fails (insufficient balance, wrong PIN, account issues), present the error to the customer in French.
• Multiple provider testing. Test with Orange Money, MTN MoMo, and Moov Money to ensure your checkout works with all three providers.

Your webhook handler processes mobile money payments the same way as other markets, but log the provider information for analytics:

if (event.event === 'charge.success' && event.data.channel === 'mobile_money') {
  var provider = event.data.authorization.bank;
  var phone = event.data.authorization.mobile_money_number;
  console.log('Mobile money payment via ' + provider + ' from ' + phone);
  // Process payment
}

Settlement: Paystack settles to your registered Ivorian bank account in XOF. The settlement schedule is market-specific. Check your Paystack dashboard for your settlement timeline. Fees are deducted before settlement.

BCEAO compliance: The BCEAO regulates payment services across the UEMOA zone. Key compliance considerations:

• Electronic money issuers and payment service providers must be licensed
• KYC requirements apply for merchant onboarding
• Transaction reporting obligations may apply depending on your volume
• Cross-border payment regulations within the UEMOA zone

For detailed settlement information, see settlement and payouts on Paystack in Cote d'Ivoire.

Cote d'Ivoire opens the door to Francophone West Africa, a region of over 100 million people sharing the CFA Franc. Building payment systems that work here means understanding mobile money flows, French localization, and the UEMOA regulatory framework.

The McTaba bootcamp teaches payment integration across African markets. Learn to build systems that handle multiple currencies, languages, and compliance requirements.

Create a free McTaba account