Branchez YiriwaPay à votre boutique ou à votre code

Vos clients choisissent « Mobile Money » au moment de payer et règlent sur la page sécurisée de YiriwaPay. La commande n'est marquée « payée » qu'après avoir relu le paiement chez YiriwaPay et contrôlé le statut, le montant et la référence : le simple retour du client sur votre site ne suffit jamais.

Installation

1. 1Dans WordPress : Extensions → Ajouter → Téléverser une extension, choisissez le fichier téléchargé, puis activez-le (WooCommerce doit être installé).
2. 2Ouvrez WooCommerce → Réglages → Paiements → YiriwaPay et renseignez l'adresse de YiriwaPay (https://yiriwapay.com), votre clé secrète (sk_test_… pour essayer) et le secret des notifications (whsec_…).
3. 3Dans YiriwaPay, onglet Développeurs, enregistrez l'adresse de notification https://VOTRE-SITE/?wc-api=yiriwapay et copiez le secret whsec_… dans WooCommerce.
4. 4Passez une commande de test de bout en bout avec la clé sk_test_…. Ce n'est qu'ensuite qu'il faut passer à la clé sk_live_….

Les appels de l'API déjà écrits : créer, lire, lister et annuler un paiement, lire le solde, et vérifier la signature des notifications. La clé secrète ne va que sur votre serveur, jamais dans une page web ou une application mobile.

import { YiriwaPay } from "yiriwapay";

const yw = new YiriwaPay({ apiKey: process.env.YIRIWAPAY_SECRET_KEY!, baseUrl: "https://yiriwapay.com" });

// Créer le paiement, puis envoyer le client sur checkout_url
const payment = await yw.payments.create(
  { amount: 5000, reference: "CMD-1001", customer: { name: "Awa", phone: "70123456" } },
  { idempotencyKey: "CMD-1001" },
);

// Avant de livrer : relire le paiement
const p = await yw.payments.retrieve(payment.id);
if (p.status === "succeeded" && p.amount === 5000) livrer();

Le kit n'est pas encore publié sur npm. Décompressez le fichier, puis, dans le dossier, lancez npm install et npm run build ; le fichier README.md explique le reste.

Un autre langage ? Utilisez l'API directement

L'API fonctionne avec n'importe quel langage. La documentation donne des exemples complets en Node.js, PHP et Python, la vérification des notifications signées, le mode test et la liste des erreurs.