API Reemite
Intégrez les paiements mobile money, les wallets multi-devises et les cartes virtuelles à votre plateforme, à travers une API REST unique.
Cette documentation s'adresse aux équipes techniques qui connectent leur backend à Reemite. Elle décrit les endpoints accessibles avec une clé API business, leurs paramètres, leurs réponses et les erreurs à gérer.
Avant de commencer
- Un compte business Reemite vérifié et activé, ouvert depuis l'Espace client.
- Une clé API, générée depuis l'Espace client — voir Authentification.
- Un endpoint HTTPS sur votre serveur pour recevoir les webhooks.
Par où commencer
- AuthentificationObtenir une clé API et authentifier vos requêtes.
- WalletsOuvrir un wallet dans chaque devise que vous utilisez.
- Moyens de paiementRécupérer les opérateurs disponibles et leurs montants limites.
- Dépôts & retraitsEncaisser vos clients et payer vos bénéficiaires par mobile money.
- WebhooksRecevoir le résultat de chaque opération en temps réel.
Principes de l'API
Requêtes et réponses
Les requêtes et les réponses sont au format JSON, encodées en UTF-8. Envoyez l'en-tête Content-Type: application/json avec chaque requête comportant un corps.
Une réponse réussie place la ressource dans un champ data. Une erreur renvoie un champ message — voir Erreurs.
{ "data": { "id": 38, "currency_code": "CDF", "balance": "0" } }
Montants
Les montants sont exprimés en centièmes de la devise, quelle que soit la devise, et transmis sous forme de chaîne de caractères afin d'éviter toute perte de précision liée aux nombres décimaux : "1250" vaut 12,50 USD, et "10000" vaut 100 XAF. Pour une devise sans décimales (XAF, XOF, RWF, BIF, UGX…), un montant envoyé doit être un multiple de 100.
{ "amount": "50000", "currency_code": "USD" }
Dans cet exemple, "50000" correspond à 500,00 USD.
Idempotence
Les opérations qui déplacent des fonds exigent une idempotency_key au format UUID, unique pour chaque tentative. Si une requête est rejouée avec la même clé — après un délai d'attente dépassé par exemple — l'API renvoie le résultat de la première tentative au lieu de créer une nouvelle opération.
Réutiliser une clé avec un contenu de requête différent renvoie 409.
Opérations asynchrones
Les dépôts et les retraits sont traités de façon asynchrone. L'API répond immédiatement 202 avec une opération au statut processing, puis vous notifie de son résultat final par webhook.