Worldline | OpenCart

Introduction

Notre plug-in OpenCart 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/Hosted Tokenization Page

Offre les méthodes de paiement suivantes sur notre plateforme :
Alipay+
American Express
Bancontact
Bizum
Cartes Bancaires
Diners Club
Discover
iDEAL | Wero
Intersolve
JCB
Klarna
Google Pay
Maestro
MasterCard
Oney 3x-4x
PayPal
Visa
WeChatPay

Accepte les opérations de paiement (remboursements, autorisations, captures, etc.) directement depuis votre Back Office OpenCart.

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, modes d'intégration) que nous avons ajoutées à ce plugin !

Consultez notre documentation pour apprendre à connecter votre boutique à notre plateforme et profiter de toutes ces fonctionnalités !

Télécharger depuis le repository GitHub

Télécharger depuis le repository Marketplace

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 !

Les modifications du code du plugin annulent le support technique

Pour la sécurité et la stabilité, Worldline ne prend pas en charge les plugins dont le code a été modifié par le commerçant ou des tiers. Les plugins sont fournis tels quels (version officielle). Toute modification non autorisée annule le support et la garantie et peut causer des dysfonctionnements, des failles de sécurité ou des incompatibilités avec les mises à jour.

Configuration

Après l’installation, vous devez configurer le plugin afin de lier votre boutique à notre plateforme.

Connectez-vous au Back Office OpenCart. Allez dans Extensions > Extensions. Sélectionnez « Payments » dans la liste déroulante « Choose the extension type ».
Le plugin chargera une liste correspondant au type d’extension « Payments ». Dans le tableau « Payments », recherchez « Worldline » et cliquez sur le bouton « Edit » dans la colonne « Action ». L’écran de configuration du plugin apparaîtra avec plusieurs onglets.

Paramètres du compte

Propriété	Description
Status	Activer/Désactiver le plugin.
Environment	Sélectionnez "Test"/"Live" pour lier votre boutique à l'environnement respectif et configurer les identifiants de test/production respectifs. En fonction de votre sélection, le module boutique enverra les requêtes de transaction à l'environnement de test ou de production.
(Test) Merchant ID (PSPID)	Entrez votre PSPID de test/production depuis notre plateforme que vous souhaitez utiliser pour le traitement des transactions.
(Test) API Key	Entrez la API Key de votre PSPID de test/production. Lisez notre guide dédié pour apprendre à en générer une.
(Test) API Secret	Entrez le API Secret de votre PSPID de test/production. Lisez notre guide dédié pour apprendre à en générer un.
(Test) API Endpoint	Préfini par défaut, mais peut être modifié à volonté.
(Test) Webhooks Key	Entrez la clé des webhooks de votre PSPID de test/en production depuis le Merchant Portal comme décrit dans notre guide dédié.
(Test) Webhooks Secret	Entrez le secret des webhooks de votre PSPID de test/en production depuis le Merchant Portal comme décrit dans notre guide dédié.
Webhooks URL	Copiez cette URL dans le Merchant Portal comme décrit dans notre guide dédié. Attention, le plugin ne fournit qu'une valeur pour les environnements de test et production.
Cron URL	Configurez une tâche automatisée pour vous assurer que le plugin synchronise le statut des transactions avec notre plateforme. C'est un mécanisme de secours si le plugin ne récupère pas correctement le statut une fois une transaction finalisée. Attention, le plugin ne fournit qu'une valeur pour les environnements de test et production.

Cliquez sur "Save" pour confirmer vos paramètres et validez vos paramètres en établissant une connexion de test entre le plugin et notre plateforme. Vérifiez que l'écran affiche "Success: You have modified Worldline!". Si le texte n'apparaît pas, contactez votre administrateur système pour résoudre le problème et vérifier :
a. Que vous utilisez les identifiants corrects.
b. Si votre PSPID est actif.
c. Que vous envoyez la requête au bon PSPID/environnement (Test vs Production)

Paramètres avancés

Propriété	Description
Authorization Mode	Définissez si vous souhaitez traiter les transactions en mode autorisation ou comme Direct Sale. Sélectionnez l'une des options suivantes : Pre Authorization: Le montant est uniquement bloqué (=autorisé) sur la carte de votre client pendant 30 jours. Vous pouvez annuler l’autorisation à tout moment, totalement ou partiellement. Prend en charge les captures complètes et partielles.. Les transactions réussies auront status="PENDING_CAPTURE" / statusOutput.statusCategory="PENDING_MERCHANT" / statusOutput.statusCode=5. Utilisez ce mode lorsque vous souhaitez capturer une transaction uniquement après l'expédition de la commande. Dans le module OpenCart, le statut sera "pending_capture". Final Authorization: Le montant est uniquement bloqué (=autorisé) sur la carte de votre client pendant 7 jours. Vous pouvez annuler l’autorisation à tout moment, mais uniquement dans sa totalité.. Les transactions réussies auront status="PENDING_CAPTURE" / statusOutput.statusCategory="PENDING_MERCHANT" / statusOutput.statusCode=5. Utilisez ce mode lorsque vous souhaitez capturer une transaction uniquement après l'expédition de la commande. Dans le module OpenCart, le statut sera "pending_capture". Sale: Le montant est bloqué et payé (=capturé) en une seule fois. Les transactions réussies auront status="CAPTURED" / statusOutput.statusCategory="PENDING_MERCHANT" / statusOutput.statusCode=9. Dans le module OpenCart, le statut sera "captured". Si vous sélectionnez « Pre Authorization » ou « Final Authorization », assurez-vous de procéder ultérieurement à la capture de la transaction autorisée.. Ce n'est qu'alors que la transaction aura le statusOutput.statusCode=9/statut "captured" dans le module.
Capture Configuration	Configurez après combien de temps la capture automatique sera initiée. Vous pouvez choisir d'effectuer la capture manuellement ou de définir une durée après laquelle la capture automatique sera initiée. Gardez à l'esprit que vous devez également configurer une tâche automatisée (cronjob) sur l'environnement concerné.
Forced Tokenization	Déterminez si vous souhaitez stocker les données de carte de vos clients pour de futurs paiements Card On File : "Enabled" : Créer un token pour chaque transaction réussie par carte. "Disabled" : Ne pas stocker les données de la carte.
Surcharging Status	Veuillez confirmer votre décision concernant l'application éventuelle d'un surcoût à vos transactions. Notez que ce surcoût s'applique uniquement aux marchés hors UE et nécessite une configuration préalable sur votre compte. Notez que ce surcoût s'applique uniquement aux marchés hors UE et nécessite une configuration préalable sur votre compte.
3DS Status	(Dés)activez le contrôle 3-D Secure. Nous recommandons fortement de sélectionner "Enabled", car 3-D Secure est obligatoire dans certains marchés. Cela garantira également le transfert de responsabilité pour les transactions avec une authentification 3-D Secure réussie. Si vous sélectionnez "Disabled" et choisissez de traiter des transactions sans 3-D Secure, vous pourriez ne pas bénéficier du transfert de responsabilité et être tenu responsable.
3DS Challenge Indicator	Déterminez si vous souhaitez masquer ou contourner l'authentification 3-D Secure chaque fois que possible par défaut : No Preference : Pas de préférence pour le Cinématique d'authentification frictionless ou passive/de défi. No Challenge Requested : Préférence pour le Cinématique d'authentification frictionless ou passive. Challenge Requested : Préférence pour le flux de défi. Challenge Required : Vous insistez pour le flux de défi.
3DS Exemption Request	Certains marchés vous permettent potentiellement d'épargner vos clients d'un contrôle 3-D Secure : No exemption flagging : Vous passez sur toute exemption possible. Transaction is of low risk : Vous pouvez demander une exemption pour les transactions que vous considérez à faible risque. Comme l'acquéreur est responsable, il décide d'accorder/refuser une exemption en fonction du portefeuille global de la transaction (valeur de la transaction, taux de fraude). The value of the transaction is below 30 EUR : Pour les achats inférieurs à 30 €. Cependant, le SCA sera nécessaire si un client effectue cinq transactions consécutives ou atteint une valeur de plus de 100 €. Whitelisted by the customer : Vos clients peuvent demander une exemption à leur émetteur pour vous inscrire sur une liste blanche en tant que "bénéficiaires de confiance".
Debug Logging	Lorsque la journalisation en mode debug est activée, des détails supplémentaires tels que le montant de l'achat, l'adresse du client, les données de webhook reçues ainsi que les requêtes/réponses HTTP de l'API sont enregistrés. Activez les journaux en mode debug lors du diagnostic de problèmes et partagez ces journaux avec l'équipe de support pour une résolution efficace.
Total	Définissez un montant minimum du panier pour rendre les paiements possibles avec cette extension.
Geo Zone	Choisissez une zone géographique spécifique pour rendre cette extension disponible sur la page de paiement de votre boutique en ligne
Sort Order	Spécifiez l'ordre dans lequel les méthodes de paiement disponibles sont affichées dans l'étape "Payment Method" sur la page de paiement de votre boutique en ligne.

Cliquez sur "Save" pour confirmer vos paramètres.

Paramètres Hosted Checkout

Propriété	Description
Status	Activer/Désactiver les moyens de paiement autres que les cartes via la page Hosted Checkout. Si vous désactivez ce paramètre, veillez à configurer le paramètres Hosted Tokenization > Status sur « Enable » afin de permettre au minimum les paiements par carte.
Payment Title	Personnalisez le texte du bouton de paiement sur la page de checkout de votre boutique en ligne.
Payment Button Title	Personnalisez le texte du bouton de confirmation sur la page de checkout de votre boutique en ligne. Valeur par défaut : « Place Order ».
Grouped cards	Activer/Désactiver le regroupement de tous les moyens de paiement par carte sous un seul bouton sur la Hosted Checkout Page.
Template file name	Saisissez le nom de fichier de votre template pour adapter notre page de paiement au look & feel de votre boutique. Pour savoir comment créer des templates, consultez le chapitre dédié dans le guide Hosted Checkout Page.
Wero Capture Trigger	Si vous travaillez en deux étapes (autorisation et capture), ce champ sera présenté à vos clients dans leur portail Wero durant le flux de paiement.

Cliquez sur « Save » pour confirmer vos paramètres.

Paramètres Hosted Tokenization

Propriété	Description
Status	Activer/Désactiver les moyens de paiement par carte via la Hosted Tokenization Page. Si vous désactivez ce paramètre, les moyens de paiement par carte et autres que par carte seront tous traités via la Hosted Checkout Page (voir le paramètre Hosted Checkout Settings > Status).
Payment Title	Personnalisez le nom du moyen de paiement sur la page de checkout de votre boutique en ligne.
Payment Button Title	Personnalisez le texte du bouton de confirmation sur la page de checkout de votre boutique en ligne. Valeur par défaut : « Place Order ».
Template file name	Saisissez le nom de fichier de votre template pour adapter notre page de paiement au look & feel de votre boutique. Pour savoir comment créer des templates, consultez les chapitres dédiés dans le guide Hosted Tokenization Page.

Cliquez sur « Save » pour confirmer vos paramètres.

Vous pouvez également configurer différents statuts de commande via l’onglet « Order Status ».

Gérer les paiements

Nous avons conçu le plugin pour suivre facilement vos commandes, vous libérant ainsi de l'administration induite. Apprenez ici comment utiliser notre plugin efficacement, ce qui pourrait aider votre entreprise à prospérer !

Effectuer des opérations de maintenance

Les captures, remboursements et annulations d'autorisations sont des processus standards (opérations de maintenance) dans votre logique commerciale quotidienne. Apprenez ici comment effectuer ces opérations directement dans le Back Office OpenCart :

Connectez-vous au Back Office OpenCart. Allez dans Extensions > Extensions. Sélectionnez "Payments" dans la liste déroulante "Choose the extension type".
Le plugin chargera une liste correspondant au type d'extension "Payments". Dans le tableau "Payments", recherchez "Worldline" et cliquez sur le bouton "Edit" dans la colonne "Action".

Accédez à l'onglet "Transactions". Dans l'aperçu, selon l'état de la commande (colonne "Transaction Status"), les boutons suivants sont disponibles dans la colonne "Action" :

Worldline/ Statut de la commande OpenCart	Boutons disponibles
statusOutput.statusCode=5 / "pending_capture"	"Capture" : Capturez le montant autorisé pour recevoir les fonds de la commande. À utiliser uniquement pour les captures du montant complet. Pour les captures partielles, allez dans Order details > Order History > Worldline (Tab) et configurez le montant à capturer. "Cancel" : Annuler le montant autorisé.
statusOutput.statusCode=9 / "captured"	"Refund" : Remboursez les fonds de la commande. À utiliser uniquement pour les remboursements du montant complets. Pour les remboursements partiels, allez dans Order details > Order History > Worldline (Tab) et configurez le montant à rembourser.
statusOutput.statusCode=2 / "rejected"	"Cancel" : Annuler le montant autorisé.

Assurez-vous de passer vers l'environnement de production dès que vous avez finalisé vos tests.

OpenCart