Introduction
L’API Nebryon Pay Gate permet à votre site ou à votre application d’encaisser des paiements Mobile Money (Orange Money, Moov Money, Telecel Money, Wave) et d’envoyer des retraits, avec une seule intégration. Chaque opération est confirmée à la réception de l’argent puis notifiée à votre serveur.
Comment ça marche
- Votre serveur crée un paiement : montant, numéro du client, réseau. Nebryon renvoie le numéro de collecte vers lequel le client doit envoyer l’argent.
- Le client paie depuis son téléphone (application de l’opérateur ou USSD), avant l’échéance de 15 minutes.
- Dès réception, Nebryon crédite votre portefeuille (montant − frais) et prévient votre serveur par webhook signé ou par WebSocket.
- Pour envoyer de l’argent, vous créez un retrait : votre portefeuille est débité (montant + frais), un téléphone Nebryon exécute le transfert, et vous êtes notifié du résultat. Un retrait en échec est remboursé.
Avant de commencer
| Étape | Où |
|---|---|
| 1. Créer votre compte et vérifier votre e-mail | Créer un compte |
| 2. Déclarer votre service : vous recevez la clé API et le secret webhook (affichés une seule fois) | Espace partenaire › Nouveau service |
| 3. Faire vérifier votre compte : envoyer votre CNIB (recto et verso), une seule fois pour tous vos services | Espace partenaire › Vérification du compte |
| 4. Attendre la validation : votre compte passe au statut « Vérifié » | — |
| 5. Renseigner votre URL de webhook (HTTPS) pour recevoir le résultat des opérations | Espace partenaire › Intégration |
| 6. Intégrer l’API avec votre clé de test (pk_test_), disponible dès la création du service | SandBox |
Votre clé de production (pk_live_) n’est générée qu’à la validation de votre compte. En attendant, intégrez et testez tout avec la clé de test : les opérations sont simulées, sans téléphone ni argent réel.
Adresse de l’API
Toutes les routes de cette documentation sont relatives à :
https://paygate.nebyron.com/management (adresse communiquée par Nebryon)
Les exemples utilisent les variables $NEBRYON_API_KEY (votre clé) et, pour les webhooks, GATEWAY_WEBHOOK_SECRET (votre secret). Gardez-les côté serveur, jamais dans le code d’une page web ou d’une application mobile.
Pages suivantes
- Clé API et conventions — en-tête, formats de date et de montant, pagination.
- SandBox — tester sans argent réel, scénarios simulés.
- Créer un paiement — la première intégration à faire.
- Webhooks — recevoir et vérifier les notifications.
- Liste de contrôle — avant de passer en production.