Remboursement Wave et Orange Money : guide technique complet (mai 2026)

Aucun client n'apprécie d'attendre 5 jours pour récupérer 30 000 FCFA après une commande annulée. Aucun comptable n'apprécie de réconcilier des remboursements partiels mal tracés. Ce guide pose la procédure technique propre pour Wave et Orange Money au Sénégal.

TL;DR

- Wave : remboursement via Wave Business app ou API, instantané, frais 0 jusqu'à 7 jours, 1 % au-delà.

- OM : remboursement via dashboard partenaire, 24-72h, frais 0 sur reversement non encore effectué, sinon 2 %.

- Carte (PayDunya/CinetPay) : 5-7 jours, frais 0 si total, frais 100 FCFA + 0.5 % si partiel.

- Toujours tracer : table refunds séparée, lien avec PaymentEvent parent, audit log.

Wave Business : remboursement par API

L'API Wave Refund (lancée mi-2024) accepte un remboursement total ou partiel d'un paiement existant.

`ts

// lib/wave-refund.ts

async function refundWavePayment(paymentId: string, amountXof?: number, reason?: string) {

const res = await fetch(${WAVE_API}/v1/refunds, {

method: 'POST',

headers: {

'Authorization': Bearer ${WAVE_API_KEY},

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

'Idempotency-Key': refund_${paymentId}_${amountXof ?? 'full'},

},

body: JSON.stringify({

payment_id: paymentId,

amount: amountXof, // omit pour remboursement total

currency: 'XOF',

reason: reason ?? 'merchant_initiated',

}),

});

if (!res.ok) throw new Error(Wave refund failed: ${res.status} ${await res.text()});

return res.json(); // { refund_id, status, refunded_at }

}

`

Idempotence obligatoire : envoyer 2x la même demande sans clé d'idempotence rembourse 2x. La clé refund_${paymentId}_${amount} rend l'opération sûre.

Orange Money : pas d'API publique de refund

OM Sénégal ne propose pas d'API de remboursement programmatique grand public en mai 2026. Procédure :

• Connexion dashboard partenaire OM (web)
• Recherche transaction par référence ou numéro
• Action "Annuler / Rembourser"
• Saisie OTP envoyé sur le numéro signataire
• Confirmation → délai 24-72h pour le client

Workaround pour automatiser : webhook trigger d'un job qui notifie un agent humain, et un journal des remboursements à effectuer. Pas idéal mais réaliste.

Trace comptable : le modèle Refund

`prisma

model Refund {

id String @id @default(cuid())

externalId String? @unique // ID provider quand dispo

paymentEventId String

paymentEvent PaymentEvent @relation(fields: [paymentEventId], references: [id])

orderId String

amount Int // XOF entier

currency String

reason String // dispute | customer_request | duplicate | merchant_error

status String // requested | processing | completed | failed

initiatedBy String // user.id ou "system"

notes String?

createdAt DateTime @default(now())

completedAt DateTime?

@@index([orderId])

@@index([status])

}

`

Workflow de remboursement type

`

[Demande client]

↓

[Validation manager (>50K FCFA)]

↓

[Création Refund.status = "requested"]

↓

[Tentative API provider]

/ \

[OK] [Échec]

↓ ↓

[completed] [failed → alerte humain]

↓

[Notification client (WhatsApp + email)]

↓

[Audit log]

`

Frais et délais réels

Gestion des disputes (chargebacks)

Pour les paiements carte uniquement (Wave/OM ne supportent pas le chargeback bancaire) :

• Notification PayDunya/Stripe → webhook dispute.created
• Délai pour répondre : 7 à 14 jours selon réseau (Visa/Mastercard)
• Soumettre les preuves : capture écran commande, proof of delivery, IP du client, logs
• Décision : 30-90 jours

Conseil : automatisez la collecte des preuves dès la commande (IP, user-agent, signature de livraison). Faire la collecte au moment de la dispute = trop tard.

FAQ

Q : Peut-on rembourser un paiement Wave après 90 jours ?

R : Oui via l'API jusqu'à 180 jours. Au-delà, virement bancaire manuel.

Q : Le client doit-il avoir le même compte OM pour recevoir le remboursement ?

R : Oui, OM rembourse sur le compte source. Si le numéro est désactivé, le remboursement reste en attente. Solution : virement bancaire compensatoire.

Q : Comment éviter les abus de remboursement ?

R : Règles de scoring : nb de remboursements demandés / mois, ratio remboursé/total commandé, ancienneté compte client. Bloquer auto si > 3 dans le mois.

Conclusion

Le remboursement est un sujet sous-investi par 90 % des PME e-commerce sénégalaises. Le faire bien renforce la confiance, raccourcit le service client, et protège votre comptabilité. Quelques heures d'investissement initial = nombreuses heures économisées chaque mois.