Wave Business API setup commerçant Sénégal 2026

Wave Business = leader paiement mobile Sénégal/CI. API 2024+ permet intégration e-commerce, marketplace, SaaS. Voici setup complet commerçant Sénégal 2026.

TL;DR

- Wave Business : 50M+ users Sénégal/CI/Mali.

- Frais : 1 % transaction (vs 2-3 % cartes).

- API : checkout, QR, payouts B2B.

- KYC requis : 3-7 jours validation.

Inscription Wave Business

• Aller sur business.wave.com
• Créer compte commerçant :
• Nom entreprise + RCCM
• NINEA
• Pièce identité dirigeants
• Justificatif domicile
• KYC : validation 3-7 jours
• Activation compte business
• Génération clés API (sandbox + production)

Architecture intégration Wave

`

• Checkout flow :
• Site/app → Wave Checkout URL
• User redirige Wave (mobile app ou USSD)
• Validation paiement
• Callback webhook → ton serveur
• User redirige back ton site

• QR code paiement :
• Génère QR montant fixe
• Client scan via Wave app
• Confirme paiement
• Webhook validation

• Payouts B2B (versements) :
• Ton serveur → API Wave
• Validation destinataire
• Transfert immédiat
• Confirmation

`

Code Node.js intégration

`typescript

import axios from 'axios';

const WAVE_API = 'https://api.wave.com/v1';

const WAVE_TOKEN = process.env.WAVE_API_TOKEN!;

// 1. Créer session checkout

async function createCheckout({

amount, // FCFA integer

currency, // 'XOF'

successUrl,

errorUrl,

}: {

amount: number;

currency: 'XOF';

successUrl: string;

errorUrl: string;

}) {

const res = await axios.post(

${WAVE_API}/checkout/sessions,

{

amount: amount.toString(),

currency,

success_url: successUrl,

error_url: errorUrl,

// optionnel : restrict_payer_mobile, when_paid_redirect, etc.

},

{

headers: {

Authorization: Bearer ${WAVE_TOKEN},

'Content-Type': 'application/json',

},

}

);

return {

sessionId: res.data.id,

redirectUrl: res.data.wave_launch_url,

status: res.data.checkout_status, // 'open'

};

}

// 2. Webhook handler (ton serveur)

import express from 'express';

const app = express();

app.post('/webhooks/wave', express.json(), async (req, res) => {

const signature = req.headers['wave-signature'] as string;

// Vérifier signature HMAC

const valid = verifyWaveSignature(

req.rawBody,

signature,

process.env.WAVE_WEBHOOK_SECRET!

);

if (!valid) return res.status(401).end();

const event = req.body;

if (event.type === 'checkout.session.completed') {

const session = event.data;

// session.id, session.amount, session.transaction_id

await markOrderPaid({

orderId: session.client_reference,

waveTransactionId: session.transaction_id,

amount: session.amount,

});

}

res.status(200).json({ received: true });

});

// 3. Vérifier signature HMAC

import crypto from 'crypto';

function verifyWaveSignature(rawBody: string, signature: string, secret: string) {

const computed = crypto

.createHmac('sha256', secret)

.update(rawBody)

.digest('hex');

return crypto.timingSafeEqual(Buffer.from(computed), Buffer.from(signature));

}

`

Tarification 2026

Frais transaction :

• < 10K FCFA : 1.0 %
• 10K-100K : 1.0 %
• > 100K : 0.95 % négociable volume
• Min : 50 FCFA / transaction

Frais payouts B2B :

• Vers Wave user : 0 %
• Vers compte bancaire : 0.5-1 % + 250 FCFA

Conformité KYC

Documents requis :

• RCCM original
• NINEA
• CIN dirigeants (recto/verso)
• Justificatif domicile entreprise
• Photo dirigeant
• Statuts société

• Délai validation : 3-7 jours ouvrés
• Refus possible : informations incohérentes, secteur risqué

FAQ

Q : Sandbox disponible ?

R : Oui, environnement test gratuit. Cartes test fournies.

Q : Multi-devise ?

R : XOF (FCFA UEMOA) uniquement. EUR / USD pas supportés.

Conclusion

Wave Business API Sénégal 2026 = intégration moderne 1 % frais. KYC 3-7j + dev 2-5 jours. Stack standard e-commerce / marketplace Africa.