Accepter Wave & Orange Money sur un site e-commerce au Sénégal

Le e-commerce africain connaît une croissance exponentielle. Mais un obstacle majeur freine encore beaucoup de boutiques en ligne : l'absence de moyens de paiement locaux. Pas de carte bancaire internationale ? Pas d'achat. Intégrer Wave et Orange Money change la donne en ouvrant votre boutique à 90% de la population.

Option 1 : Plugin WooCommerce Paydeck

Si votre boutique tourne sur WooCommerce (WordPress), c'est la solution la plus rapide. Le plugin Paydeck pour WooCommerce s'installe en quelques minutes et ajoute Wave et Orange Money comme moyens de paiement natifs.

Téléchargez le plugin depuis votre dashboard Paydeck → section Intégrations
Dans WordPress : Extensions → Ajouter → Téléverser le fichier ZIP
Activez le plugin et allez dans WooCommerce → Réglages → Paiements
Activez 'Paydeck — Wave & Orange Money' et saisissez votre clé API
Activez les providers Wave et/ou Orange Money depuis votre dashboard Paydeck
Testez en mode sandbox avant de passer en production

✅ Le plugin WooCommerce Paydeck gère automatiquement les webhooks, la mise à jour des statuts de commande (En attente → Traitement → Complétée) et les remboursements.

Option 2 : Module PrestaShop

Paydeck propose un module PrestaShop compatible PrestaShop 1.7 et 8.x. Le module ajoute Wave et Orange Money à votre tunnel de commande standard, avec support des devises FCFA.

Option 3 : Intégration API (boutique custom)

Pour les boutiques développées sur mesure (Laravel, Next.js, Django, etc.), l'intégration se fait en 3 étapes via l'API Paydeck.

javascript

// 1. Créer le paiement lors du checkout
app.post('/checkout/pay', async (req, res) => {
  const { orderId, amount, provider, phone, otp } = req.body

  const payment = await paydeck.payments.collect({
    amount,
    currency: 'XOF',
    provider,         // 'wave_sn' ou 'orange_money_sn'
    phone,
    otp,              // Uniquement pour Orange Money
    reference: `order_${orderId}`,
    callbackUrl: `https://monsite.sn/webhook/paydeck`,
    successUrl: `https://monsite.sn/commande/${orderId}/confirmation`,
  })

  if (payment.paymentUrl) {
    // Wave → rediriger vers le lien
    res.json({ redirect: payment.paymentUrl })
  } else if (payment.status === 'success') {
    // Orange Money → confirmation immédiate
    await updateOrder(orderId, 'paid')
    res.json({ success: true })
  }
})

Gérer les abandons de panier

Un client qui clique sur 'Payer avec Wave' et ne finalise pas doit pouvoir réessayer sans problème. Côté commande, gardez un état 'pending_payment' jusqu'à réception du webhook de succès. Paydeck vous notifie aussi en cas d'expiration de session.

Afficher les bons providers selon le pays du client

Si vous vendez dans plusieurs pays d'Afrique de l'Ouest, l'API Paydeck GET /checkout/providers retourne automatiquement les providers disponibles filtrés par pays. Adaptez votre UI dynamiquement plutôt que d'afficher des options non disponibles.

⚠️ Important : Ne confirmez jamais une commande basée uniquement sur une redirection vers success_url. Attendez toujours le webhook Paydeck signé — c'est la seule confirmation fiable.

E-commerce au Sénégal : comment accepter Wave et Orange Money sur votre boutique en ligne