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

lomi/magento2-payments n’est pas publié sur Packagist. Enregistrez le dépôt GitHub, puis installez avec Composer :

composer config repositories.lomi-magento vcs https://github.com/lomiafrica/magento
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 setup:static-content:deploy -f
php bin/magento cache:flush

Installation manuelle

1. Clonez ou téléchargez lomiafrica/magento.
2. Copiez le paquet dans app/code/Lomi/Payments/ à la racine Magento (dossier contenant registration.php).
3. Exécutez les mêmes commandes module:enable, setup:upgrade, setup:di:compile et cache:flush que ci-dessus.

Détails : README du plugin Magento

Étape 1, Obtenir vos clés API lomi.

1. Connectez-vous à dashboard.lomi.africa.
2. Ouvrez Développeurs → Clés API.
3. Copiez votre clé secrète de test (lomi_sk_test_…).

Étape 2, Installer le module

Utilisez Composer ou l’installation manuelle ci-dessus, puis activez Lomi_Payments et videz le cache.

Étape 3, Configurer lomi. dans Magento

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

1. Activez la méthode.
2. Activez le Mode test pendant l’intégration.
3. Collez la clé secrète de test et le secret webhook de test.
4. Enregistrez.

Étape 4, Vérifier Setup health

Le panneau Setup health doit afficher :

• Clé secrète API : Configurée
• Connexion API : GET /me réussi
• Mode test : API bac à sable active

Étape 5, Connecter les webhooks

1. Copiez l’URL webhook affichée dans l’admin.
2. Créez l’endpoint dans le tableau de bord lomi.
3. Activez PAYMENT_SUCCEEDED et REFUND_COMPLETED.
4. Collez le secret de signature dans Magento.

Étape 6, Faire un paiement test

Passez une commande avec lomi. et payez sur le checkout hébergé (bac à sable tant que le mode test est actif).

Mise en production

Désactivez le Mode test, collez les clés live et le secret webhook live, puis faites un petit paiement réel.

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 technique partagé
• Vérifier les paiements

Autres docs

• Hub extensions e‑commerce