Menu
Sandbox Se connecter

Wave · Côte d'Ivoire · Bientôt

API Wave Côte d'Ivoire : bientôt disponible sur NguePay.

Wave rejoindra bientôt NguePay. Votre intégration actuelle (Orange Money et carte) l'acceptera sans changement de code : il suffira d'utiliser le moyen wave.

Wave n'est pas encore activé sur NguePay. Il arrive bientôt. Vous pouvez dès maintenant encaisser avec Orange Money et la carte bancaire : Wave s'ajoutera à la même intégration.

Être prévenu de l'ouverture Voir la documentation

Comment se passera un paiement Wave avec NguePay

  1. Votre serveur crée le paiement avec "provider": "wave", le montant en XOF et votre référence de commande.
  2. NguePay renvoie un checkout_url. Vous y redirigez votre client.
  3. Le client valide dans Wave. Sur téléphone, l'application Wave s'ouvre. Sur ordinateur, il scanne un QR code avec son téléphone.
  4. Vous recevez le webhook payment.succeeded, signé, et vous validez la commande.

Votre client n'a pas de carte à saisir ni de compte à créer chez vous : il utilise le portefeuille Wave qu'il a déjà sur son téléphone.

Exemple : créer un paiement Wave (dès l'ouverture)

● sandbox
curl -X POST https://api.sandbox.nguepay.com/api/v1/payments \
  -H "Authorization: Bearer sk_sandbox_…" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 15000,
    "provider": "wave",
    "reference": "CMD-1042",
    "description": "Commande CMD-1042"
  }'

La réponse contient l'identifiant de la transaction (uuid), son statut (pending) et le checkout_url. En production, seules l'adresse de l'API (api.live.nguepay.com) et la clé (sk_live_…) changent. Le détail est dans la documentation.

Ce que NguePay apportera à Wave

  • Une seule intégration pour tous les portefeuilles. Le même appel accepte déjà Orange Money et la carte bancaire ; Wave s'activera en changeant seulement le champ provider.
  • Des webhooks signés et rejoués. Chaque notification est signée (HMAC-SHA256) et renvoyée jusqu'à trois fois si votre serveur ne répond pas.
  • Un paiement payé une seule fois. Une même référence de commande ne peut pas être encaissée deux fois, même si votre serveur renvoie la requête.
  • Remboursements et virements Wave. Vous pourrez rembourser un client ou payer un partenaire vers son numéro Wave depuis l'API ou le dashboard.
  • Un tableau de bord unique pour suivre vos paiements Wave avec ceux des autres moyens de paiement.

Bon à savoir

  • Les montants sont en francs CFA (XOF), sans décimales, de 100 à 5 000 000 XOF par paiement.
  • Un paiement non validé à temps expire : son statut passe à failed avec le motif expired, et vous recevez un webhook payment.failed.
  • Votre client pourra payer avec n'importe quel compte Wave Côte d'Ivoire, quel que soit son opérateur téléphonique.

Questions fréquentes sur l'API Wave

Wave est-il disponible sur NguePay ?

Pas encore : Wave arrive bientôt. En attendant, vous pouvez encaisser avec Orange Money et la carte bancaire. Votre intégration acceptera Wave sans changement de code.

Comment accepterai-je Wave sur mon site e-commerce ?

Dès l'ouverture, vous appellerez POST /payments avec le moyen wave, redirigerez le client vers le checkout_url renvoyé et validerez la commande à la réception du webhook payment.succeeded.

Faudra-t-il un compte Wave Business pour utiliser NguePay ?

Non. NguePay encaissera les paiements Wave pour votre compte et vous reversera les fonds, après validation de votre dossier marchand (KYC).

Combien coûtera un paiement Wave avec NguePay ?

Le même tarif que les autres portefeuilles mobile money : 1,5 % + 100 XOF par paiement réussi sur l'offre Démarrage. Voir les tarifs.

Commencez avec Orange Money et la carte

Wave s'ajoutera à votre intégration dès son ouverture.

Créer un compte