Une boutique minimale qui encaisse par Mobile Money avec feexpay-server.
| Fichier | Rôle |
|---|---|
lib/feexpay.ts |
Le client FeexPay, créé à la première requête (server-only) |
lib/orders.ts |
Les commandes (en mémoire pour la démo) et applyTransaction, idempotent |
app/api/pay/route.ts |
Lance le paiement : le prix vient du serveur |
app/api/pay/[reference]/route.ts |
Suivi depuis le navigateur, et filet si le webhook se perd |
app/api/webhooks/feexpay/route.ts |
Le webhook, revérifié auprès de l'API de statut |
app/page.tsx |
Le formulaire : opérateur, numéro, puis attente de la validation |
- Créez un compte de test sur sandbox-app.feexpay.me et copiez votre clé (
test_key_…) et l'identifiant de la boutique. - Puis :
# à la racine du dépôt : construire le paquet
npm install && npm run build
# dans ce dossier
cd examples/nextjs
cp .env.example .env.local # puis remplissez-le
npm install
npm run devOuvrez http://localhost:3000.
En sandbox, utilisez un numéro de test : 01 97 00 00 00 réussit tout de suite, 01 97 00 00 05 passe par l'attente, 01 97 00 00 01 échoue.
Pour recevoir les webhooks en local, exposez le port 3000 (par exemple avec cloudflared tunnel --url http://localhost:3000). Saisissez ensuite l'URL …/api/webhooks/feexpay dans le tableau de bord sandbox, section Webhooks, avec Bearer et la valeur de FEEXPAY_WEBHOOK_SECRET.