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
Avant que tu commences
- Vous devriez avoir un compte marchand Sezzle.
- Veuillez visiter notre page d'inscription Si vous n'avez pas de compte.
- Assurez-vous que vous avez les détails Sezzle suivants à portée de main.
- 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:
- Ouvrir le terminal et naviguer vers
Shopware
chemin racine. - Exécutez la commande ci-dessous pour l'ajout du plugin dans votre base de code:
composer require sezzle/shopware5
Méthode manuelle
- Téléchargez le fichier .zip ou tar.gz depuis
Sezzle's
Référentiel GitHub. - Décompressez le fichier.
- Aller vers
Shopware
[Shopware]/custom/plugins/
à traversSFTP
ouSSH
. - Copie
SwagPaymentSezzle
Répertoire du dossier unzipped à[Shopware]/custom/plugins/
. - Se connecter à
Shopware 5
Backend et naviguer versconfiguration > Gestionnaire de plugins > Gestion > Installée
. - Trouver
Sezzle
duDésinstallé
liste et cliquez sur le+
bouton pour installer le plugin. - Une fois installée, vous verrez
Sezzle
sousinactive
liste. Clique sur lex
bouton pour activer le plugin. - Après une activation réussie, vous pourrez voir
Sezzle
sousconfiguration > méthodes de payement
.
Améliorer le plugin Shopware 5
Utilisation du compositeur
- Modifier le numéro de version du
sezzle/sezzlepay
à l'intérieurcomposer.json
. - Ouvrir le terminal et naviguer vers
Shopware
chemin racine. - Exécutez la commande suivante pour la mise à jour du plugin vers une version plus récente:
composer update sezzle/sezzlepay
Méthode manuelle
- Téléchargez le fichier .zip ou tar.gz depuis
Sezzle's
Référentiel GitHub. - Décompressez le fichier.
- Supprimer le contenu de
[Shopware]/custom/plugins/SwagPaymentSezzle
. - Copier le contenu de
SwagPaymentSezzle
Répertoire du dossier unzipped à[Shopware]/custom/plugins/SwagPaymentSezzle/
. - Se connecter à
Shopware
Backend et naviguer versconfiguration > cache/performance
. - 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 leClé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 tonShopware
backend. - Activer
Sezzle
en vérifiant leActiver pour cette boutique
cocher. - Met le
Clé publique
etClé 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 leTester 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
commeAutoriser uniquement
pour faire l'autorisation de paiement uniquement etAutoriser 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 leWidget 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 leWidget Sezzle
Modal à la page CART. - Vérifier la
Afficher les erreurs
cocher la case pour l'affichageSezzle
Code d'erreur associé dans l'URL Web en cas de défaillance. - Ensemble
Enregistrement
àERREUR
Pour enregistrer uniquement les messages d'erreur ouTOUTE
Pour enregistrer tous les messages, y compris les erreurs, les avertissements et les avis. - Enregistrez les paramètres et effacez le cache.
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é versSezzle 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.
Capture de paiement
- Si
Action de paiement
est réglé surAutoriser et capturer
, La capture sera effectuée instantanément à partir du plugin après la création et la validation de la commandeShopware
. - Si
Action de paiement
est réglé surAutoriser
, 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 surCapturer
Pour capturer le paiement dansSezzle
.
Remboursement
- Allez la commande et cliquez sur
Sezzle
languette. - Entrez une valeur en
Montante
champ et cliquez surRemboursement
Pour rembourser le paiement dansSezzle
.
Verser le paiement
- Allez la commande et cliquez sur
Sezzle
languette. - Entrez une valeur en
Montante
champ et cliquez surLibérer
pour libérer le paiement dansSezzle
.
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 versClientes > Ordres
. -
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 auMontant de l'automne
. -
Le paiement n'est autorisé que lorsque:
-
L'état de paiement actuel est
Ouvrir
. -
Amontant
est égal auMontant 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 auCapture 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 dansMontant libéré
.
Vérification de la commande dans le tableau de bord marchand de Sezzle
- Se connecter à
Tableau de bord marchand de Sezzle
et naviguer versOrdres
. - 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
orPartially 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 toCustomers > Customers
. - Select customer to view tokenization details.
Sezzle Customer UUID
,Sezzle Customer UUID Expiry
andSezzle Customer UUID Status
will appear underFree text fields
.
Valider
Parcourir un caisse de test pour valider l'intégration est correctement installé.
Dépannage
Sezzle
le plugin crée des journaux deSezzle
action.- Dans le cas où
Succès des marchands
etSoutien
Les équipes ne sont pas en mesure de résoudre aucun problème, le marchand peut demander que ces journaux soient transmis à laInté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 lecore_dev-<current-date>.log
aussi.. - Les journaux peuvent être trouvés dans
[Shopware]/var/log/
.