Shopify

L’app lomi. pour Shopify permet aux marchands d’accepter Wave, mobile money, cartes et plus depuis la page panier via le checkout hébergé lomi. Les commandes Shopify sont créées en brouillon avant la redirection et finalisées au succès du paiement.

Il s’agit d’une intégration contournement panier, distribuée en installation personnalisée. Ce n’est pas un moyen de paiement natif au checkout Shopify et ce n’est pas une app de paiement sur l’App Store.

Prérequis

Boutique Shopify avec l’app lomi. installée (lien d’installation personnalisé)
Compte marchand lomi. avec clé secrète API et secret de signature webhook
Devise boutique prise en charge par lomi. (ex. XOF, USD, EUR)

Distribution en installation personnalisée depuis le tableau de bord lomi. (pas de release publique sur GitHub).

Installation

Depuis le tableau de bord lomi. (recommandé)

dashboard.lomi.africa → Paramètres → Canaux de paiement → Intégrations.
Activez Shopify, saisissez votre domaine (ma-boutique.myshopify.com).
Cliquez Installer sur Shopify pour lancer OAuth.
Après installation, ouvrez l’app → Settings → clés API lomi.

URL d’installation : https://connect.lomi.africa/install?shop={boutique}.myshopify.com

Installation manuelle / partage équipe

Copiez le lien d’installation depuis la modale du tableau de bord et envoyez-le à un collègue, ou ouvrez :

https://connect.lomi.africa/install

Checklist de configuration

Collez la clé secrète et le secret webhook dans les réglages de l’app.
Dans dashboard.lomi.africa → Webhooks, créez un endpoint :
- URL : {hôte_app}/api/webhooks/lomi/payment-success
- Événement : PAYMENT_SUCCEEDED
Choisissez le mode de livraison : sous-total seul ou sous-total + frais de port fixes.
Dans Boutique en ligne → Thèmes → Personnaliser → Panier, ajoutez le bloc Pay with lomi. et enregistrez.
Testez avec un panier contenant plusieurs articles.

Flux de paiement

Le client clique Payer avec lomi. sur le panier.
Le bloc lit /cart.js et appelle POST /apps/lomi/cart-pay (proxy d’app signé).
L’app crée un brouillon de commande Shopify avec toutes les lignes.
L’app crée une session checkout lomi. (montant = total du brouillon).
Paiement sur lomi. → webhook PAYMENT_SUCCEEDED → finalisation du brouillon.
Page /shopify/order-complete : panier vidé, référence commande affichée.

Webhooks

En-tête	Rôle
`X-Lomi-Event`	Doit être `PAYMENT_SUCCEEDED` pour finaliser le brouillon
`X-Lomi-Signature`	HMAC-SHA256 hex du corps brut, secret = secret webhook du tableau de bord

Métadonnées utilisées pour la réconciliation :

shopify_shop
shopify_draft_order_id
shopify_draft_order_name
shopify_checkout_session_id

Limitations

Pas de partenaire paiements / moyen de paiement natif au checkout (pas Shop Pay, pas de passerelle UI checkout).
Livraison et taxes du checkout Shopify indisponibles sur la page panier : sous-total seul ou forfait de livraison fixe dans les réglages de l’app.
Remboursements gérés dans le tableau de bord lomi., pas automatiquement depuis l’admin Shopify.
Ne soumettez pas ce flux contournement panier à l’App Store public Shopify (politique Shopify sur le contournement du checkout).

QA mise en production

Scénario	Attendu
Panier un article	Une ligne sur le brouillon ; montant lomi = total brouillon
Multi-articles / qté > 1	Toutes les variantes et quantités sur le brouillon
Mode sous-total seul	Pas de ligne livraison sur le brouillon
Mode forfait livraison	Total brouillon = sous-total + frais configurés
Paiement réussi	Brouillon finalisé ; panier vidé sur la page succès
Relance webhook	Pas de commandes Shopify en double
Annulation sur lomi.	Client revient sur `/cart` ; brouillon reste ouvert

Voir aussi

Hub extensions e‑commerce
WooCommerce : référence pour checkout hébergé + contrat webhook
Webhooks

Shopify

Sur cette page