Building a Local Checkout Experience for Cote d'Ivoire

// 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

• 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.

This guide is part of the Paystack by country guide.

Sign up for the McTaba newsletter