Accueil
Le portail développeur de l'API de paiement FreeGate.
FreeGate est une passerelle de paiement. Elle expose une seule API REST. Avec cette API, vous encaissez, reversez et remboursez de l'argent. Vous touchez les opérateurs de mobile money de plusieurs pays.
Ce que vous pouvez faire
- Payin — encaisser un paiement depuis le téléphone d'un client.
- Payout — reverser des fonds vers un bénéficiaire.
- Refund — rembourser tout ou partie d'un payin réussi.
- Consultation — lire l'état d'une transaction et lister les opérateurs disponibles pour votre application.
Toutes ces opérations utilisent la même clé API, les mêmes statuts et les mêmes webhooks signés.
Principes clés
- Une API, plusieurs opérateurs. Vous n'intégrez qu'une seule API. FreeGate choisit le bon opérateur à partir du pays et du code opérateur.
- Asynchrone par défaut. La plupart des paiements se terminent après la première requête. Vous êtes prévenu par webhook. Vous pouvez aussi lire le statut à tout moment.
- Montants en unités mineures. Un montant est une chaîne de chiffres. Par
exemple,
"25000"vaut 250,00 dans une devise à 2 décimales. - Sandbox d'abord. La sandbox rejoue les cas de succès, d'échec, d'OTP et de délai. Testez-y votre intégration avant la production.
Par où commencer
- Démarrage rapide — créer une application, obtenir une clé API et lancer un premier payin en sandbox.
- Concepts — le cycle de vie payin / payout / refund, le settlement différé et les wallets.
- Webhooks — vérifier les signatures et traiter les notifications sans doublon.
- Référence API — le détail de chaque endpoint, avec un playground « try it ».