Aller au contenu principal

Shopware 5

Ce guide décrit comment intégrer Sezzle dans votre site Web Shopware 5 afin que vous puissiez fournir Sezzle comme option de paiement à vos clients. De plus, il comprend des étapes pour mettre à niveau les intégrations existantes vers la dernière version du plugin.

Le plugin Shopware 5 de Sezzle peut être Télécharger depuis github.

Après avoir intégré Sezzle, votre site sera:

  • Offrez Sezzle comme option de paiement sur la page de paiement.
  • Retourne les paiements Sezzle de votre backend de votre magasin 5.
  • Autoriser et capturer les paiements.
  • Offrez une capture instantanée et retardée.

Présentation des étapes d'intégration

  1. Installer et configurer le sezue Plugin Shopware 5
  2. Testez votre intégration

Avant que tu commences

  1. Vous devriez avoir un compte marchand Sezzle.
  2. Assurez-vous que vous avez les détails Sezzle suivants à portée de main.
  3. Familiarisez-vous avec le flux de transaction lors de l'achat avec Sezzle.

Installez le plugin Sezzle Shopware 5

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

Utilisation du compositeur

Accédez au répertoire d'installation de Shopware 5, puis exécutez les commandes ci-dessous:

  1. Ouvrir le terminal et naviguer vers Shopware chemin racine.
  2. Exécutez la commande ci-dessous pour l'ajout du plugin dans votre base de code: composer require sezzle/shopware5

Méthode manuelle

  1. Téléchargez le fichier .zip ou tar.gz depuis Sezzle's Référentiel GitHub.
  2. Décompressez le fichier.
  3. Aller vers Shopware [Shopware]/custom/plugins/ à travers SFTP ou SSH.
  4. Copie SwagPaymentSezzle Répertoire du dossier unzipped à [Shopware]/custom/plugins/.
  5. Se connecter à Shopware 5 Backend et naviguer vers configuration > Gestionnaire de plugins > Gestion > Installée.
  6. Trouver Sezzle du Désinstallé liste et cliquez sur le + bouton pour installer le plugin.
  7. Une fois installée, vous verrez Sezzle sous inactive liste. Clique sur le x bouton pour activer le plugin.
  8. Après une activation réussie, vous pourrez voir Sezzle sous configuration > méthodes de payement.

Améliorer le plugin Shopware 5

Utilisation du compositeur

  1. Modifier le numéro de version du sezzle/sezzlepay à l'intérieur composer.json.
  2. Ouvrir le terminal et naviguer vers Shopware chemin racine.
  3. Exécutez la commande suivante pour la mise à jour du plugin vers une version plus récente: composer update sezzle/sezzlepay

Méthode manuelle

  1. Téléchargez le fichier .zip ou tar.gz depuis Sezzle's Référentiel GitHub.
  2. Décompressez le fichier.
  3. Supprimer le contenu de [Shopware]/custom/plugins/SwagPaymentSezzle.
  4. Copier le contenu de SwagPaymentSezzle Répertoire du dossier unzipped à [Shopware]/custom/plugins/SwagPaymentSezzle/.
  5. Se connecter à Shopware Backend et naviguer vers configuration > cache/performance.
  6. Rincer le stockage du cache en sélectionnant Cache d'atelier clair.

Configurer Sezzle

Configuration de paiement

  • Assurez-vous que vous avez le Uuid marchand et le Clés API du Tableau de bord marchand de Sezzle. Vous devez être enregistré avec Sezzle Pour accéder au tableau de bord marchand.
  • Aller vers Clientes > Paiements > Sezzle > Paramètres dans ton Shopware backend.
  • Activer Sezzle en vérifiant le Activer pour cette boutique cocher.
  • Met le Clé publique et Clé privée.
  • Pour les tests, activez le mode sandbox en vérifiant le Activer Sandbox cocher.
  • Vous pouvez également vérifier votre Clés API en cliquant sur le Tester les paramètres de l'API bouton.
  • Met le Uuid marchand.
  • Met le Emplacement du marchand Selon l'origine du magasin.
  • Vérifier la Activer la tokenisation Cochez pour activer la tokenisation client dans la caisse de Sezzle. Si le client accepte d'être tokenisé, les futurs paiements pour ce client ne nécessiteront pas de redirection vers Sezzle. Voir Tokenisation du client
  • Ensemble Action de paiement comme Autoriser uniquement pour faire l'autorisation de paiement uniquement et Autoriser et capturer pour faire une capture instantanée. Importante: Voir Autoriser uniquement vs autoriser et capturer Pour plus de détails sur la différence entre les deux choix.
  • Vérifier la Activer le widget dans PDP cocher box pour ajouter le script du widget et le Widget Sezzle Modal à la page d'affichage du produit.
  • Vérifier la Activer le widget dans le panier cocher box pour ajouter le script du widget et le Widget Sezzle Modal à la page CART.
  • Vérifier la Afficher les erreurs cocher la case pour l'affichage Sezzle Code d'erreur associé dans l'URL Web en cas de défaillance.
  • Ensemble Enregistrement à ERREUR Pour enregistrer uniquement les messages d'erreur ou TOUTE Pour enregistrer tous les messages, y compris les erreurs, les avertissements et les avis.
  • Enregistrez les paramètres et effacez le cache. settings

Votre magasin est maintenant prêt à accepter les paiements via Sezzle.

Fonctionnalité frontal

  • Si vous avez installé avec succès le plugin Sezzle, Sezzle sera inclus comme mode de paiement dans la page de paiement.
  • Sélectionner Sezzle et continue.
  • Une fois que vous avez cliqué Paiement complet, vous serez redirigé vers Sezzle COSSE Pour terminer le paiement.Remarque: Si votre compte est déjà tokenisé, sautez les deux étapes suivantes car vous ne serez pas redirigé vers Sezzle.
  • [Facultative] Sur la dernière page de la caisse de Sezzle, vérifiez le Approuver {Nom du magasin} Pour traiter les paiements à partir de votre compte Sezzle pour les transactions futures.Vous pouvez révoquer cette autorisation à tout moment dans votre tableau de bord Sezzle pour tokenize votre compte.
  • Enfin, cliquez sur Complétez la commande Pour terminer votre achat.
  • Sur le placement réussi, vous serez redirigé vers la page de confirmation de commande. checkout

Capture de paiement

  • Si Action de paiement est réglé sur Autoriser et capturer, La capture sera effectuée instantanément à partir du plugin après la création et la validation de la commande Shopware.
  • Si Action de paiement est réglé sur Autoriser, La capture doit être effectuée manuellement à partir du backend «Shopware».Suivez les étapes ci-dessous à capturer.
  • Allez la commande et cliquez sur Sezzle languette.
  • Entrez une valeur en Montante champ et cliquez sur Capturer Pour capturer le paiement dans Sezzle.

Remboursement

  • Allez la commande et cliquez sur Sezzle languette.
  • Entrez une valeur en Montante champ et cliquez sur Remboursement Pour rembourser le paiement dans Sezzle.

Verser le paiement

  • Allez la commande et cliquez sur Sezzle languette.
  • Entrez une valeur en Montante champ et cliquez sur Libérer pour libérer le paiement dans Sezzle.

Commandez la vérification dans Backware Backend

Les commerçants doivent toujours vérifier l'état de paiement et le montant de toutes les commandes.Les étapes suivantes garantissent que chaque action est terminée comme prévu.

  • Se connecter à Shopware administrer et naviguer vers Clientes > Ordres. orders

  • Procéder à l'ordre correspondant.

  • Le paiement est capturé avec succès par Sezzle quand:

  • L'état de paiement actuel est Complètement payé.

  • Capture du montant est égal au Montant de l'automne.

  • Le paiement n'est autorisé que lorsque:

  • L'état de paiement actuel est Ouvrir.

  • Amontant est égal au Montant de la commande.

  • Capture du montant équivaut à 0.

  • Le paiement est remboursé lorsque:

  • L'état de paiement actuel est Recommandation.

  • Montant du remboursement est égal ou inférieur au Capture du montant.

  • Le paiement est publié quand:

  • L'état de paiement actuel est Le processus est annulé pour une version complète ou ouverte pour une version partielle.

  • Le montant sera déduit de Montant de l'automne et devrait apparaître dans Montant libéré. order-sezzle-tab

Vérification de la commande dans le tableau de bord marchand de Sezzle

  • Se connecter à Tableau de bord marchand de Sezzle et naviguer vers Ordres.
  • Procéder à l'ordre correspondant.
  • Le paiement capturé avec succès a un statut de Approuvée.
  • Le paiement autorisé mais non capturé a un statut de Autorisé, non capturé.
  • Payment refunded has a status of Refunded or Partially refunded.
  • Payment released or not captured before the authorization expired has a status of Deleted due to checkout not being captured before expiration.

Customer Tokenization Details

  • Log in to Shopware Backend and navigate to Customers > Customers.
  • Select customer to view tokenization details.
  • Sezzle Customer UUID, Sezzle Customer UUID Expiry and Sezzle Customer UUID Status will appear under Free text fields. customer

Valider

Parcourir un caisse de test pour valider l'intégration est correctement installé.

Dépannage

  • Sezzle le plugin crée des journaux de Sezzle action.
  • Dans le cas où Succès des marchands et Soutien Les équipes ne sont pas en mesure de résoudre aucun problème, le marchand peut demander que ces journaux soient transmis à la Intégrations de plate-forme équipe pour un dépannage supplémentaire.
  • Les journaux sont nommés comme plugin_dev-<current-date>.log. Pour faciliter le dépannage, nous vous recommandons d'envoyer le core_dev-<current-date>.log aussi..
  • Les journaux peuvent être trouvés dans [Shopware]/var/log/.