Référence API
Utilisez l’API marchande publique lomi. pour accepter des paiements, gérer les objets commerce, déplacer l’argent et traiter les événements opérationnels.
La référence API documente l’API marchande publique : les endpoints qu’un développeur doit utiliser depuis une intégration serveur. Elle n’expose volontairement pas les services internes de providers, organisations, administration marchande ou agents.
Si vous choisissez encore votre chemin d’intégration, commencez par Quelle intégration de paiement choisir ?.
URLs de base
| Environnement | URL de base | Clé secrète |
|---|---|---|
| Test | https://sandbox.api.lomi.africa | lomi_sk_test_... |
| Live | https://api.lomi.africa | lomi_sk_live_... |
Envoyez la clé secrète dans l’en-tête X-API-Key depuis votre serveur.
Encaisser des paiements
| Objectif | API |
|---|---|
| Checkout hébergé | Checkout Sessions |
| URLs de paiement partageables | Payment Links |
| Demandes de paiement créées par backend | Payment Requests |
| Flux Wave, MTN MoMo et carte plus bas niveau | Encaissements directs avancés |
Gérer le commerce
| Objectif | API |
|---|---|
| Clients et sessions de portail client | Customers |
| Produits, prix et catalogues | Products |
| Facturation récurrente et abonnements clients | Subscriptions |
| Codes promo et performance des coupons | Discount Coupons |
Déplacer et réconcilier l’argent
| Objectif | API |
|---|---|
| Lire les soldes disponibles et en attente | Soldes |
| Inspecter les enregistrements de paiement | Transactions |
| Créer et inspecter des remboursements | Refunds |
| Créer et inspecter des virements | Payouts |
Opérer de façon fiable
| Objectif | API |
|---|---|
| Configurer les endpoints, tester les livraisons, inspecter les journaux et relancer les échecs | Webhooks |
Conventions de référence
- Les guides expliquent les décisions produit et les flux complets.
- Les pages API décrivent les opérations HTTP exactes.
- Les encaissements directs sont avancés ; le checkout hébergé reste la recommandation par défaut.
- Utilisez la sandbox pour développer et le live seulement après la checklist de production.
Authentification
Les requêtes lomi. s’authentifient avec des clés API. Une requête sans clé valide renvoie une erreur d’authentification.
Gestion des erreurs
Comprendre et traiter les erreurs renvoyées par l’API.
Modèles de données
Les objets courants renvoyés par l’API publique lomi., avec les champs les plus utiles pour intégrer.
Machine d’état des paiements
Transitions entre statuts transaction et prestataire, expiration, impact sur les soldes.
Authentification
Les requêtes lomi. s’authentifient avec des clés API. Une requête sans clé valide renvoie une erreur d’authentification.
Gestion des erreurs
Comprendre et traiter les erreurs renvoyées par l’API.
Modèles de données
Les objets courants renvoyés par l’API publique lomi., avec les champs les plus utiles pour intégrer.
Machine d’état des paiements
Transitions entre statuts transaction et prestataire, expiration, impact sur les soldes.