Parcours d’intégration

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é
URL partageable	Liens de paiement
Mobile money ou cartes côté serveur	Charges directes
Facturation récurrente	Abonnements

La plupart des équipes commencent par le checkout hébergé. Consultez Quelle intégration choisir ? et Canaux de paiement.

Étape 3: Tester de bout en bout

É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_... et https://api.lomi.africa.
Suivez la checklist go-live et traitez un petit paiement live avec webhook.