Plugin Magento

Le plugin Magento Worldline Direct fournit un traitement de paiement complet pour les installations Magento 2.4, prenant en charge plus de 40 moyens de paiement via plusieurs approches d'integration.

Fonctionnalites

• Page de paiement hebergee - Redirection vers l'interface de paiement securisee Worldline
• Tokenisation hebergee - Iframe de paiement par carte integre
• Paiements par redirection - Boutons de moyen de paiement direct
• Plus de 40 moyens de paiement - Cartes, portefeuilles, virements bancaires, BNPL
• Support du theme Hyva - Compatibilite complete avec les themes Hyva

Exigences

Composant	Version
Magento	2.4.x
PHP	7.4 - 8.4
Theme Hyva	>= 1.1.12 (optionnel)
Hyva Checkout	>= 1.1.15 (optionnel)

Prerequis

• Un compte Worldline Direct actif (test ou production)
• Une cle API et un secret API du Portail Marchand
• Des points d'acces webhook configures

Installation

Option 1 : Composer (recommande)

Installez le package complet du plugin :

composer require worldline/module-magento-payment

Completez la configuration :

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy

Option 2 : GitHub

Configurez les depots :

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

Puis installez :

composer require worldline/module-magento-payment
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy

Installation modulaire

Installez uniquement les moyens de paiement dont vous avez besoin :

# Carte de credit uniquement
composer require worldline/module-magento-payment-credit-card

# Hosted Checkout uniquement
composer require worldline/module-magento-payment-hosted-checkout

# Paiements par redirection uniquement
composer require worldline/module-magento-payment-redirect-payment

Support du theme Hyva

Pour la compatibilite Hyva :

composer config repositories.worldline/module-magento-theme-hyva \
  git git@github.com:wl-online-payments-direct/plugin-magento-hyva.git

composer require worldline/module-magento-theme-hyva

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy

Configuration

Parametres de connexion

Naviguez vers Stores > WORLDLINE ONLINE PAYMENTS > Connection.

Parametre	Description
Environment Mode	Test ou Production
API Key	Votre cle API du Portail Marchand
API Secret	Votre secret API du Portail Marchand
Merchant ID (PSPID)	Votre identifiant marchand

Identifiants d'environnement

Ne melangez jamais les identifiants de test et de production. Utilisez l'environnement de test jusqu'a validation complete, puis passez en production.

Cliquez sur Test Connection pour verifier vos parametres.

Configuration des webhooks

Naviguez vers Stores > WORLDLINE ONLINE PAYMENTS > Connection > Webhooks.

Parametre	Description
Allow Receiving Webhooks	Activer le traitement des webhooks
Webhook URL Configuration	Automatique (recommande) ou Manuel
Additional Webhooks	Jusqu'a 4 URLs supplementaires

Configuration automatique

Le plugin enregistre automatiquement l'URL du webhook dans le Portail Marchand lorsqu'il est defini en mode "Automatique".

Parametres des moyens de paiement

Naviguez vers Stores > WORLDLINE ONLINE PAYMENTS > Payment methods.

Carte de credit (Tokenisation hebergee)

Parametre	Description
Enable Module	Activer les paiements par carte
Title	Nom affiche dans le checkout
HTML Template ID	Modele d'apparence
Payment Action	Autorisation et capture ou Autorisation uniquement
Skip 3D Secure	Non recommande
Request 3DS Exemption	Activer les exemptions

Hosted Checkout

Parametre	Description
Enable Module	Activer tous les moyens de paiement
Title	Titre de la page
HTML Template ID	Modele d'apparence
Payment Action	Mode d'autorisation
Group Cards	Afficher les cartes sous un seul bouton
Submit Cart Data	Envoyer les details du panier

Paiements par redirection

Parametre	Description
Enable Module	Activer les paiements par redirection
Per-Method Configuration	Activer/trier les methodes individuelles

Actions de paiement

Mode	Description	Cas d'usage
Autorisation et capture	Capture immediate des fonds	Biens numeriques, execution immediate
Autorisation uniquement	Fonds bloques jusqu'a la capture	Biens physiques, expedier puis capturer

Pour Autorisation uniquement, capturez manuellement via l'admin Magento apres l'expedition.

Moyens de paiement pris en charge

Cartes

• Visa
• Mastercard
• American Express
• Discover
• JCB
• Diners Club
• Union Pay

Portefeuilles numeriques

• Apple Pay
• Google Pay
• WeChat Pay

Virements bancaires

• iDEAL (Pays-Bas)
• Bancontact (Belgique)
• Przelewy24 (Pologne)
• Bizum (Espagne)
• EPS (Autriche)
• Giropay (Allemagne)

Achetez maintenant, payez plus tard

• Klarna (Pay Later, Pay Now, Slice It)
• Oney
• Sofinco

Gestion des commandes

Mises a jour de statut

Le plugin utilise plusieurs mecanismes pour la synchronisation des transactions :

1. Webhooks (principal) - Notifications en temps reel
2. Appel GET de secours - Interrogation si les webhooks echouent
3. Tache cron de secours - Verifications de statut regulieres

Mise a jour du statut des commandes

Configurez dans Stores > WORLDLINE ONLINE PAYMENTS > Order status updater :

Parametre	Par defaut	Description
Fallback Timeout	1 minute	Attente avant les appels GET
Fallback Timeout Limit	3 heures	Duree de l'interrogation
Schedule (Cron)	Personnalisable	Calendrier d'execution

Gestion des ecarts de montant

Pour les changements de prix pendant le checkout, configurez dans Settings & Notifications > Order creation on Amount Discrepancy :

Option	Comportement
Enable: Yes	Commandes creees avec le statut "En attente"
Enable: No	Transactions rejetees

Mise a jour

Mettez a jour l'installation complete :

composer update worldline/module-magento-payment \
  worldline/module-magento-payment-core --with-all-dependencies

Desinstallation

Creez d'abord une sauvegarde de la base de donnees, puis :

composer remove worldline/module-magento-payment

Pour une suppression complete incluant les donnees :

bin/magento module:uninstall \
  Worldline_Payment \
  Worldline_PaymentCore \
  Worldline_CreditCard \
  Worldline_HostedCheckout \
  Worldline_RedirectPayment

Debogage

Activez le mode debug par moyen de paiement pour une journalisation detaillee.

Consultez les journaux dans Stores > Settings > Configuration > WORLDLINE > Debug :

• Debug Logs - Telecharger ou supprimer les fichiers de journaux
• Worldline Request Logs - Filtrer par statut, point d'acces, date
• Webhook Logging - Capturer les evenements webhook

Bonnes pratiques

1. Tester d'abord - Toujours tester en sandbox avant la production
2. Activer les webhooks - Assurer des mises a jour de commande fiables
3. Garder 3-D Secure active - Requis sur les marches reglementes
4. Surveiller les journaux - Verifier regulierement les erreurs
5. Mises a jour regulieres - Maintenir le plugin a jour

Pas de modifications de code

Les modifications du code du plugin annulent le support technique. Utilisez uniquement les options de configuration.

Depannage

Probleme	Solution
Connexion echouee	Verifier les identifiants API et le PSPID
Webhooks non recus	Verifier l'accessibilite de l'URL et les regles du pare-feu
3DS ne fonctionne pas	S'assurer que 3DS n'est pas desactive dans les parametres
Commandes bloquees	Verifier la configuration du Order Status Updater

Ressources

• Depot GitHub
• Portail Marchand
• Reference API

Prochaines etapes

• Configurer les webhooks pour des notifications fiables
• Configurer 3-D Secure pour la securite des cartes
• Explorer les moyens de paiement a activer