# Aperçu
Source: https://docs.lomi.africa/build/ecommerce-extensions

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.

***

title: Aperçu
description:
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.
-------------------------------------

import { Cards, Card } from 'fumadocs-ui/components/card';
import { Callout } from '@/components/docs/docs-callout';

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’utilisent que l’**API publique** lomi. (`/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é](#contrat-technique-partagé) (cette page)
* [Vérifier les paiements](/build/reliability/verify-payments) et [Traiter les webhooks](/build/reliability/handling-webhooks)

Avant la mise en production : [Intégration API](/start/first-payment), [Authentification](/api/authentication) et [Webhooks](/build/reliability).

## Où télécharger chaque extension

| Plateforme  | Artefact d’installation                                                                                                                                             |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| WooCommerce | **[Téléchargement docs](/build/ecommerce-extensions/woocommerce#step-2--download-the-plugin)** (`woo-lomi.zip`), guide pas à pas avec captures                      |
| Magento 2   | Composer VCS depuis [magento](https://github.com/lomiafrica/magento) ou copie dans `app/code/Lomi/Payments/`                                                        |
| PrestaShop  | Zip du dossier `lomi/` depuis [prestashop](https://github.com/lomiafrica/prestashop)                                                                                |
| Shopify     | [Tableau de bord](https://dashboard.lomi.africa) → **Paramètres → Canaux de paiement → Intégrations** (installation personnalisée, pas de zip)                      |
| Bubble      | [Éditeur Bubble](https://bubble.io/home/plugins) → **Plugins → Add plugins → lomi.** (ou sync GitHub), [installation](/build/ecommerce-extensions/bubble) pas à pas |

## Choisir la plateforme

<Cards>
  <Card title="WooCommerce" description="Passerelle de paiement WordPress / WooCommerce" href="/build/ecommerce-extensions/woocommerce" />

  <Card title="Magento 2" description="Module Lomi_Payments, checkout hébergé" href="/build/ecommerce-extensions/magento" />

  <Card title="PrestaShop" description="Module PrestaShop 1.7+" href="/build/ecommerce-extensions/prestashop" />

  <Card title="Shopify" description="App personnalisée, paiement panier mobile money et cartes" href="/build/ecommerce-extensions/shopify" />

  <Card title="Bubble" description="Extension no-code Bubble.io, checkout par redirection ou intégré" href="/build/ecommerce-extensions/bubble" />
</Cards>

<Callout type="info">
  **Shopify** est distribué en **installation personnalisée**. Activez-le depuis le tableau de bord lomi. → **Intégrations**, puis installez sur votre boutique via OAuth.
</Callout>

## Autres façons d’intégrer

Pas sur une plateforme prise en charge, ou vous construisez un tunnel personnalisé ? Ces options offrent le même checkout hébergé sans extension de boutique :

* **[Widget d’intégration](/build/accept/embed-widget)**, un bouton et une fenêtre de checkout à intégrer sur n’importe quel site (y compris Bubble et HTML personnalisé).
* **[Checkout hébergé](/build/accept/checkout)**, la page lomi. vers laquelle vos extensions redirigent les clients.
* **[Storefront](https://store.lomi.africa)**, pages produits marchandes et parcours d’abonnement (`display_on_storefront` sur le catalogue).
* **[lomi-ui](/build/lomi-ui)**, des composants de checkout à copier-coller quand vous voulez votre propre UI.
* **[CLI](/build/cli)**, créer et tester des sessions de paiement depuis votre terminal.
* **[MCP](/build/mcp)**, piloter le checkout depuis des agents IA et vos workflows d’IDE.

## Extension, widget ou API ?

| Vous voulez…                                                                                     | Utilisez                                                                                                       |
| ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------- |
| Ajouter les paiements à une boutique prise en charge (Woo, Magento, PrestaShop, Shopify, Bubble) | L’**extension** de cette plateforme                                                                            |
| Ajouter un bouton de paiement à un site personnalisé ou une page no-code                         | **[Widget d’intégration](/build/accept/embed-widget)**                                                         |
| Garder votre propre UI de checkout sans recoder la plomberie de paiement                         | Les composants **[lomi-ui](/build/lomi-ui)**                                                                   |
| Un contrôle total depuis votre propre backend                                                    | L’**[API publique](/start/first-payment)** (`POST /checkout-sessions`)                                         |
| Vendre depuis un catalogue hébergé (sans plugin boutique)                                        | **[Storefront](https://store.lomi.africa)** avec [Produits](/build/billing/products) (`display_on_storefront`) |
| Automatiser ou tester depuis un terminal ou des agents IA                                        | **[CLI](/build/cli)** ou **[MCP](/build/mcp)**                                                                 |