# Magento 2
Source: https://docs.lomi.africa/build/ecommerce-extensions/magento

Module Lomi_Payments, checkout hébergé via sessions, route de retour, webhooks signés, REST de vérification optionnelle.

***

title: Magento 2
description:
Module Lomi\_Payments, checkout hébergé via sessions, route de retour,
webhooks signés, REST de vérification optionnelle.
--------------------------------------------------

import { Callout } from '@/components/docs/docs-callout';

# Magento 2

Extension **Lomi\_Payments** pour Magento Open Source / Adobe Commerce. Code du moyen de paiement : **`lomi`**.

<Callout type="info" title="Produits associés">
  * **Clés API** : [Tableau de bord → Développeurs → Clés API](/start/api-keys)
  * **Webhooks** : [Webhooks du tableau de bord](/build/reliability) — abonnez-vous à **`PAYMENT_SUCCEEDED`** et **`REFUND_COMPLETED`**
  * **Checkout hébergé** : [Checkout](/build/accept/checkout), où le client paie après redirection
  * **Abonnements** : [Abonnements](/build/billing/subscriptions), produits récurrents via checkout
</Callout>

## Prérequis

* Magento **2.4.x**, PHP selon votre version Magento (**7.4+** / **8.x**)
* Compte lomi. et clés depuis [dashboard.lomi.africa](https://dashboard.lomi.africa)

## Installation

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

```bash
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](https://github.com/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](https://github.com/lomiafrica/magento/blob/main/README.md)

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

1. Connectez-vous à [dashboard.lomi.africa](https://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`](https://github.com/lomiafrica/magento/blob/main/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é](/build/ecommerce-extensions)
* [Vérifier les paiements](/build/reliability/verify-payments)

## Autres docs

* [Hub extensions e‑commerce](/build/ecommerce-extensions)