Shopware 5

Ce guide explique comment ajouter Sezzle comme option de paiement sur votre site Shopware 5, permettant aux clients d’utiliser Sezzle lors du paiement. De plus, il inclut les étapes pour mettre à niveau les intégrations existantes vers la dernière version du plugin.

​

Installer le plugin Sezzle Shopware 5

Dans la section suivante, [Shopware] fait référence à votre répertoire racine Shopware 5.

​

Utilisation du Composer

Allez dans le répertoire d’installation de Shopware 5, puis exécutez les commandes ci-dessous :

1. Ouvrez le terminal et naviguez vers le Shopware chemin racine
2. Exécutez la commande ci-dessous pour ajouter le plugin à votre base de code
   Copier

   Demander à l'IA

   composer require sezzle/shopware5
   

​

Méthode manuelle

1. Téléchargez le fichier .zip ou tar.gz depuis le dépôt GitHub de Sezzle
2. Décompressez le fichier
3. Naviguez vers Shopware [Shopware]/custom/plugins/ soit via SFTP ou SSH
4. Copiez le répertoire SwagPaymentSezzle du dossier décompressé vers [Shopware]/custom/plugins/
5. Connectez-vous au backend de Shopware 5 et naviguez vers Configuration > Plugin Manager > Management > Installed
6. Trouvez Sezzle dans la liste Uninstalled et cliquez sur le bouton + pour installer le plugin
   • Une fois installé, vous verrez Sezzle sous la liste Inactive
7. Cliquez sur le bouton x pour activer le plugin
   • Après une activation réussie, vous pourrez voir Sezzle sous Configuration > Payment Methods

​

Mettre à niveau le plugin Shopware 5

​

Utilisation du Composer

1. Changez le numéro de version du sezzle/sezzlepay dans composer.json
2. Ouvrez le terminal et naviguez vers le Shopware chemin racine
3. Exécutez la commande suivante pour mettre à jour le plugin vers une version plus récente
   Copier

   Demander à l'IA

   composer update sezzle/sezzlepay
   

​

Méthode manuelle

1. Téléchargez le fichier .zip ou tar.gz depuis le dépôt GitHub de Sezzle
2. Décompressez le fichier
3. Supprimez le contenu de [Shopware]/custom/plugins/SwagPaymentSezzle
4. Copiez le contenu du répertoire SwagPaymentSezzle du dossier décompressé vers [Shopware]/custom/plugins/SwagPaymentSezzle/
5. Connectez-vous au backend de Shopware et naviguez vers Configuration > Cache/performance
6. Videz le cache de stockage en sélectionnant Clear shop cache

​

Configurer Sezzle

​

Configuration de paiement

1. Assurez-vous d’avoir l’UUID du marchand et les clés API depuis le Tableau de bord marchand Sezzle
   Vous devez être inscrit auprès de Sezzle pour accéder au Tableau de bord marchand
2. Naviguez vers Customers > Payments > Sezzle > Settings dans votre backend Shopware
3. Activez Sezzle en cochant la case Enable pour cette boutique
4. Définissez la Clé Publique et la Clé Privée
5. Pour les tests, activez le mode Sandbox en cochant la case Enable sandbox
   Vous pouvez également vérifier votre API Keys en cliquant sur le bouton Test API Settings
6. Définissez l’UUID du marchand
7. Définissez l’emplacement du marchand selon l’origine du magasin
8. Cochez la case Enable Tokenization pour activer la tokenisation client dans le paiement Sezzle
   • Si le client accepte d’être tokenisé, les futurs paiements pour ce client ne nécessiteront pas de redirection vers Sezzle
   • Voir Tokenisation client
9. Définissez Payment Action comme Authorize only pour effectuer uniquement l’autorisation de paiement et Authorize and Capture pour effectuer une capture instantanée
   Voir Autoriser uniquement vs Autoriser et capturer pour plus de détails sur la différence entre les deux choix
10. Cochez la case Enable Widget in PDP pour ajouter le script du widget et le Modal Widget Sezzle à la page d’affichage du produit
11. Cochez la case Enable Widget in Cart case à cocher pour ajouter le script du widget et le Modal Widget Sezzle à la Page du Panier
12. Cochez la Display errors case à cocher pour afficher le code d’erreur lié à Sezzle dans l’URL web en cas d’échec
13. Définir Logging à ERROR pour enregistrer uniquement les messages d’erreur ou ALL pour enregistrer tous les messages, y compris les erreurs, les avertissements et les notifications
14. Enregistrez les paramètres et videz le cache
    
    Votre boutique est maintenant prête à accepter les paiements via Sezzle !

​

Fonctionnalité Frontend

• Si vous avez installé avec succès le plugin Sezzle, alors Sezzle sera inclus comme méthode de paiement dans la page de paiement.

1. Sélectionnez Sezzle et continuez
2. Une fois que vous cliquez sur Complete Payment, vous serez redirigé vers Sezzle Checkout pour finaliser le paiement
   Si votre compte est déjà tokenisé, ignorez les deux étapes suivantes car vous ne serez pas redirigé vers Sezzle
3. [Facultatif] Sur la dernière page de Sezzle Checkout, cochez la Approve {Store Name} pour traiter les paiements depuis votre compte Sezzle pour les transactions futures
   • Vous pouvez révoquer cette autorisation à tout moment dans votre Tableau de bord Sezzle pour tokeniser votre compte
4. Cliquez sur Complete Order pour finaliser votre achat
   • Après avoir passé la commande avec succès, vous serez redirigé vers la page de confirmation de commande
     

​

Capture du Paiement

Si l’Action de Paiement est définie sur Autoriser et Capturer

• La capture sera effectuée instantanément depuis le plugin après que la commande soit créée et validée dans Shopware

Si l’Action de Paiement est définie sur Autoriser

• La capture doit être effectuée manuellement depuis le backend Shopware. Suivez les étapes ci-dessous pour capturer :
  1. Allez à la commande et cliquez sur l’onglet Sezzle
  2. Entrez une valeur dans le champ Amount
  3. Cliquez sur Capture pour capturer le paiement dans Sezzle

​

Remboursement du Paiement

1. Allez à la commande et cliquez sur l’onglet Sezzle
2. Entrez une valeur dans le champ Amount
3. Cliquez sur Refund pour rembourser le paiement dans Sezzle

​

Libération du Paiement

1. Allez à la commande et cliquez sur l’onglet Sezzle
2. Entrez une valeur dans le champ Amount
3. Cliquez sur Release pour libérer le paiement dans Sezzle

​

Vérification des Commandes dans le Backend Shopware

Les marchands doivent toujours vérifier le statut de paiement et le montant de toutes les commandes. Les étapes suivantes garantissent que chaque action a été effectuée comme prévu.

1. Connectez-vous à l’administration Shopware et naviguez vers Customers > Orders
   
2. Accédez à la commande correspondante
   • Le paiement est capturé avec succès par Sezzle quand
     • Current Payment Status = Completely Paid
     • Capture Amount = Auth Amount
   • Le paiement est seulement autorisé quand
     • Current Payment Status = Open
     • Auth Amount = Order Amount
     • Capture Amount = 0
   • Le paiement est remboursé quand
     • Current Payment Status = Re-crediting
     • Refund Amount =< Capture Amount
   • Le paiement est libéré quand
     • Current Payment Status = The process is cancelled for a full release or Open for a partial release
     • Le montant sera déduit de Auth Amount et devrait apparaître dans Released Amount
     

​

Vérification des Commandes dans le Tableau de Bord Marchand Sezzle

1. Connectez-vous au Tableau de Bord Marchand Sezzle et naviguez vers Orders
2. Accédez à la commande correspondante

   Statut du Paiement	Description
   Approuvé	Paiement capturé avec succès
   Autorisé, non capturé	Paiement autorisé mais non capturé
   Remboursé ou Partiellement Remboursé	Paiement remboursé
   Supprimé car le paiement n’a pas été capturé avant expiration	Paiement libéré ou non capturé avant l’expiration de l’autorisation

​

Détails de Tokenisation du Client

1. Connectez-vous au Backend Shopware et naviguez vers Customers > Customers
2. Sélectionnez le client pour voir les détails de tokenisation
   • Sezzle Customer UUID, Sezzle Customer UUID Expiry et Sezzle Customer UUID Status apparaîtront sous Free text fields
     

​

Valider

Effectuez un paiement test pour valider que l’intégration est correctement installée

​

Dépannage

• Sezzle plugin crée des journaux de Sezzle action
• Dans le cas où les équipes de Support et de Réussite Marchande ne parviennent pas à résoudre un problème, le Marchand peut demander que ces journaux soient transmis à l’équipe d’Intégrations de Plateforme pour un dépannage plus approfondi
• Les journaux sont nommés comme plugin_dev-<current-date>.log
• Pour faciliter le dépannage, nous recommandons d’envoyer également le core_dev-<current-date>.log aussi
• Les journaux peuvent être trouvés dans [Shopware]/var/log/