worldline Direct
S'inscrire

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 :

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

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 !

Installation

  1. Installation
  2. Configuration
  3. Gérer les paiements

Installation

La première étape pour utiliser le plugin est le processus d'installation. Avant de continuer, assurez-vous que votre infrastructure respecte ces exigences système :

Élément Description
Package du plugin

Téléchargez le plugin

Identifiants Direct
OpenCart Voir "Compatibilité" sur le repository Marketplace
Conformité PCI

SAQ A

Les fonctionnalités intégrées du plugin assurent ce niveau de sécurité, mais vous devez toujours obtenir le certificat de votre acquéreur

Une fois terminé, suivez ces étapes :

  1. Connectez-vous au Back Office OpenCart. Allez dans Extensions > Installer.
  2. Cliquez sur le bouton « Upload » pour ajouter le fichier.
  3. Dans le tableau "Payments", recherchez "Worldline" et cliquez sur le bouton "Install" dans la colonne "Action".


Configuration

Après l'installation, vous devez configurer le plugin pour lier votre boutique à notre plateforme.

Configurer les paramètres de base

  1. Connectez-vous au Back Office OpenCart. Allez dans Extensions > Extensions. Sélectionnez "Payments" dans la liste déroulante "Choose the extension type".
  2. 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".
  3. Accédez à l'onglet "Account settings" pour configurer les paramètres suivants :
    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.

  4. 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)

Configurer les paramètres avancés

  1. Connectez-vous au Back Office OpenCart. Allez dans Extensions > Extensions. Sélectionnez "Payments" dans la liste déroulante "Choose the extension type".
  2. 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".
  3. Accédez à l'onglet "Advances settings" pour configurer les paramètres suivants :
    Propriété Description
    Payment Title Personnalisez le texte du bouton radio sur la page de paiement de votre boutique en ligne à l'étape "Payment Method" pour les méthodes de paiement traitées via la Hosted Checkout Page
    Payment Button Title Personnalisez le texte du bouton radio à l'étape "Payment Method" sur la page de paiement de votre boutique en ligne.
    Authorization Mode

    Définissez si vous souhaitez traiter les transactions en mode autorisation ou comme Direct Sale. Sélectionnez l'une des options suivantes :

    Assurez-vous de capturer la transaction autorisée plus tard. Ce n'est qu'alors que la transaction aura le statusOutput.statusCode=9/statut "captured" dans le module.

    Group Cards

    Grouper toutes les méthodes de paiement par carte sous un seul bouton sur la Hosted Checkout Page.

    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.


    Nous recommandons fortement de sélectionner "Disabled" pour augmenter la probabilité de taux de conversion plus élevés.

    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".
    Template File Name

    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 notre chapitre dédié dans le guide Hosted Checkout Page.

    Debug Logging

    Activer/désactiver la Logging des événements.

    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.

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


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 :

  1. Connectez-vous au Back Office OpenCart. Allez dans Extensions > Extensions. Sélectionnez "Payments" dans la liste déroulante "Choose the extension type".
  2. 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".
  3. 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" : Capturer le montant autorisé pour recevoir les fonds pour la commande.
    • "Cancel" : Annuler le montant autorisé.
    statusOutput.statusCode=9
    "captured"
    • "Refund" : Rembourser les fonds pour la commande.
    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.


Cette page vous a-t-elle été utile ?

Avez-vous des commentaires ?

Merci pour votre réponse.
New Feature

Try out our new chatbot and find answers to all your questions.