Parcours d’intégration

Le checkout hébergé, les liens de paiement, les abonnements et les autres produits ci-dessous passent tous par la même API marchande. Le choix de ce que vous construisez est indépendant de comment vous utilisez lomi. : API, SDK, CLI ou MCP.

Dans la sandbox

• Payer avec des cartes de test
• Laisser Wave et MTN se compléter automatiquement avec une clé test
• Envoyer X-Scenario-Key: pending ou failed sur les charges Wave/MTN directes
• Transférer les webhooks avec lomi listen

En live, vous ne pouvez pas

• Auto-compléter le Mobile Money (le client doit approuver sur l’appareil)
• Utiliser les PAN de test (ils ne fonctionnent qu’avec une clé test)

Comment utiliser lomi.

Choisissez la surface qui correspond à votre façon de travailler.

curl -sS -X POST "https://sandbox.api.lomi.africa/checkout-sessions" \
  -H "X-API-Key: $LOMI_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10000,
    "currency_code": "XOF",
    "title": "Commande de test",
    "success_url": "https://example.com/success",
    "cancel_url": "https://example.com/cancel"
  }'

const session = await lomi.checkoutSessions.create({
  amount: 10000,
  currency_code: 'XOF',
  title: 'Abonnement premium',
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
});

console.log('Rediriger vers :', session.checkout_url);

npm install -g lomi.cli
lomi login
lomi quickstart
lomi checkout create \
  --amount 10000 \
  --currency XOF \
  --success-url https://example.com/success \
  --cancel-url https://example.com/cancel \
  --json

{
  "mcpServers": {
  "lomi.": {
      "url": "https://mcp.lomi.africa/mcp"
    }
  }
}

É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 :

1. Accepter des paiements avec cartes test et mobile money simulé.
2. Créer sessions checkout, liens et charges directes sur l’API sandbox.
3. Recevoir des webhooks avec "environment": "test".

Voir Créer votre compte et Clés API.

Étape 2: Choisir votre intégration

lomi. propose plusieurs options d’intégration selon votre stack :

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

Testez votre intégration à fond avec les identifiants sandbox :

1. Comment tester un paiement ? : checkout CLI ou API.
2. Paiements sandbox: cartes, Wave, MTN
3. Tester les échecs avec Simuler des erreurs
4. Gestion des erreurs et idempotence
5. Cas limites checkout (abonnements, essais, mobile money en attente) : Comportement checkout et guides par canal sous Canaux de paiement.

Le même premier checkout peut être créé depuis REST, le SDK, le CLI ou MCP. Les parcours CLI et cURL sont détaillés dans Comment tester un paiement ?. SDK et MCP : Démarrer avec le SDK et MCP.

É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.

1. Enregistrez une URL HTTPS dans le portail.
2. Suivez Configurer les webhooks et Traiter les webhooks.
3. 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

1. Vérification du compte et configuration des reversements.
2. Passez à lomi_sk_live_... et https://api.lomi.africa.
3. Suivez Que vérifier avant le live ? et traitez un petit paiement live avec webhook.