Extensions e‑commerce
Extensions officielles ou maintenues pour un paiement hébergé avec lomi. WooCommerce, Magento 2 et PrestaShop partagent le même contrat d’API publique ; Shopify est traité à part.
Extensions e‑commerce
Installez lomi. sur votre boutique sans recoder le tunnel de paiement. Ces modules créent des sessions de paiement hébergées, envoient le client vers la page lomi. Checkout, puis confirment le paiement via les URL de retour et les webhooks marchands.
Contrat technique partagé
WooCommerce, Magento 2 et PrestaShop n’utilent que l’API REST publique lomi. (/v1/checkout-sessions). Ils n’appellent pas les RPC Supabase ni les endpoints internes Nest.
| Point | Contrat |
|---|---|
| URL de base | https://api.lomi.africa (production) ou https://sandbox.api.lomi.africa (test) |
| Auth | X-API-Key, clé secrète marchande depuis le tableau de bord |
| Créer une session | POST /checkout-sessions |
| Lire une session | GET /checkout-sessions/{id} |
| Paiement validé | status completed, avec contrôle montant / devise par rapport au panier / commande |
| Webhooks | X-Lomi-Event (ex. PAYMENT_SUCCEEDED), X-Lomi-Signature, HMAC-SHA256 hex sur le corps JSON brut |
Formulation canonique à côté du code :
- Contrat technique partagé (cette page)
- Vérifier les paiements et Traiter les webhooks
Avant la mise en production : Intégration API, Authentification et Webhooks.
Où télécharger chaque extension
| Plateforme | Artefact d’installation |
|---|---|
| WooCommerce | Téléchargement docs (woo-lomi.zip), guide pas à pas avec captures |
| Magento 2 | Composer VCS depuis magento ou copie dans app/code/Lomi/Payments/ |
| PrestaShop | Zip du dossier lomi/ depuis prestashop |
| Shopify | Tableau de bord → Paramètres → Canaux de paiement → Intégrations (installation personnalisée, pas de zip) |
| Bubble | Éditeur Bubble → Plugins → Add plugins → lomi. (ou sync GitHub), installation pas à pas |
Choisir la plateforme
WooCommerce
Passerelle de paiement WordPress / WooCommerce
Magento 2
Module Lomi_Payments, checkout hébergé
PrestaShop
Module PrestaShop 1.7+
Shopify
App personnalisée, paiement panier mobile money et cartes
Bubble
Extension no-code Bubble.io, checkout par redirection ou intégré
Shopify est distribué en installation personnalisée. Activez-le depuis le tableau de bord lomi. → Intégrations, puis installez sur votre boutique via OAuth.
Autres façons d’intégrer
Pas sur une plateforme prise en charge, ou vous construisez un tunnel personnalisé ? Ces options offrent le même checkout hébergé sans extension de boutique :
- Widget d’intégration, un bouton et une fenêtre de checkout à intégrer sur n’importe quel site (y compris Bubble et HTML personnalisé).
- Checkout hébergé, la page lomi. vers laquelle vos extensions redirigent les clients.
- Storefront, pages produits marchandes et parcours d’abonnement (
display_on_storefrontsur le catalogue). - lomi-ui, des composants de checkout à copier-coller quand vous voulez votre propre UI.
- CLI, créer et tester des sessions de paiement depuis votre terminal.
- MCP, piloter le checkout depuis des agents IA et vos workflows d’IDE.
Extension, widget ou API ?
| Vous voulez… | Utilisez |
|---|---|
| Ajouter les paiements à une boutique prise en charge (Woo, Magento, PrestaShop, Shopify, Bubble) | L’extension de cette plateforme |
| Ajouter un bouton de paiement à un site personnalisé ou une page no-code | Widget d’intégration |
| Garder votre propre UI de checkout sans recoder la plomberie de paiement | Les composants lomi-ui |
| Un contrôle total depuis votre propre backend | L’API publique (POST /checkout-sessions) |
| Vendre depuis un catalogue hébergé (sans plugin boutique) | Storefront avec Produits (display_on_storefront) |
| Automatiser ou tester depuis un terminal ou des agents IA | CLI ou MCP |