Magento
Introduction
Notre plug-in Magento est fourni 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 les modes d'intégration suivantes :
- Hosted Checkout Page : Redirigez vos clients vers le CAWL ecommerce pour utiliser n'importe laquelle de nos méthodes de paiement disponibles.
- Hosted Tokenization Page : Incluez un iFrame dans votre page de paiement pour les paiements par carte.
- Redirect Payments : Permettez à vos clients de choisir leur méthode de paiement préférée directement sur votre page de paiement en introduisant des boutons de paiement uniques.
- Offers the following payment methods on our platform:
American Express
Apple Pay
Bancontact
Cartes Bancaires
Cpay
Diners Club
Discover
EPS
Google Pay
iDEAL
Illicado
Intersolve
JCB
Klarna Bank Transfer
Klarna Direct Debit
Klarna Financing
Klarna Pay Later
Klarna Pay Now
Maestro
Mastercard
Multibanco
Oney 3x-4x
Oney Financement Long
OneyBrandedGiftCard
PayPal
Przelewy24
Twint
Union Pay International
Visa
WeChat Pay
Gardez un œil sur notre Release Notes pour rester informé des mises à jour et des nouvelles fonctionnalités (c'est-à-dire méthodes de paiement, fonctionnalités, modes d'intégration) que nous avons ajoutées à ce plugin !
Consultez notre documentation pour savoir comment lier votre boutique à notre plateforme et profiter de toutes ces fonctionnalités !
Création de compte
Pour traiter des transactions avec ce plugin, vous avez besoin d'un compte sur notre plateforme.
Ce plugin fonctionne à la fois avec nos environnements de test et de production. Un compte de test est un excellent moyen de vous familiariser avec le plugin et notre plateforme. Lorsque vous souhaitez passer en production, contactez-nous !
Installation
Exigences
Avant de procéder au processus d'installation, assurez-vous que votre infrastructure répond à ces exigences système :
Compatibilité :
|
Plugin Magento |
Version Magento |
2.4 |
Version PHP |
7.4 – 8.2 |
Compatibilité avec des tiers :
|
Plugin Magento |
Thème Hyvä |
>= 1.1.12 |
Hyvä Checkout |
>= 1.1.15 |
* derniers tests effectués avec Checkout 1.2.0 avec Theme 1.2.9
Note : Un package supplémentaire est nécessaire pour assurer la compatibilité entre notre plugin et les thèmes Hyva ainsi que les produits de Checkout. Veuillez vous référer aux instructions ci-dessous pour plus de détails.
Téléchargements :
|
Plugin Magento |
Télécharger le dernier plugin |
Télécharger ici |
Télécharger le package Hyvä (optionnel) |
Télécharger ici |
Autres exigences :
Article |
Description |
Identifiants CAWL ecommerce |
|
Installer le plugin
La première étape pour utiliser le plugin est le processus d'installation. Avant de commencer, assurez-vous que votre infrastructure répond à ces exigences système. Une fois cela fait, consultez les chapitres dédiés pour soit :
Installer le plugin complet
Choisissez l'un des modes d'installation pour installer le plugin complet :
Nous vous recommandons vivement d'installer la solution sur un serveur de développement ou de préproduction pour vous assurer qu'elle fonctionne correctement pour votre instance avant de la passer en production.
Installer depuis le Marketplace Adobe (recommandé)
Suivez ces étapes telles qu'expliquées dans le tutoriel Adobe :
- Accédez à la connexion du Marketplace (ou inscrivez-vous) et téléchargez l'extension.
- Spécifiez les clés d'authentification.
- Exécutez la commande composer pour installer les packages :
composer require worldline/module-magento-payment
Cette commande installe les solutions suivantes :
Hosted Tokenization Page (Carte de Crédit)
Hosted Checkout Page (Checkout Hébergé)
Boutons de paiement uniques (Paiements par Redirection) - Exécutez les commandes magento pour terminer l'installation :
bin/magento setup:upgrade bin/magento setup:di:compile bin/magento setup:static-content:deploy
Installer depuis GitHub
Suivez ces étapes :
- Spécifiez les dépôts
composer config repositories.worldline/module-magento-payment git https://github.com/wl-online-payments-direct/plugin-magento.git composer config repositories.worldline/module-magento-payment-core git https://github.com/wl-online-payments-direct/plugin-magento-core.git composer config repositories.worldline/module-magento-payment-hostedcheckout git https://github.com/wl-online-payments-direct/plugin-magento- hostedcheckout.git composer config repositories.worldline/module-magento-payment-redirectpayment git https://github.com/wl-online-payments-direct/plugin-magento-redirect- payments.git composer config repositories.worldline/module-magento-payment-creditcard git https://github.com/wl-online-payments-direct/plugin-magento-creditcard.git composer config repositories.worldline/module-magento-payment-graph-ql git git@github.com:wl-online-payments-direct/plugin-magento-graph-ql.git
- Exécutez la commande composer pour installer les packages :
composer require worldline/module-magento-payment
Cette commande installe les solutions suivantes :
Hosted Tokenization Page (Carte de Crédit)
Hosted Checkout Page (Checkout Hébergé)
Boutons de paiement uniques (Paiements par Redirection) - Exécutez les commandes magento pour terminer l'installation :
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
Installer une solution de paiement spécifique
L'architecture de notre plugin vous permet également d'installer la solution de paiement souhaitée au lieu du plugin complet. Cela vous permet, par exemple, de n'installer que "Checkout Hébergé" et de passer l'intégration "Carte de Crédit".
Au lieu d'exécuter la commande pour l'installation complète via soit Adobe Marketplace ou GitHub, modifiez-la en conséquence :
Version souhaitée | Commande exécutable |
---|---|
Solution de paiement "Carte de Crédit" |
|
Solution de paiement "Checkout Hébergé" |
|
Solution de paiement "Redirection (bouton unique)" |
|
worldline/module-magento-payment-graph-ql |
|
La solution de paiement "Redirection (bouton unique)" installera également la solution de paiement "Checkout Hébergé" car elle en dépend.
Installer le Thème Hyvä et le package Hyvä Checkout
- Si vous utilisez individuellement le Thème Hyvä ou le Hyvä Checkout, ou les deux, veuillez vous assurer qu'ils sont installés avec une licence valide. De plus, notre plugin doit également être installé avant de continuer.
- Exécutez la commande suivante. Le chemin donné est un chemin serveur complet du dossier contenant le package avec l'extension :
composer config repositories.worldline/module-magento-theme-hyva git git@github.com:wl-online-payments-direct/plugin-magento-hyva.git
Lisez notre chapitre dédié avec des instructions détaillées pour installer le module. - Exécutez la commande composer pour installer le package.
composer require worldline/module-magento-theme-hyva
Cette commande installe les solutions suivantes :
Carte de crédit
Paiement hébergé
Paiements redirigés (bouton unique)
Module Hyva pour les solutions Worldline - Exécutez les commandes Magento pour terminer l'installation.
bin/magento setup:upgrade bin/magento setup:di:compile bin/magento setup:static-content:deploy
Mettre à jour le plugin
En fonction de si vous avez installé le plugin complet ou seulement des solutions de paiement spécifiques, la commande exécutable diffère :
Version installée | Commande exécutable |
---|---|
worldline/module-magento-payment |
|
worldline/module-magento-payment-credit-card |
|
worldline/module-magento-payment-hosted-checkout |
|
worldline/module-magento-payment-redirect-payment |
|
Désinstaller le plugin
Nous vous recommandons vivement de créer une sauvegarde de la base de données avant d'exécuter cette action.
Pour désinstaller le plugin avec toutes les données associées, exécutez la commande suivante :
composer remove worldline/module-magento-payment
Alternativement, vous pouvez utiliser la commande suivante :
composer remove worldline/module-magento-payment \
worldline/module-magento-payment-core \
worldline/module-magento-payment-credit-card \
worldline/module-magento-payment-hosted-checkout \
worldline/module-magento-payment-redirect-payment \
worldline/module-magento-recurring-payments \
worldline/module-magento-payment-graph-ql
Pour supprimer les extensions avec leurs données associées, veuillez utiliser la commande suivante :
bin/magento module:uninstall \
Worldline_Payment \
Worldline_PaymentCore \
Worldline_CreditCard \
Worldline_HostedCheckout \
Worldline_RedirectPayment \
Worldline_GraphQl
Pour supprimer le plugin avec toutes leurs données associées, exécutez à la place les commandes suivantes :
bin/magento module:uninstall \
Worldline_Payment \
Worldline_PaymentCore \
Worldline_CreditCard \
Worldline_HostedCheckout \
Worldline_RedirectPayment \
Worldline_RecurringPayments
Si le module complémentaire paiements récurrents a été installé, exécutez la commande suivante :
composer remove worldline/module-magento-recurring-payments
Configuration
Après l'installation, vous devez configurer le plugin pour lier votre boutique à notre plateforme.
Configurer la connexion
- Connectez-vous au Back Office d'Adobe commerce/Magento. Allez dans Stores > Worldline Global Online Pay > Connection.
- Dans Connection, configurez les paramètres suivants :
Propriété Description/Actions Mode d'environnement Sélectionnez entre "Test" ou "Production" pour lier votre boutique à l'environnement respectif. En fonction de votre sélection, le module de boutique enverra les demandes de transaction à l'environnement de test ou de production.
Assurez-vous de :
- Ne pas mélanger les informations d'identification de l'environnement de "Test" avec celles de l'environnement de "Production" et vice versa lors de la configuration des champs Merchant ID (PSPID)/API Key/API Secret et des informations d'identification des webhooks.
- Passer à la "Production" dès que vous avez finalisé vos tests.
API Key Entrez l'API Key de votre PSPID de test ou de production. Lisez notre guide dédié pour apprendre comment en générer une.
API Secret Entrez l'API Secret de votre PSPID de test ou de production. Lisez notre guide dédié pour apprendre comment en générer un.
Identifiant Marchand (PSPID) Entrez votre PSPID depuis notre plateforme que vous souhaitez utiliser pour le traitement des transactions.
Pour certaines propriétés, Magento vous permet d'utiliser la valeur par défaut définie au niveau du système. Si vous souhaitez le faire, cochez “Use system value” en conséquence.
- Cliquez sur "Save Config" pour confirmer votre configuration.

Une fois que vous avez rempli le tableau, vérifiez la configuration en établissant une connexion de test entre le plugin et notre plateforme. Cliquez sur le bouton "Test Connection". Vérifiez que le texte du bouton change pour "Successful! Test again". Si le texte change pour "Connection failed! Test again?", contactez votre administrateur système pour un dépannage afin de vérifier :
- Que vous utilisez les bonnes informations d'identification
- Si votre PSPID est actif
- Que vous envoyez la requête au bon PSPID/environnement (Test vs Production)
Configurer les webhooks
- Connectez-vous au Back Office d'Adobe commerce/Magento. Allez dans Stores > Worldline Global Online Pay > Connection.
- Dans Webhooks, configurez les paramètres suivants :
Propriété Description/Actions Allow Receiving Webhooks Sélectionnez "Yes" pour recevoir des webhooks sur le serveur Magento. Webhook URL Copiez cette URL dans les champs Endpoint URLs dans le Merchant Portal de CAWL ecommerce comme décrit dans notre guide dédié. Key Entrez l'API Key de votre PSPID de test ou de production. Lisez notre guide dédié pour apprendre comment en générer une. Secret Key Entrez l'API Secret de votre PSPID de test ou de production. Lisez notre guide dédié pour apprendre comment en générer un.
Pour certaines propriétés, Magento vous permet d'utiliser la valeur par défaut définie au niveau du système. Si vous souhaitez le faire, cochez "Utiliser la valeur système" en conséquence.
- Cliquez sur "Save Config" pour confirmer et nettoyer votre cache.

Configurer les méthodes de paiement
- Connectez-vous au Back Office d'Adobe commerce/Magento. Allez dans Stores > Worldline Global Online Pay > Payment methods.
- Comme le plugin prend en charge Hosted Checkout Page (Hosted Checkout), Hosted Tokenization Page (Carte de Crédit) et les boutons de paiement unique (Paiements par Redirection), vous pouvez personnaliser l'expérience de paiement de vos clients en sélectionnant des méthodes de paiement pour chacun des modes et même utiliser les deux flux ensemble.
- Notez que les paiements par carte sont disponibles pour les deux modes, tandis que les méthodes de paiement alternatives ne sont disponibles que pour la Hosted Checkout Page et les boutons de paiement unique.

- Dans "Carte de Crédit", configurez les paramètres suivants pour les transactions traitées via notre Hosted Tokenization Page
Propriété Description/Actions Activer le module Sélectionnez l'une des options pour traiter les paiements par carte de crédit
- "Oui" : Le module traite les paiements par carte via le mode d'intégration Hosted Tokenization Page. Tout paiement non par carte passe par Hosted Checkout Page tel que configuré dans "Hosted Checkout"
- "Non" : Au lieu d'utiliser Hosted Tokenization Page pour les paiements par carte, toutes les méthodes de paiement sont proposées via Hosted Checkout Page tel que configuré dans "Hosted Checkout"
Titre Personnalisez le texte du bouton de paiement dans l'iframe sur la page de paiement de Magento ID de modèle HTML Entrez le nom de fichier de votre modèle pour adapter notre page de paiement à l'apparence de votre boutique. Pour savoir comment créer des modèles, consultez nos chapitres dédiés dans le guide Hosted Tokenization Page Action de paiement Définissez si vous souhaitez traiter les transactions en mode autorisation ou en Direct Salee. Sélectionnez l'une des options suivantes :
- "Autoriser & Capturer" : Le montant a été ordonné d'être payé en une seule fois. Utilisez ce mode pour recevoir l'argent avant d'expédier la commande. Aucune action supplémentaire n'est requise pour capturer la transaction. Les transactions réussies auront le status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9
- "Autorisé (Autorisation Seulement)" : Le montant est seulement bloqué sur la carte de votre client. Les transactions réussies auront le status="PENDING_CAPTURE" / statusOutput.statusCategory="PENDING_MERCHANT" / statusOutput.statusCode=5 (Utilisez ce mode lorsque vous souhaitez capturer une transaction uniquement après avoir expédié la commande)
Si "Action de paiement" est défini sur "Autorisé (Autorisation Seulement)", faites attention aux points suivants :
- Assurez-vous d'effectuer la capture de la transaction autorisée par la suite. Ce n'est que lorsque la transaction aura le status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9, que vous recevrez le paiement réel de la transaction
- Effectuez la capture de la transaction dans le Back Office de Magento via le module "Order"
Passer l'authentification 3DSecure Sélectionnez "Oui" ou "Non" pour désactiver le processus d'authentification 3-D Secure pour les paiements
Nous recommandons fortement de sélectionner "Non" car 3-D Secure est obligatoire sur certains marchés. Cela garantira également le transfert de responsabilité pour les transactions avec authentication 3-D Secure réussie. Si vous sélectionnez "Oui" et choisissez de traiter des transactions non 3-D Secure, vous pourriez ne pas bénéficier du transfert de responsabilité et être tenu responsable.
Demander une authentication pour chaque paiement Sélectionnez "Oui" si vous souhaitez que l'émetteur requête une SCA (authentification forte du client) pour les paiements
Demander une exemption 3DS Certains marchés vous permettent potentiellement d'exempter vos clients d'une vérification 3-D Secure.
Sélectionnez "Oui" si vous souhaitez que vos clients soient potentiellement exemptés. Cela s'applique uniquement aux transactions avec un panier inférieur à 30 EUR.
Trier Définissez l'ordre de tri de l'iframe. Cela vous permet de décider dans quel ordre les différents moyens de paiement sont affichés sur votre page de paiement
Filtrage Vous pouvez également mettre en œuvre divers filtres pour définir quand proposer ce mode de traitement des paiements à vos clients : pays, devises, montants
- "Oui" : Le module traite les paiements par carte via le mode d'intégration Hosted Tokenization Page. Tout paiement non par carte passe par Hosted Checkout Page tel que configuré dans "Hosted Checkout"
- Dans "Hosted Checkout", configurez les paramètres suivants pour les transactions traitées via notre Hosted Checkout Page
Propriété Description/Actions Activer le module Sélectionnez l'une des options pour traiter tous les paiements
- "Oui" : Le module traite à la fois les méthodes de paiement carte et non carte via le mode Hosted Checkout Page
- "Non" : Le module traite uniquement les paiements par carte via le mode d'intégration Hosted Tokenization Page
Si vous sélectionnez "Non", assurez-vous que "Activer le module" dans le module "Carte de Crédit" est réglé sur "Oui" pour garantir qu'au moins les paiements par carte soient possibles
Titre Personnalisez le titre sur Hosted Checkout Page ID de modèle HTML Entrez le nom de fichier de votre modèle pour adapter notre page de paiement à l'apparence de votre boutique. Pour savoir comment créer des modèles, consultez nos chapitres dédiés dans le guide Hosted Checkout Page
Action de paiement Définissez si vous souhaitez traiter les transactions en mode autorisation ou en Direct Sale. Sélectionnez l'une des options suivantes :
- "Autoriser & Capturer" : Le montant a été ordonné d'être payé en une seule fois. Utilisez ce mode pour recevoir l'argent avant d'expédier la commande. Aucune action supplémentaire n'est requise pour capturer la transaction. Les transactions réussies auront le status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9
- "Autorisé (Autorisation Seulement)" : Le montant est seulement bloqué sur la carte de votre client. Les transactions réussies auront le status="PENDING_CAPTURE" / statusOutput.statusCategory="PENDING_MERCHANT" / statusOutput.statusCode=5 (Utilisez ce mode lorsque vous souhaitez capturer une transaction uniquement après avoir expédié la commande)
Si "Action de paiement" est défini sur "Autorisé (Autorisation Seulement)", faites attention aux points suivants
- Assurez-vous d'effectuer la capture de la transaction autorisée par la suite. Ce n'est que lorsque la transaction aura le status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9, que vous recevrez le paiement réel de la transaction
- Effectuez la capture de la transaction dans le Back Office de Magento via le module "Order"
Passer l'authentification 3DSecure Sélectionnez "Oui" ou "Non" pour désactiver le processus d'authentification 3-D Secure pour les paiements
Nous recommandons fortement de sélectionner "Non" car 3-D Secure est obligatoire sur certains marchés. Cela garantira également le transfert de responsabilité pour les transactions avec authentication 3-D Secure réussie. Si vous sélectionnez "Oui" et choisissez de traiter des transactions non 3-D Secure, vous pourriez ne pas bénéficier du transfert de responsabilité et être tenu responsable.
Demander une authentication pour chaque paiement Sélectionnez "Oui" si vous souhaitez que l'émetteur requête une SCA (authentification forte du client) pour les paiements
Demander une exemption 3DS Certains marchés vous permettent potentiellement d'exempter vos clients d'une vérification 3-D Secure.
Sélectionnez "Oui" si vous souhaitez que vos clients soient potentiellement exemptés. Cela s'applique uniquement aux transactions avec un panier inférieur à 30 EUR.
Trier Définissez l'ordre de tri de l'iframe. Cela vous permet de décider dans quel ordre les différents moyens de paiement sont affichés sur votre page de paiement
Regrouper les cartes Regroupez toutes les méthodes de paiement par carte sous un seul bouton sur Hosted Checkout Page
Envoyer les données des articles du panier client à Worldline Définit si vous souhaitez soumettre les détails du panier de votre client à CAWL ecommerce. Cela améliorera l'expérience client, mais pourrait générer des erreurs si vous utilisez des règles fiscales personnalisées
Filtrage Vous pouvez également mettre en œuvre divers filtres pour définir quand proposer ce mode de traitement des paiements à vos clients : pays, devises, montants
- "Oui" : Le module traite à la fois les méthodes de paiement carte et non carte via le mode Hosted Checkout Page
Pour certaines propriétés, Magento vous permet d'utiliser la valeur par défaut définie au niveau du système. Si vous souhaitez le faire, cochez "Utiliser la valeur système" en conséquence.
- Dans "Paiement par Redirection", configurez les paramètres suivants pour les transactions pour lesquelles vos clients pré-sélectionnent leur méthode de paiement préférée avant la redirection vers notre Hosted Checkout Page.
Propriété Description/Actions Activer le Module Sélectionnez l'une des options pour traiter tous les paiements
- "Oui" : Le module traite à la fois les méthodes de paiement avec et sans carte via le mode Hosted Checkout Page.
- "Non" : Le module traite uniquement les paiements par carte via la méthode d'intégration Hosted Tokenization Page.
Si vous sélectionnez "Non", assurez-vous que "Activer le Module" dans le module "Carte de Crédit" est réglé sur "Oui" pour garantir qu'au moins les méthodes de paiement par carte sont possibles.
Titre Personnalisez le titre sur le Hosted Checkout Page.
ID de modèle HTML Entrez le nom de fichier de votre modèle pour adapter notre page de paiement à l'apparence de votre boutique. Pour savoir comment créer des modèles, consultez nos chapitres dédiés dans le guide Hosted Checkout Page.
Action de paiement Définissez si vous souhaitez traiter les transactions en mode autorisation ou en Direct Sale. Sélectionnez l'une des options suivantes :
- "Autoriser & Capturer" : Le montant est payé en une seule fois. Utilisez ce mode pour recevoir l'argent avant d'expédier la commande. Aucune action supplémentaire n'est requise pour finaliser la transaction. Les transactions réussies auront le statut="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9
- "Autorisé (Autorisation Seulement)" : Le montant est seulement bloqué sur la carte de votre client. Les transactions réussies auront le statut="PENDING_CAPTURE" / statusOutput.statusCategory="PENDING_MERCHANT" / statusOutput.statusCode=5 (Utilisez ce mode lorsque vous souhaitez finaliser une transaction uniquement après avoir expédié la commande).
Si "Action de paiement" est réglé sur "Autorisé (Autorisation Seulement)", faites attention aux points suivants :
- Assurez-vous d'effectuerla capture de la transaction autorisée par la suite. Ce n'est que lorsque la transaction aura le statut="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9, que vous recevrez le paiement réel de la transaction.
- Capturez la transaction dans le Back Office de Magento via le module "Order".
Passer l'authentification 3DSecure Sélectionnez "Oui" ou "Non" pour désactiver le processus d'authentification 3-D Secure pour les paiements.
Nous recommandons fortement de sélectionner "Non" car 3-D Secure est obligatoire sur certains marchés. Cela garantira également un transfert de responsabilité pour les transactions avec une authentification 3-D Secure réussie. Si vous sélectionnez "Oui" et choisissez de traiter des transactions non 3-D Secure, vous pourriez ne pas bénéficier du transfert de responsabilité et être tenu responsable.
Déclencher une authentification pour chaque paiement Sélectionnez "Oui" si vous souhaitez que l'émetteur requête une SCA (authentification forte du client) pour les paiements.
Demander une exemption 3DS Certains marchés vous permettent potentiellement d'exempter vos clients d'une vérification 3-D Secure.
Sélectionnez "Oui" si vous souhaitez que vos clients soient potentiellement exemptés. Cela s'applique uniquement aux transactions avec un panier inférieur à 30 EUR.
Envoyer les données des articles du panier client à Worldline Détermine si vous souhaitez transmettre les détails du panier de votre client à CAWL ecommerce. Cela améliorera l'expérience client, mais pourrait générer des erreurs si vous utilisez des règles fiscales personnalisées.
Trier Définissez l'ordre de tri de l'iframe. Cela vous permet de décider dans quel ordre les différents moyens de paiement sont affichés sur votre page de paiement
Propriété Description/Actions Activer le Module Sélectionnez l'une des options pour traiter tous les paiements
- "Oui" : Le module traite à la fois les méthodes de paiement carte et non carte via le mode Hosted Tokenization Page.
- "Non" : Le module traite uniquement les paiements par carte via la méthode d'intégration Hosted Checkout Page.
Si vous sélectionnez "Non", assurez-vous que "Activer le Module" dans le module "Carte de Crédit" est réglé sur "Oui" pour garantir qu'au moins les méthodes de paiement par carte sont possibles.
Trier Définissez l'ordre de tri de l'iframe. Cela vous permet de décider dans quel ordre les différents moyens de paiement sont affichés sur votre page de paiement.
Titre Personnalisez le titre sur Hosted Checkout Page.
- "Oui" : Le module traite à la fois les méthodes de paiement avec et sans carte via le mode Hosted Checkout Page.
- Cliquez sur "Save Config" pour confirmer.
Gérer les paiements
Nous avons conçu le plugin pour suivre vos commandes automatiquement et de manière autonome, vous libérant de l'administration impliquée. Apprenez ici comment utiliser notre plugin efficacement pour aider votre entreprise à prospérer !
Mettre à jour le statut des commandes
Le module s'appuie sur deux mécanismes différents pour s'assurer que votre base de données reflète le statut des transactions sur notre plateforme :
- Webhooks : Notre plateforme envoie des notifications au module pour toute mise à jour du statut des transactions. Lisez le chapitre dédié pour configurer les webhooks.
- Appels GET : Magento envoie proactivement des requêtes à notre plateforme pour recevoir le statut de la transaction si les webhooks échouent.
Le processus fonctionne comme suit : Une fois qu'un client a passé une commande, notre plateforme déclenche un webhook :
- Si le webhook atteint Magento immédiatement, le plugin crée une commande et redirige vos clients vers la page "Confirmation de commande".
- Si Magento ne traite pas le webhook immédiatement, le plugin redirige vos clients vers la page "En attente". Magento écoutera pendant 15 secondes pour des webhooks entrants. Dès que le webhook atteint Magento, le plugin redirige vos clients vers la page "Confirmation de commande".
- Si le webhook n'atteint pas Magento dans ces 15 secondes, deux processus prennent le relais :
- 1. Le plugin déclenche un premier appel GET pour récupérer le statut de la transaction directement depuis notre plateforme.
- 2. Si le plugin ne reçoit pas de retour d'information, une tâche automatisée prend le relais et déclenchera des appels GET à intervalles réguliers pour mettre à jour la commande en conséquence.
Pour configurer les appels GET, suivez ces étapes :
- Connectez-vous au Back Office d'Adobe commerce/Magento. Allez dans Stores > Worldline Global Online Pay > Order status updater.
- Dans Général, configurez les paramètres suivants :
Propriété Description/Actions Délai d'attente de secours Définit la période (en minutes) après laquelle le module envoie des appels GET si les webhooks échouent. Après cette période, le module enverra des appels toutes les minutes. Limite de temps de secours Définit la période (en heures) pendant laquelle le module envoie des appels GET. La période par défaut (3 heures) correspond à la validité de session d'un Créer un Checkout hébergé / Créer une session de tokenisation hébergée. Planification (Syntaxe Cron) Synthaxe à utiliser pour exécuter le processus. - Cliquez sur "Enregistrer la configuration" pour confirmer votre configuration.
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 ensembles 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.
Déboguer
Chaque méthode de paiement vous permet d'activer un mode de débogage (qui est désactivé par défaut). Lorsqu'il est activé, Magento crée des journaux supplémentaires de toutes les requêtes envoyées par le plugin à la plateforme Worldline que vous pouvez récupérer.
Pour accéder aux journaux, connectez-vous au panneau d'administration d'Adobe commerce / Magento. Allez dans "«Stores > Settings > Configuration > WORLDLINE > Debug»". En défilant jusqu'à la section de débogage, vous pourrez effectuer certaines actions dans les modules suivants :
- "Général" : Définissez la durée pendant laquelle ces journaux doivent être conservés.
- "Journaux de débogage" : Téléchargez le fichier journal ou supprimez-le.
- "Journaux de requêtes Wordline" : Accédez à une grille qui vous permettra de filtrer les journaux que vous souhaitez voir. Vous pouvez par exemple filtrer les codes de statut HTTP, les API utilisées, des dates spécifiques ou le contenu de la requête/réponse.

Vous pourrez également demander à vos systèmes d'enregistrer tous les webhooks entrants et de les afficher dans une grille similaire à celle des demandes.
Notez que :
- Vous devez régler "Enregistrer les webhooks" sur "Oui" pour enregistrer les webhooks.
- La durée pendant laquelle nous conserverons les journaux des webhooks est égale à la durée pendant laquelle nous enregistrons les demandes.
Configurer le thème Hyvä
Notre plugin est fier de prendre en charge et est pleinement compatible avec les Thèmes Hyva et le Checkout Hyva. Les produits Hyva sont réputés pour leur capacité à transformer les plateformes Magento en offrant des performances exceptionnelles et une expérience utilisateur fluide. Leur design innovant apporte une apparence moderne à l'interface frontend, la rendant optimisée pour la vitesse et l'engagement utilisateur.
Les Thèmes Hyva offrent une interface simplifiée et visuellement attrayante, tandis que le Checkout Hyva améliore le processus d'achat avec une navigation simplifiée et des temps de chargement rapides. Ensemble, ils créent une combinaison puissante pour tout site de e-commerce basé sur Magento visant à améliorer les taux de conversion et la satisfaction client.
Pour garantir la compatibilité avec les produits Hyva, notre plugin nécessite un package supplémentaire. Vous pouvez télécharger ce package essentiel directement à partir de la section des téléchargements sur cette page ou l'obtenir directement depuis notre répertoire GitHub.
Lisez notre chapitre dédié avec des instructions détaillées pour installer le module.