Parcours d’intégration
De la sandbox au live : compte, clés, premier paiement, webhooks et mise en production.
Suivez ce guide avant d’écrire du code de production. Chaque étape renvoie vers la page détaillée, cette page est la carte, pas le manuel.
Nouveau ? Lisez Qu’est-ce que lomi. ?, puis suivez ce parcours étape par étape.
Étape 1: Créer un compte développeur
Inscrivez-vous pour accéder à l’environnement test et exécuter des flux complets sans argent réel.
En mode test vous pouvez :
- Accepter des paiements avec cartes test et mobile money simulé.
- Créer sessions checkout, liens et charges directes sur l’API sandbox.
- Recevoir des webhooks avec
"environment": "test".
Voir Créer votre compte et Clés API.
Étape 2: Choisir votre intégration
| Besoin | Commencez par |
|---|---|
| Page checkout complète | Checkout hébergé |
| Checkout intégré sur votre site | Widget checkout |
| URL partageable | Liens de paiement |
| Demande de paiement créée côté backend | Demandes de paiement |
| Mobile money ou cartes côté serveur | Charges directes |
| Facturation récurrente | Abonnements |
| Plugin boutique (WooCommerce, Shopify, etc.) | Extensions e‑commerce |
Définissez ce que vous vendez dans Produits avant de créer des sessions checkout ou des plans d’abonnement.
La plupart des équipes commencent par le checkout hébergé. Consultez Quelle intégration choisir ? et Canaux de paiement pour confirmer la couverture Wave, MTN et cartes sur vos marchés.
Étape 3: Tester de bout en bout
- Faire un paiement de test
- Paiements sandbox: cartes, Wave, MTN
- Tester les échecs avec Simuler des erreurs
- Gestion des erreurs et idempotence
- Cas limites checkout (abonnements, essais, mobile money en attente) : Comportement checkout et guides par canal sous Canaux de paiement.
Étape 4: Configurer les webhooks
Les webhooks sont essentiels pour les moyens de paiement et les événements hors de votre application, comme l’approbation mobile money et les renouvellements d’abonnement.
- Enregistrez une URL HTTPS dans le portail.
- Suivez Configurer les webhooks et Traiter les webhooks.
- Vérifiez la signature sur le corps brut avant de parser le JSON.
Renouvellements d’abonnement : les abonnements carte se renouvellent hors session ; écoutez SUBSCRIPTION_RENEWED et les PAYMENT_FAILED de renouvellement. Wave et MTN utilisent un lien checkout de renouvellement manuel envoyé avant chaque échéance, le client doit payer ce lien ; pas de débit wallet silencieux. Voir Abonnements : renouvellements.
Étape 5: Passer en live
- Vérification du compte et configuration des reversements.
- Passez à
lomi_sk_live_...ethttps://api.lomi.africa. - Suivez la checklist go-live et traitez un petit paiement live avec webhook.
Étapes suivantes
Confirmer les paiements en production
Exploiter après le go-live
Catalogue, facturation et clients
Outils et durcissement
- SDKs · CLI · MCP · lomi. UI
- Extensions e‑commerce (WooCommerce, Shopify, Magento, PrestaShop)
- Guides avancés (erreurs, tests, CI/CD, fiabilité webhooks)
- Démarrer avec le CLI