Magento 2

Extension Lomi_Payments pour Magento Open Source / Adobe Commerce. Code du moyen de paiement : lomi.

Prérequis

• Magento 2.4.x, PHP selon votre version Magento (7.4+ / 8.x)
• Compte Lomi et clés depuis dashboard.lomi.africa

Installation

Composer (cas courant) :

composer require lomi/magento2-payments
php bin/magento module:enable Lomi_Payments
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

Installation manuelle : copier le paquet sous app/code/Lomi/Payments/ puis les mêmes commandes module:enable / setup:upgrade.

Détails : README du plugin Magento

Configuration

Magasins → Configuration → Ventes → Moyens de paiement → lomi.

• Activer la méthode ; Mode test pour le bac à sable.
• Renseigner les clés secrètes test / production et les secrets de signature webhook (identiques au secret du point de terminaison dans le tableau de bord Lomi).
• URL webhook typique : https://votre-boutique.example/lomi/payment/webhook (également affichée dans l’admin).

Parcours client

1. Le client choisit lomi. et passe commande.
2. Magento crée une session de paiement et redirige vers Lomi Checkout.
3. URL de retour : lomi/payment/callback — vérifie la session par rapport à la commande.
4. Webhook PAYMENT_SUCCEEDED avec X-Lomi-Signature / X-Lomi-Event.
   Si metadata.magento_increment_id est absent, le module peut quand même résoudre la commande avec checkout_session_id et le champ de paiement lomi_checkout_session_id.

REST de vérification (optionnel)

GET /rest/V1/lomi/verify/{checkoutSessionId} — vérifie la session pour la dernière commande réelle de la session checkout navigateur ; le segment d’URL doit correspondre à lomi_checkout_session_id sur cette commande.

Défini dans etc/webapi.xml.

Webhooks

Même contrat que les autres plugins PHP : HMAC-SHA256 hex sur le JSON brut ; configurer les webhooks dans le tableau de bord Lomi.

Docs partagées

• Contrat d’intégration des plugins
• Liste de contrôle QA d’intégration

Autres docs

• Hub extensions e‑commerce