Shopware
Introduction
Notre plug-in Shopware est livré avec des mises à jour régulières et un support d'intégration complet, offrant une solution polyvalente prête à l'emploi pour accepter facilement les paiements en ligne :
- Prend en charge la méthode d'intégration Hosted Checkout Page.
- Offre les méthodes de paiement suivantes sur notre plateforme :
Alipay+
American Express
Apple Pay
Bancontact
Bizum
Carte Bancaire
Diners Club
Discover
iDEAL
Illicado
Intersolve
JCB
Maestro
MasterCard
Multibanco
PayPal
Visa
WeChat Pay
Gardez un œil sur nos notes de version pour rester informé des mises à jour et des nouvelles fonctionnalités (c'est-à-dire méthodes de paiement, fonctionnalités, méthodes d'intégration) que nous avons ajoutées à ce plugin !
Consultez notre documentation pour savoir comment lier votre boutique à notre plateforme afin de profiter de toutes ces fonctionnalités !
Télécharger le pluginTélécharger des versions antérieures
Création de compte
Pour réaliser des transactions avec ce plugin, vous avez besoin d'un compte sur notre plateforme.
Ce plugin fonctionne à la fois avec notre environnement de test et de production. Un compte de test est un excellent moyen de vous familiariser avec le plugin et notre plateforme. Une fois que vous souhaitez passer en production, contactez-nous !
Installation
Installation
Installation
La première étape pour utiliser le plugin est le processus d'installation. Avant de continuer, assurez-vous que votre infrastructure réponde à ces exigences système :
| Élément | Description |
|---|---|
| Package du plugin | |
| Identifiants Direct |
|
| Shopware |
Ce plugin prend en charge la version v6.4.x.x et supérieure de Shopware |
| Conformité PCI |
SAQ A |
Une fois terminé, suivez ces étapes :
- Connectez-vous au back-office de Shopware. Allez à Extensions > Mes extensions > Télécharger l'extension.
- Cliquez sur le bouton "Télécharger l'extension". Cliquez sur "Confirmer" dans le menu contextuel et téléchargez le package.
- Une fois installé, entrez "Worldline Global Online Pay" dans la barre de recherche “Trouver une extension… “. Activez l'extension à l'aide du curseur.
Configuration
Configuration
Après l'installation, vous devez configurer le plugin pour lier votre boutique à notre plateforme.
- Connectez-vous au Back Office de Shopware. Allez à Extensions > Mes extensions > Apps.
- Entrez "Worldline Global Online Pay" dans la barre de recherche "Trouver une extension…".
| Propriété | Description/Actions |
|---|---|
| Canal de vente |
Définissez si vous souhaitez appliquer les paramètres globalement pour toutes vos boutiques ("Tous les canaux de vente") ou pour une boutique individuelle (sélectionnez celle appropriée dans la liste déroulante). Si vous sélectionnez une boutique individuelle, vous pouvez hériter de toute valeur de propriété des paramètres globaux que vous avez configurés dans "Tous les canaux de vente". Pour ce faire, cliquez sur "Restaurer l'héritage" sur le symbole de lien pour l'une des propriétés disponibles. |
| Merchant Id |
Saisissez votre PSPID test/production depuis notre plateforme que vous souhaitez utiliser pour le traitement des transactions. |
| API Key |
Saisissez la API Key test/production de votre PSPID de test ou production. Lisez notre guide dédié pour apprendre comment en générer une. |
| API Secret |
Saisissez le API Secret test/production de votre PSPID de test ou production. Lisez notre guide dédié pour apprendre comment en générer un. |
| Webhook key |
Saisissez la webhooks Key de votre PSPID test/production depuis le Merchant Portal comme décrit dans notre guide dédié. |
| Webhook secret |
Saisissez le webhooks Secret de votre PSPID test/production depuis le Merchant Portal comme décrit dans notre guide dédié. |
| Live endpoint |
https://payment.direct.worldline-solutions.com |
| Sandbox endpoint |
https://payment.preprod.direct.worldline-solutions.com |
| Is live mode |
(Dés-)Cochez pour lier votre boutique à l'environnement respectif. En fonction de votre sélection, le module de la boutique enverra les demandes de transaction à l'environnement test ou production.
|
| Payment Methods |
Définissez quelles méthodes de paiement sont disponibles pour vos clients sur la Hosted Checkout Page
Assurez-vous d'utiliser le bouton "Enregistrer" dédié pour cette propriété afin de confirmer vos paramètres de méthode de paiement. |
| Automatic capture |
Définissez si vous souhaitez traiter les transactions en mode autorisation ou en Direct Sale. Sélectionnez l'une des options suivantes qui correspond à vos besoins commerciaux :
Si vous réglez cette propriété sur "Désactivé", attention aux points suivants :
|
- Cliquez sur le bouton « Enregistrer » en haut de l'écran pour confirmer vos paramètres.
- Cliquez sur le bouton "Test de connexion" pour vérifier la configuration en établissant une connexion de test entre le plugin et notre plateforme. Assurez-vous que le message "La connexion a été testée avec succès" apparaisse dans la fenêtre contextuelle. S'il indique un échec du test, suivez ces étapes :
a) Vérifiez la API Key/Secret et/ou Webhook Key/Secret et (re)configurez-les sur notre plateforme/dans le Back Office Shopware.
b) Si le test de connexion échoue encore, contactez votre administrateur système pour obtenir de l'aide.
- Soyez conscient que vous ne pouvez configurer ces propriétés que pour un seul environnement à la fois.
- Assurez-vous de :
- Remplacer toutes les informations d'identification de test par des informations d'identification en production / indiquer "Is live mode" dès que vous avez finalisé vos tests.
- Ne pas confondre les données de test/production et vice versa lors de la configuration de ces propriétés dans le module.
Gérer les paiements
Gérer les paiements
Nous avons conçu le plugin pour suivre automatiquement et de manière autonome vos commandes, vous libérant ainsi de l'administration impliquée. Apprenez ici comment utiliser efficacement notre plugin, ce qui pourrait aider votre entreprise à prospérer !
Effectuer des opérations de maintenance
Les captures, remboursements et annulations d'autorisations sont des processus standard (opérations de maintenance) dans votre logique métier quotidienne. Apprenez ici comment effectuer ces opérations directement dans le Back Office de Shopware :
- Connectez-vous au Back Office de Shopware. Allez dans Commandes > Vue d'ensemble. Cliquez sur la commande dans le tableau.
- Dans la vue d'ensemble de la commande, allez à Contrôle des transactions Worldline. En fonction du statut de la commande (colonne "Statut du paiement" dans Commandes > Vue d'ensemble), les boutons suivants sont fonctionnels:
Statut de commande Worldline / Shopware Boutons disponibles statusOutput.statusCode=5 / Autorisé - "Capturer le paiement": Capturer le montant autorisé pour recevoir les fonds de la commande.
- "Annuler le paiement": Annuler le montant autorisé.
statusOutput.statusCode=9 / Payé - "Rembourser le paiement": Rembourser les fonds de la commande.
N'importe quel statut "Vérifier le statut": Envoyer une demande de mise à jour de statut à notre plateforme pour obtenir son statut actuel.
Effectuer des transactions de test
Utilisez l'environnement de test de notre plateforme pour vous assurer que votre plugin fonctionne comme prévu. Nous offrons des jeux de données de test sur notre page dédiée Cas de test. Ciblez notre environnement de test comme décrit dans la section "Configurer le plugin".
Assurez-vous de passer vers l'environnement de production dès que vous avez finalisé vos tests.