Installer LodinPay sur Shopware 6
Ce guide vous accompagne pas à pas pour configurer votre compte marchand Lodin et l'intégrer avec succès à votre boutique Shopware 6.
Étape 1 — Accès au compte
Connectez-vous à votre tableau de bord marchand Lodin pour commencer la configuration.
Étape 2 — Inscription
Si vous n'avez pas encore de compte, procédez à l'inscription :
- Renseignez les informations de votre entreprise via la recherche SIRET.
- Complétez vos données personnelles.
Étape 3 — Connexion bancaire
Liez votre banque pour recevoir vos encaissements directement sur votre IBAN. Sélectionnez votre établissement dans la liste proposée, puis suivez le parcours d'authentification jusqu'à la confirmation.
Étape 4 — Initialisation de l'intégration
Lorsque vous accédez pour la première fois à l'onglet Integrations du menu latéral, une fenêtre vous demande de sélectionner le compte bancaire de réception par défaut pour les paiements de votre boutique.
Étape 5 — Sélection de la plateforme
Une fois le compte par défaut configuré, vous accédez au catalogue des plateformes disponibles. Choisissez Shopware.
Étape 6 — Configuration et identifiants API
Après avoir choisi le plugin Shopware, renseignez les détails de votre magasin pour générer vos identifiants de connexion.
Le Client Secret est une donnée critique.
- Copiez-le immédiatement dans un endroit sûr.
- Une fois la page quittée, il ne sera plus jamais affiché.
Une fois les identifiants correctement générés et enregistrés, votre module passe au statut Activé dans votre tableau de bord Lodin.
Étape 7 — Configuration dans Shopware
Une fois vos identifiants récupérés, rendez-vous dans l'administration de votre boutique Shopware afin de finaliser la configuration du plugin Lodin.
Installation du plugin
- Accédez à Extensions → Mes extensions.
- Recherchez le plugin Lodin Payment.
- Cliquez sur Installer, puis sur Activer.
- Cliquez ensuite sur Configurer.
- Saisissez le Client ID et le Client Secret.
- Enregistrez les paramètres.
Activation du mode de paiement
Une fois le plugin configuré, activez le mode de paiement dans Shopware :
- Allez dans Paramètres → Méthodes de paiement.
- Recherchez Pay by Bank (Lodin).
- Activez le mode de paiement.
- Associez-le à un ou plusieurs canaux de vente.
Assurez-vous que le mode de paiement est bien assigné au canal de vente utilisé (par exemple Storefront) et qu'il est disponible pour la zone géographique concernée.
Étape 8 — Parcours de paiement client
Voici le déroulement d'une transaction type pour un client final sur une boutique Shopware équipée du plugin Lodin.
Sélection du mode de paiement
Lors du passage à la caisse, le client choisit l'option « Pay by Bank » parmi les modes de paiement disponibles dans Shopware.
Redirection vers la passerelle Lodin
Après validation de la commande, le client est automatiquement redirigé vers la passerelle de paiement sécurisée Lodin. Il sélectionne sa banque et valide son paiement instantané.
Traitement du paiement (webhook)
Une fois le paiement effectué, Lodin envoie une notification (webhook) au plugin Shopware. Le plugin met alors à jour automatiquement le statut de la transaction :
- Succès : statut
paid - Échec : statut
failed
Retour sur la boutique
Le client est ensuite redirigé vers la boutique Shopware :
- En cas de succès : page de confirmation de commande, affichant les détails de la transaction.
- En cas d'échec : page de paiement avec un message d'erreur lui permettant de réessayer ou de choisir un autre moyen de paiement.
L'intégration du plugin Lodin pour Shopware est désormais pleinement opérationnelle.
Architecture
| Sujet | Implémentation Shopware 6 |
|---|---|
| Enregistrer la méthode de paiement | PaymentMethodEntity |
| Initiation du paiement | Méthode pay() du handler de paiement |
| État commande : en attente | Machine à états → in_progress |
| État commande : payée | Machine à états → paid |
| Endpoint webhook | Contrôleur personnalisé via @Route |
| Endpoint de retour | Méthode finalize() du handler |
| Configuration | SystemConfigService |