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) |
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
Shopify est distribué en installation personnalisée. Activez-le depuis le tableau de bord lomi. → Intégrations, puis installez sur votre boutique via OAuth.