Settlement and Payouts on Paystack in Cote d'Ivoire
Paystack CI settles XOF to your registered Ivorian bank account on T+1 or T+2. To send XOF payouts, create transfer recipients via POST /transferrecipient with currency: "XOF". XOF amounts are passed as whole numbers (no decimal subdivision in practice). Use GET /bank?currency=XOF to get supported Ivorian bank codes. Ecobank CI, SGBCI, BICICI, and Banque Atlantique CI are common settlement banks.
XOF Settlement Timeline
Paystack CI settles XOF to your Ivorian bank account 1-2 business days after the transaction. Banks supported for settlement: Ecobank Côte d'Ivoire, SGBCI (Société Générale), BICICI (BNP Paribas), Banque Atlantique, NSIA Banque, Coris Bank CI.
Settlement operates within the WAEMU STAR-UEMOA interbank settlement system managed by BCEAO. This system covers all 8 WAEMU member countries, enabling interbank transfers across the union in XOF.
Sending XOF Payouts to Ivorian Bank Accounts
// Create an XOF bank account recipient for Côte d'Ivoire
async function createXOFRecipient(name, accountNumber, bankCode) {
var res = await fetch('https://api.paystack.co/transferrecipient', {
method: 'POST',
headers: { Authorization: 'Bearer ' + process.env.PAYSTACK_SECRET_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({
type: 'nuban', // Check Paystack docs for CI-specific type
name,
account_number: accountNumber,
bank_code: bankCode,
currency: 'XOF',
}),
});
var data = await res.json();
return data.data.recipient_code;
}
// Send XOF payout
async function sendXOFPayout(recipientCode, amountXOF, reason) {
var res = await fetch('https://api.paystack.co/transfer', {
method: 'POST',
headers: { Authorization: 'Bearer ' + process.env.PAYSTACK_SECRET_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({
source: 'balance',
amount: amountXOF, // XOF — pass as whole number
recipient: recipientCode,
reason,
currency: 'XOF',
}),
});
return res.json();
}
Learn More
This guide is part of the Paystack by country guide.
Key Takeaways
- ✓Paystack CI settles XOF to your Ivorian bank account T+1 or T+2.
- ✓XOF amounts in the transfer API are passed as whole numbers (no pesewa/kobo equivalent in common use).
- ✓BCEAO (Central Bank of West African States) governs the interbank settlement infrastructure across WAEMU countries.
- ✓Create transfer recipients with currency: "XOF" and Ivorian bank codes.
- ✓Orange Money CI payouts may be supported — check GET /bank?currency=XOF for mobile money recipient options.
- ✓The XOF is shared across 8 francophone West African countries and pegged to the euro — stable currency for planning.
Frequently Asked Questions
- Can I send Orange Money payouts in Côte d'Ivoire via Paystack?
- Orange Money CI payout support via the Paystack Transfer API may be available — check GET /bank?currency=XOF or the latest Paystack documentation for Côte d'Ivoire to see mobile money recipient types. Orange Money is the dominant mobile money operator in CI and payout support is a key developer request.
- Is XOF the same as the CFA franc used elsewhere?
- XOF is the West African CFA franc, distinct from XAF (Central African CFA franc). Both are called "CFA franc" and pegged to the euro at the same rate, but they are separate currencies issued by different central banks and used in different regions. Paystack CI uses XOF.
- Does Paystack support transfers across WAEMU countries (e.g., from Côte d'Ivoire to Senegal)?
- Paystack is country-specific — your CI Paystack account settles to CI and your Transfer API creates recipients for CI banks. For cross-border WAEMU transfers (CI to Senegal, for example), you would need separate Paystack accounts per country or use the BCEAO's interbank infrastructure via your bank's international transfer service.
- Why is my XOF settlement delayed?
- Common causes: Ivorian public holiday (CI has several official holidays), bank-side processing delay, unverified settlement account, or a compliance hold. The BCEAO interbank system can slow cross-institution transfers. Check your Paystack dashboard and contact Paystack CI support if settlement is more than 3 business days late.
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