Quelle intégration choisir ?
Choisissez entre checkout hébergé, liens de paiement, demandes de paiement, charges directes, abonnements et extensions ecommerce.
Choisissez l’intégration la plus simple qui donne au client la bonne expérience de paiement. Vous pourrez combiner plusieurs produits lomi. ensuite.
Commencez ici
| Si vous avez besoin de | Utilisez | Pourquoi |
|---|---|---|
| Une page de checkout complète | Checkout hébergé | Chemin le plus rapide vers la production pour apps et boutiques |
| Checkout sur votre site (iframe) | Widget checkout embarqué | UI lomi. complète sans quitter votre page |
| Une URL partageable | Liens de paiement | Factures, services, événements, vente no-code |
| Vente sur WhatsApp | WhatsApp Commerce | Connecter WhatsApp dans le dashboard et partager des liens de paiement |
| Une demande créée par le backend | Demandes de paiement | Votre app contrôle le parcours commande |
| Mobile money d’abord | Mobile money | Flux Wave, MTN et SPI |
| Cartes embarquées | Cartes | Vous contrôlez l’UI et la saisie carte dans votre app |
| Facturation récurrente | Abonnements | SaaS, adhésions et services récurrents |
| Portail client (facturation, abonnements) | Portail client | Historique, changement de plan et résiliation hébergés |
| Plugin boutique | Extensions ecommerce | WooCommerce, Magento, PrestaShop, Shopify et Bubble |
| Catalogue produit hébergé | Produits + store.lomi.africa | Quand vous voulez une boutique lomi. sans plateforme tierce |
| Assistant IA / agent MCP | MCP | Cursor, Claude Desktop et clients MCP sur l’API marchande |
| Accès API typé dans votre code | SDKs | Clients TypeScript, Python, Go et PHP avec méthodes typées et gestion d’erreurs |
| Configuration et tests depuis le terminal | CLI | S’authentifier, scaffolder des projets, créer des checkouts sandbox et transférer les webhooks |
| Comparer par pays | Canaux de paiement | Matrice pays × devise × canal |
| Wave / MTN / carte côté serveur | Charges directes | Vous maîtrisez l’UI de paiement de bout en bout |
Comparaison des produits
| Checkout hébergé | Widget iframe | Liens | Demandes | Charges directes | Abonnements | Plugins | |
|---|---|---|---|---|---|---|---|
| Effort de développement | Faible | Faible | Faible | Moyen | Élevé | Moyen | Faible |
| Contrôle UI | Hébergé lomi. | iframe sur votre site | Hébergé lomi. | App + étape pay | Total (UI maison) | Inscription hébergée | Natif boutique |
| Rapidité de lancement | Élevée | Élevée | Élevée | Moyenne | Faible | Moyenne | Élevée |
| Mobile money asynchrone | Géré sur la page hébergée | Comme hébergé | Idem | Idem | UX pending à vous | Flux hébergé | Selon plugin |
| Webhooks | Recommandés | Recommandés | Recommandés | Recommandés | Requis (live) | Requis | Recommandés |
| Dashboard no-code | Sessions + catalogue | - | Oui | Partiel | - | Plans + liens | Oui |
Choix recommandé
La plupart des équipes devraient commencer par le checkout hébergé. Les flux sensibles restent chez lomi., plusieurs moyens de paiement sont supportés, et vous obtenez un parcours client prêt pour la production sans construire l’UI de paiement.
Utilisez les charges directes ou les éléments embarqués seulement si votre produit exige un contrôle total de l’interface de paiement.
Que doit contenir chaque intégration ?
Toute intégration sérieuse doit inclure :
- Séparation environnements test et live.
- Clés secrètes utilisées côté serveur uniquement.
- États visibles pour le client : succès, annulation, attente et échec.
- Webhooks pour la réconciliation finale.
- Idempotence sur les opérations de création lorsque des retries sont possibles.
Avant le go-live, exécutez Simuler des erreurs en sandbox pour tester échecs et états en attente.