# PrestaShop
Source: https://docs.lomi.africa/build/ecommerce-extensions/prestashop

Module PrestaShop 1.7+, sessions de checkout hébergées, contrôleur webhook du module, webhooks signés.

***

title: PrestaShop
description:
Module PrestaShop 1.7+, sessions de checkout hébergées, contrôleur webhook
du module, webhooks signés.
---------------------------

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

# PrestaShop

Module du dépôt [`lomiafrica/prestashop`](https://github.com/lomiafrica/prestashop) dans le dossier **`lomi/`** : checkout hébergé via `POST /checkout-sessions` et vérification via `GET /checkout-sessions/{id}`.

<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

* PrestaShop **1.7+**
* Devise boutique **EUR**, **USD** ou **XOF**

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

1. Connectez-vous à [dashboard.lomi.africa](https://dashboard.lomi.africa).
2. Copiez votre **clé secrète de test** dans **Développeurs → Clés API**.

## Étape 2, Installer le module

1. Ouvrez le dossier **`lomi`** dans [lomiafrica/prestashop](https://github.com/lomiafrica/prestashop/tree/main/lomi).
2. Zippez **uniquement** ce dossier.
3. **Back office → Modules → Importer un module** → installez et activez.

Détails : [README du module PrestaShop](https://github.com/lomiafrica/prestashop/blob/main/lomi/README.md)

## Étape 3, Préparer les devises

Activez **EUR**, **USD** ou **XOF** et autorisez **lomi.** comme moyen de paiement.

## Étape 4, Configurer lomi.

**Modules → lomi. → Configurer** : mode test activé, clé secrète de test et secret webhook de test.

## Étape 5, Vérifier Setup health

Le panneau **Setup health** doit confirmer la clé API, la devise et `GET /me`. Copiez l’URL webhook dans le tableau de bord et activez **`PAYMENT_SUCCEEDED`** et **`REFUND_COMPLETED`**.

## Étape 6, Faire un paiement test

Payez avec **lomi.** sur le checkout hébergé et vérifiez la commande PrestaShop.

## URL webhook

Configurer le webhook du tableau de bord lomi. vers :

`https://VOTRE-BOUTIQUE/index.php?fc=module&module=lomi&controller=webhook`

Une **URL simplifiée** peut exposer le même contrôleur frontal du module.

## Flux de paiement

1. Le client choisit **Payer avec lomi.** → le contrôleur **validation** crée la session et redirige vers lomi. Checkout.
2. Le contrôleur **callback** vérifie la session (id panier + secure key client), puis valide la commande PrestaShop si le statut est `completed` et que montant / devise correspondent.

Sources : [`validation.php`](https://github.com/lomiafrica/prestashop/blob/main/lomi/controllers/front/validation.php), [`callback.php`](https://github.com/lomiafrica/prestashop/blob/main/lomi/controllers/front/callback.php), [`webhook.php`](https://github.com/lomiafrica/prestashop/blob/main/lomi/controllers/front/webhook.php)

## 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)