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
- 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 GitHubTé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.
Installation
Configuration
Après l’installation, vous devez configurer le plugin pour relier votre boutique à notre plateforme.
Paramètres de base
- Connectez-vous au Back Office osCommerce.
- Allez dans Modules > Payment > Online.
- Cliquez sur Worldline GoPay. Cliquez sur Edit dans la colonne de droite.
- Configurez les paramètres suivants :
| Propriété | Description |
|---|---|
| Environnement |
Sélectionnez « Test » ou « Production » pour relier votre boutique à l’environnement correspondant. En fonction de votre choix, le module de la boutique enverra les requêtes de transaction vers l’environnement de test ou de production. Veillez à :
|
| PSPID | Saisissez votre PSPID test/live sur notre plateforme que vous souhaitez utiliser pour le traitement des transactions |
| API key | Saisissez la API Key de votre PSPID test/live. Consultez notre guide dédié pour savoir comment en générer une. |
| API secret | Saisissez la API Secret de votre PSPID test/live. Consultez notre guide dédié pour savoir comment en générer une. |
| Webhooks key | Saisissez la webhooks Key de votre PSPID test/live depuis le Merchant Portal comme décrit dans notre guide dédié. |
| Webhooks secret | Saisissez la webhooks Secret de votre PSPID test/live depuis le Merchant Portal comme décrit dans notre guide dédié. |
| Webhooks URL | Copiez cette URL dans les champs Endpoint URLs de votre compte comme décrit dans notre guide dédié. |
Cliquez sur « Connect » pour confirmer vos paramètres.
Tester la connexion
Une fois les données du tableau remplies, une validation intégrée de la connexion entre le plugin et notre plateforme sera effectuée.
Si la API Key/Secret génère une erreur, le plugin ne sauvegardera pas les données. Contactez votre administrateur système pour le dépannage et vérifiez :
- Vous utilisez les identifiants corrects.
- Si votre PSPID est actif.
- Vous envoyez la requête au bon PSPID/environnement (Test vs Production).
Si la API Key/Secret est correct, le plugin sauvegardera les données.
Moyens de paiement
Sur ce même écran, vous pouvez configurer les paramètres globaux de votre application osCommerce :
| Propriété | Description |
|---|---|
| Activer au checkout |
Active ou désactive le moyen de paiement sur la page de paiement. |
| Nom affiché au checkout |
Définissez le nom du moyen de paiement qui sera affiché sur la page de paiement. Des traductions sont disponibles dans toutes les langues de vitrine prises en charge. |
| Nom du template |
Indiquez le nom de fichier de votre template pour adapter notre page de paiement au design de votre boutique. Pour savoir comment créer des templates, consultez les chapitres dédiés dans le guide Hosted Checkout Page. |
| Action de paiement (uniquement disponible si le moyen de paiement prend en charge l’autorisation) |
Définissez si les transactions doivent être traitées en mode autorisation ou en Direct sale. Sélectionnez l’une des options suivantes :
Si vous sélectionnez « Authorized », configurez également les éléments suivants :
Si le type de transaction est défini sur « Authorized », tenez compte des éléments suivants :
|
| Capture automatique |
Définissez quand capturer automatiquement les transactions autorisées. Vous pouvez programmer la capture jusqu’à 5 jours après l’autorisation. |
| Nombre de tentatives de paiement |
Définissez le nombre de nouvelles tentatives en cas d’échec de paiement sur le Hosted Checkout Page. Vous pouvez configurer jusqu’à 10 tentatives autorisées. Toute tentative supplémentaire sera automatiquement refusée. |
| Appliquer un supplément |
Dans certaines régions, vous pouvez appliquer un supplément sur les transactions par carte de crédit. Si cette option est activée, notre plateforme appliquera automatiquement ce supplément. Si votre compte n’est pas configuré pour accepter le surcharging, toutes vos transactions seront bloquées. |
| Mappage des statuts |
Vous pouvez également configurer différents statuts pour votre commande en fonction du statut du paiement :
Modifiez ce mappage uniquement si vous maîtrisez parfaitement le fonctionnement du flux de statuts de commande dans votre boutique. |
| Mode debug |
Activez cette fonctionnalité pour journaliser tous les appels API sortants et toutes les réponses entrantes provenant de l’API Worldline. |
| Durée de conservation des logs |
Définit la durée de conservation des journaux par vos systèmes (valeur par défaut : 10 jours). Nous vous recommandons de conserver cette valeur si vous prévoyez un trafic élevé, afin de garantir des performances stables. |
| Activer Pay By Link |
Créez des liens de paiement via notre PaymentLinks API que vous pouvez partager par SMS ou e‑mail. Vous pouvez utiliser les liens de paiement pour :
|
| Titre Pay By Link |
Définissez le nom du moyen de paiement Pay By Link dans le Back Office de la boutique. |
| Expiration par défaut |
Définissez la durée pendant laquelle un lien de paiement reste actif (valeur par défaut : 7 jours). Plage autorisée : de 24 heures à 6 mois. |
| Déconnexion |
Supprime tous les paramètres du plugin et vous redirige vers la page d’autorisation utilisateur, ce qui vous permet de connecter un autre compte. |
Cliquez sur « Save » pour confirmer vos paramètres.
Nous avons conservé les paramètres disponibles nativement pour certains moyens de paiement. Reportez-vous à la documentation spécifique à osCommerce pour en savoir plus.
Allez dans l’onglet « Payment » pour configurer les différents moyens de paiement disponibles sur la page de paiement de votre site osCommerce. Activez/désactivez les moyens de paiement pour les afficher/masquer sur la page de paiement.
Le plugin propose trois options :
- Cartes de crédit : Vos clients restent sur votre page de paiement tout en saisissant leurs données de carte dans un iframe hébergé sur notre serveur. Alternativement, la page de paiement affiche un bouton qui redirige votre client vers un formulaire carte dédié sur notre page de paiement.
- Hosted Checkout (Redirection vers Worldline) : Vos clients confirment la commande sur votre page de paiement de boutique. Le plugin redirige ensuite vos clients vers notre Hosted Checkout Page pour leur permettre de sélectionner leur moyen de paiement préféré.
- Bouton de paiement unique : Vos clients sélectionnent leur moyen de paiement préféré dans votre boutique et confirment la commande. Le plugin redirige ensuite vos clients soit :
- Vers une version de notre Hosted Checkout Page personnalisée selon le moyen de paiement sélectionné.
- Vers le prestataire tiers proposant le moyen de paiement sélectionné.
Si vous activez un moyen de paiement qui n’est pas actif dans votre compte Worldline, toutes les demandes de paiement seront refusées.
Cliquez sur le bouton « ··· » puis sélectionnez « Settings » pour afficher une fenêtre modale contenant les paramètres de configuration du moyen de paiement. Configurez les propriétés suivantes :
Paramètres généraux
| Propriété | Description |
|---|---|
| Activer au checkout |
Active ou désactive le moyen de paiement sur la page de paiement. |
| Nom affiché au checkout |
Définissez le nom du moyen de paiement à afficher sur la page de paiement. Des traductions sont disponibles pour toutes les langues de vitrine prises en charge. |
| Nom du template |
Indiquez le nom de fichier de votre template pour adapter notre page de paiement au design de votre boutique. Pour savoir comment créer des templates, consultez les chapitres dédiés dans le guide Hosted Checkout Page. |
| Action de paiement (uniquement disponible si le moyen de paiement prend en charge l’autorisation) |
Définissez si les transactions doivent être traitées en mode autorisation ou en Direct sale. Sélectionnez l’une des options suivantes :
Si vous sélectionnez « Authorized », configurez également les éléments suivants :
Si le type de transaction est défini sur « Authorized », tenez compte des éléments suivants :
|
Paramètres 3-D Secure
Uniquement disponible pour les cartes de crédit, Hosted Checkout et Google Pay.
Paramètres spécifiques aux cartes de crédit
| Propriété | Description |
|---|---|
| Titre du coffre |
Personnalisez le texte du bouton radio affiché sur la page de paiement lorsqu’une carte précédemment enregistrée est proposée au client. |
| Type |
Définit le flux de paiement pour les paiements par carte de crédit.
|
| Regrouper les cartes (disponible pour Hosted Checkout et Cartes de crédit) |
Active/désactive la fonctionnalité « Group cards » du Hosted Checkout Page.
Si vous configurez cela dans le moyen de paiement « Cartes de crédit », nous vous conseillons d’activer le regroupement des cartes. |
Paramètres spécifiques à Hosted Checkout
| Propriété | Description |
|---|---|
| Télécharger une image |
Votre logo d’entreprise apparaissant dans l’en-tête du Hosted Checkout Page. Formats autorisés : png |
Paramètres spécifiques aux autres moyens de paiement
| Propriété | Description |
|---|---|
| Session Timeout |
Définissez la durée de session sur le Hosted Checkout Page en minutes. |
| Product ID |
Définissez la marque spécifique pour le moyen de paiement Intersolve. Retrouvez toutes les valeurs possibles dans le chapitre « Intégration » du guide Intersolve. Si aucune valeur n’est définie, la valeur par défaut est 5700. |
| Instant payment only |
Définissez si vous souhaitez accepter uniquement les virements instantanés pour les paiements Bank Transfer by Worldline. |
Surveillance
Notre plugin intègre un système de journalisation. Lorsque le mode debug est activé, vous pouvez consulter les logs de toutes les transactions. Les journaux s’affichent sur deux écrans :
- Webhooks : Journalise tous les webhooks entrants reçus de notre plateforme, vous informant des changements de statut de transaction. Chaque webhook apparaît sur une ligne distincte dans la grille.
- Logs : Toutes les requêtes/réponses envoyées/reçues entre le plugin et la Direct API, regroupées par transaction.
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 | |
| Identifiants Direct |
|
| OpenCart | Voir "Compatibilité" sur le repository Marketplace |
| Conformité PCI |
SAQ A |
Une fois terminé, suivez ces étapes :
- Connectez-vous au Back Office OpenCart. Allez dans Extensions > Installer.
- Cliquez sur le bouton « Upload » pour ajouter le fichier.
- 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 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. |
- 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 :
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 :
|
| 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. |
| 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 :
|
| 3DS Exemption Request |
Certains marchés vous permettent potentiellement d'épargner vos clients d'un contrôle 3-D Secure :
|
| 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. |
| 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 OpenCartBoutons 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.