Wariguai pour Node.js

Bibliothèque officielle de l'API de paiement Wariguai : encaisse Orange Money, Moov Money, Telecel Money, Wave… depuis ton site ou ton appli Node.js. Sans aucune dépendance, Node.js 18 ou plus récent.

npm install wariguai
npx wariguai init

npx wariguai init vérifie ta clé secrète, l'enregistre dans .env (ajouté à .gitignore) et crée wariguai-exemple.js, un petit serveur prêt à lancer avec le paiement, la page de retour et le webhook.

Encaisser un paiement

const Wariguai = require('wariguai'); // ou : import Wariguai from 'wariguai';
const wariguai = new Wariguai(process.env.WARIGUAI_SECRET_KEY);

// 1. Créer le paiement et envoyer le client sur la page de paiement Wariguai
const paiement = await wariguai.payments.create({
  amount: 5000,
  reference: 'CMD-1001',
  return_url: 'https://maboutique.bf/merci',
});
res.redirect(paiement.checkout_url);

// 2. Au retour du client : vérifier que c'est payé
const paye = await wariguai.payments.isPaid(req.query.payment_id);

Recevoir le webhook

app.post('/webhooks/wariguai', express.raw({ type: 'application/json' }), (req, res) => {
  const evenement = wariguai.webhooks.verify(req.body, req.headers['wariguai-signature'], process.env.WARIGUAI_WEBHOOK_SECRET);
  if (evenement.type === 'payment.succeeded') {
    // commande evenement.data.reference payée
  }
  res.sendStatus(200);
});

Liens de paiement

const lien = await wariguai.links.create({ title: 'Robe wax', amount: 5000 });
console.log(lien.url, lien.qr_url, lien.poster_url);

Toutes les fonctions

| Ressource | Fonctions | | --- | --- | | payments | create, retrieve, list, cancel, isPaid, simulate (mode test) | | links | create, retrieve, list, disable, enable | | payouts | create, retrieve, list | | balance | retrieve | | channels | list | | webhooks | verify |

Les erreurs sont des WariguaiError avec status (code HTTP) et code (ex. invalid_amount). Les types TypeScript sont inclus.

Commande wariguai

| Commande | Ce qu'elle fait | | --- | --- | | npx wariguai init | Vérifie la clé, l'enregistre dans .env, crée l'exemple | | npx wariguai test | Paiement de test de bout en bout (clé sk_test_) | | npx wariguai solde | Solde du compte | | npx wariguai lien --titre "Robe wax" --montant 5000 | Crée un lien de paiement |

Documentation complète : https://wariguai.mikpilot.com/docs