Installer LodinPay sur Shopify
L'intégration Shopify est en cours de développement. Cette page décrit l'architecture prévue : tant que l'application n'est pas publiée, aucune étape d'installation n'est encore réalisable. Pour être averti de sa mise en ligne, contactez l'équipe intégrations.
Pourquoi Shopify est différent
Sur PrestaShop ou Shopware, le module s'installe directement dans le code de la boutique et enregistre lui-même un mode de paiement. Shopify ne le permet pas : la plateforme est hébergée et fermée. Un fournisseur de paiement tiers doit passer par l'extension Payments App, le mécanisme officiel qui fait apparaître un moyen de paiement nativement dans le checkout Shopify.
L'intégration LodinPay prendra donc la forme d'une application Shopify, et non d'un module à téléverser. C'est la principale différence avec les autres plugins du catalogue.
Architecture prévue
| Sujet | Implémentation Shopify |
|---|---|
| Enregistrer la méthode de paiement | PaymentsAppExtension |
| Initiation du paiement | Webhook côté app ou proxy d'app |
| État commande : en attente | financial_status = pending |
| État commande : payée | financial_status = paid (Transaction API) |
| État commande : échec | financial_status = voided |
| Endpoint webhook | Proxy d'app ou route d'app dédiée |
| Endpoint de retour | URL de retour client via le proxy d'app |
| Restauration du panier | Shopify restaure automatiquement les paniers abandonnés |
Le cœur du traitement reste identique aux autres plugins : même schéma de signature HMAC, même contrat de webhook signé, même page de paiement hébergée par Lodin. Seules la couche d'enregistrement du paiement et la persistance de l'état de commande sont spécifiques à Shopify.
Parcours prévu
- Le marchand installe l'application LodinPay depuis l'App Store Shopify et saisit son Client ID et son Client Secret dans la configuration de l'app.
- « Pay by Bank » apparaît comme mode de paiement au checkout via la Payments App Extension.
- Au paiement, l'app génère un lien signé et redirige le client vers la page de paiement hébergée par Lodin.
- La commande est créée avec
financial_status = pending. - Le webhook signé met la commande à
paid(succès) ouvoided(échec), via la Transaction API de Shopify. - Le client revient sur la page
/thank_youde Shopify ; un panier abandonné est automatiquement restauré en cas d'échec.
En attendant
Si vous utilisez Shopify aujourd'hui et souhaitez encaisser des paiements LodinPay, vous pouvez appeler directement l'API REST depuis une application personnalisée. Le flux de signature et de webhook est entièrement documenté sur la page Algorithme de signature.