WooCommerce

Extension WordPress qui envoie les acheteurs vers le checkout hébergé Lomi et confirme le paiement via l’écouteur REST WooCommerce et les webhooks marchands.

Prérequis

• WordPress 6.2+, PHP 7.4+
• WooCommerce 9.6+ (voir l’en-tête du plugin dans les sources)
• Devise de la boutique XOF, USD ou EUR
• HTTPS recommandé en production

Source : en-tête du plugin / readme

Liste de configuration

1. Installer lomi. WooCommerce Payment Gateway et activer WooCommerce.
2. Aller dans WooCommerce → Réglages → Paiements → lomi..
3. Activer la passerelle ; utiliser le mode test pendant l’intégration.
4. Coller les clés secrètes test / production et les secrets de signature webhook correspondants depuis dashboard.lomi.africa.
5. Copier l’URL webhook affichée en rouge en haut des réglages dans le tableau de bord Lomi (Développeur / Webhooks), avec le même secret que dans Woo.

Flux de paiement

1. Le client choisit lomi. et valide la commande.
2. Le plugin appelle POST /v1/checkout-sessions avec les URL de succès / annulation et les métadonnées (wc_order_id, etc.).
3. Le client paie sur la page Lomi Checkout.
4. L’URL de retour appelle l’écouteur API WooCommerce, qui fait GET /v1/checkout-sessions/{id} et finalise la commande si le statut est completed.
5. Le webhook PAYMENT_SUCCEEDED peut finaliser la commande si le retour navigateur est retardé ; signature vérifiée avec X-Lomi-Signature sur le corps brut.

Référence code : class-wc-gateway-lomi.php

Webhooks

Vérifier toujours les octets bruts reçus — ne pas re-sérialiser le JSON.

Mise en production et QA

Avant la prod :

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

Contrat technique (aligné Magento / Presta) :

• Contrat d’intégration des plugins

Autres docs

• Hub extensions e‑commerce
• Readme marchand (format WordPress.org) : readme.txt