Worldline | Commercetools

Introduction

Notre plug-in Commercetools est livré avec des mises à jour régulières et un support d'intégration complet, garantissant une solution polyvalente prête à l'emploi pour accepter facilement les paiements en ligne.

Méthodes d'intégration et de paiement prises en charge

Offre les méthodes d'intégration suivantes sur notre plateforme :

Hosted Checkout Page

Redirigez vos clients de votre page de paiement vers notre plateforme pour saisir des données de paiement sensibles.

Hosted Tokenization Page

Incluez un formulaire de paiement iFrame hébergé dans notre environnement sécurisé sur votre page de paiement pour saisir des données de paiement sensibles.

Offre les méthodes de paiement suivantes sur notre plateforme :
Alipay+
American Express
Apple Pay
Bancontact
Bizum
Carte Bancaire
Cpay
Diners Club
iDEAL
Illicado
Intersolve
JCB
Multibanco
OneyBrandedGiftCard
PayPal
SEPA Direct Debit
Maestro
MasterCard
Visa
WeChatPay
Gère plusieurs boutiques
Accepte les opérations de paiement (remboursements, autorisations, captures, etc.) directement depuis le plugin

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 le plugin

Confiez à un intégrateur système ou à un consultant technique l'installation et la configuration du plugin
En conséquence, le public cible de cette documentation est constitué d'administrateurs systèmes ayant une connaissance approfondie de la plateforme Commercetools.

Pour traiter 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 en production. Un compte de test est un excellent moyen de vous familiariser à la fois avec le plugin et notre plateforme. Une fois que vous souhaitez passer en production, créez un compte de production ou contactez-nous !

Installer le plugin

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écharger le plugin
Identifiants Direct	Compte test/production actif sur notre plateforme API/Key Secret Webhooks
Frontend Commercetools	Compatible avec toutes les versions Frontend.
Conformité PCI	SAQ A (14) Les fonctionnalités intégrées du plugin assurent ce niveau de sécurité, mais vous devez tout de même obtenir le certificat de votre acquéreur

Vous trouverez un processus d'installation détaillé dans le document README disponible avec le package ou sur Github.

Configuration de base

Accédez à la section « Mon compte » dans le centre marchand de Commercetools.
Sélectionnez le mode Test ou Production selon les besoins.

Entrez les informations suivantes :

Propriété	Description/Actions
ID du marchand	Entrez votre PSP ID ou ID du marchand que vous avez utilisé pour vous inscrire auprès de Worldline
Clé API	Entrez la clé API de votre PSPID en test ou en production. Lisez notre guide dédié pour savoir comment en générer une
API Secret	Entrez le API Secret de votre PSPID en test ou en production. Lisez notre guide dédié pour savoir comment en générer un
API endpoints	Le API endpoint de test ou en production sur notre plateforme. Copiez-les depuis notre guide dédié.
Clé Webhook	Entrez le secret des Webhooks de votre PSPID en test/en production depuis le Merchant Portal comme décrit dans notre guide dédié.
Secret Webhook	Entrez le secret des Webhooks de votre PSPID en test/en production depuis le Merchant Portal comme décrit dans notre guide dédié.
Délai d'expiration en minutes	Définissez l'intervalle pour le délai d'expiration de l'API (réglé sur '180' par défaut)
URL Webhook	Copiez cette URL dans les champs de l'URL de API endpoint dans le Merchant Portal comme décrit dans notre guide dédié.
Identifiants du serveur SMTP	Configurez votre boîte aux lettres pour être notifié des paiements échoués. Envoyez également des e-mails à Worldline et demandez de nouvelles fonctionnalités. Disponible pour les modes test et direct. Utilisez cette option pour masquer/afficher les informations sensibles du serveur : URL du serveur : Entrez l'URL du serveur SMTP pour le mode choisi. Port du serveur : Spécifiez le port du serveur (par défaut : 25, peut différer pour le mode direct). Nom d'utilisateur : Entrez le nom d'utilisateur du serveur pour le serveur SMTP Mot de passe : Fournissez le mot de passe du serveur pour le serveur SMTP Délai d'expiration du serveur : Définissez le délai d'expiration du serveur en secondes (par exemple, 100). Email de l'expéditeur : Entrez l'adresse e-mail pour envoyer les notifications (peut différer pour les modes test et direct).

Cliquez sur Sauvegarder/Mettre à jour pour vous assurer que toutes les informations sont reflétées comme prévu. Le système testera automatiquement la connexion API en utilisant les informations d'identification API fournies.

Si une réponse valide est reçue de Worldline, la configuration sera sauvegardée.
Si le test de connexion échoue, un message d'erreur sera affiché, vous permettant de revoir et de modifier les paramètres.

Lisez nos guides dédiés sur les API endpoints et l'authentification pour obtenir une compréhension approfondie de l'environnement test/production et de la clé API/API Secret.

Nous vous recommandons fortement de configurer un nom distinct pour nos environnements de test et direct. Cela vous permettra de passer manuellement d'un environnement à l'autre facilement. Assurez-vous de ne pas mélanger les identifiants de test avec ceux de production et inversement.

Configuration avancée

Nous catégorisons les méthodes de paiement en deux groupes différents :

Paiements par carte
Méthodes de paiement alternatives

Vous pouvez traiter les paiements par carte soit via la Hosted Tokenization Page, soit via la Hosted Checkout Page, tandis que les méthodes de paiement alternatives sont disponibles uniquement via la Hosted Checkout Page.

Suivez ces étapes pour faire votre choix :

Allez dans Worldline > Payment Methods dans le centre marchand.
Plusieurs modes de paiement sont disponibles. Assurez-vous de les activer en utilisant le bouton de bascule selon votre préférence.

Voici un résumé rapide de chaque mode de paiement :

Valeur ID	Description/Actions
Mode sur site : Paiements par carte uniquement	Couvre toutes les méthodes de paiement par carte Toutes les marques de cartes regroupées dans un seul iFrame sur votre page de paiement via notre Hosted Tokenization Page. Vos clients restent sur votre page de paiement tout en entrant leurs informations de carte dans un iframe hébergé sur notre serveur. L'iframe présente une seule méthode de paiement « Carte de crédit » qui détecte automatiquement la marque de la carte en fonction de l'entrée du numéro de carte Bancontact est disponible uniquement sur la Hosted Checkout Page en mode QR code et URL (Payconiq) Options de configuration : Titre du bouton de paiement – Permet au client d'ajouter le titre localisé du paiement et est également modifiable selon la préférence du marchand. Nom du fichier modèle – Entrez le nom de fichier de votre modèle pour adapter l'iframe à l'apparence de votre boutique. Pour savoir comment créer des modèles, consultez notre chapitre dédié dans le Hosted Tokenization Page. Marques de cartes acceptées – Affichez les images des marques de cartes que vous acceptez dans votre magasin. Téléchargez plusieurs images en utilisant cette option. Activation 3DS – Activez ou désactivez complètement 3DS. Il y a deux options supplémentaires ici : Challenge 3DS – Imposer une authentification forte du client pour toutes les transactions. Exemption 3DS – Pour les montants <30 euros. Le commerçant est responsable des fraudes dans ce cas. Si les deux options sont définies sur Oui, le Challenge 3DS* prévaut et aucune transaction ne sera exemptée.
Mode de redirection A : Sélection de la méthode de paiement avant redirection	Couvre toutes les cartes et méthodes de paiement alternatives. Chaque méthode de paiement est listée individuellement pour la redirection lors de la sélection vers la Hosted Checkout Page. Lors de la sélection de la marque, le plugin redirige vos clients vers notre Hosted Checkout Page ou vers le fournisseur tiers pour entrer les informations de paiement. Options de configuration : Rafraîchir les méthodes de paiement disponibles – Récupère toutes les méthodes de paiement disponibles sur le compte Worldline du marchand. Envoyer les données de commande – Envoyez les détails des articles de la ligne de commande dans votre requête de transaction et affichez-les sur la page de paiement Worldline. Nom du fichier modèle – Entrez le nom de fichier de votre modèle pour adapter la Page de Paiement Hébergée à l'apparence de votre boutique. Pour savoir comment créer des modèles, consultez notre chapitre dédié dans le Hosted Checkout Page. Activation 3DS – Activez ou désactivez complètement 3DS. Il y a deux options supplémentaires ici : Challenge 3DS – Imposer une authentification forte du client pour toutes les transactions. Exemption 3DS – Pour les montants <30 euros. Le commerçant est responsable des fraudes dans ce cas. Si les deux options sont définies sur Oui, le Challenge 3DS* prévaut et aucune transaction ne sera exemptée. Les méthodes de paiement sont affichées sous forme de grille et peuvent être activées ou désactivées d'ici. Une fois activé, le client peut également utiliser l'option Paramètres pour télécharger des images pour chaque méthode de paiement activée.
Mode de redirection B : Sélection de la méthode de paiement après redirection	Couvre toutes les méthodes de paiement alternatives (portefeuilles numériques, méthodes de paiement mobile, cartes cadeaux, etc.) en mode de redirection complète. Options de configuration : Logo générique – Téléchargez une image générique (ex : Worldline) pour l'afficher à côté de la méthode de paiement sur la page de paiement. Titre du bouton de paiement – Permet au client d'ajouter le titre localisé du paiement et est également modifiable selon la préférence du marchand. Nom du fichier modèle – Entrez le nom de fichier de votre modèle pour adapter la Page de Paiement Hébergée à l'apparence de votre boutique. Pour savoir comment créer des modèles, consultez notre chapitre dédié dans le Hosted Checkout Page. Grouper les cartes – Permet de regrouper toutes les méthodes de paiement par carte sous une seule option « Cartes » sur la page de paiement. Activation 3DS – Activez ou désactivez complètement 3DS. Il y a deux options supplémentaires ici : Challenge 3DS – Imposer une authentification forte du client pour toutes les transactions. Exemption 3DS – Pour les montants <30 euros. Le commerçant est responsable des fraudes dans ce cas. Si les deux options sont définies sur Oui, le Challenge 3DS* prévaut et aucune transaction ne sera exemptée.

Veuillez noter que la configuration sera stockée en fonction du magasin et du pays. Chaque fois que vous sélectionnez la langue dans le Frontend, les données pour ce magasin et ce pays seront rendues.

Jetez un œil à toutes les méthodes de paiement disponibles offertes par notre plateforme
Le plugin utilise une API spécifique en temps réel pour s'assurer que vos clients peuvent choisir n'importe quelle méthode de paiement active dans votre compte. Si vous souhaitez ajouter d'autres méthodes de paiement à votre compte, contactez-nous

Il existe certaines configurations supplémentaires qui sont applicables à différents modes de paiement. Veuillez consulter le tableau ci-dessous pour cette configuration.

Propriété	Description/Actions
Référence marchand	Utilisez cet identifiant pour personnaliser votre référence de commande et correspondre avec le Worldline Merchant Portal. *Si vous souhaitez que l'acquéreur l'affiche sur le compte bancaire du client, limitez les caractères entre 2 et 12.*
Type de transaction	Définissez si vous souhaitez traiter les transactions en mode autorisation ou comme Direct Sale. Sélectionnez l'une des options suivantes : Autorisation (FINAL_AUTHORISATION) : le montant est uniquement bloqué sur la carte de votre client. Les transactions réussies auront un StatusCode=5 (c'est utilisé lorsque vous souhaitez capturer une transaction uniquement après l'expédition de l'article). Il y a deux options : Pré-autorisation – Bloquer les fonds pendant 30 jours. Autorisation finale – Bloquer les fonds pendant 7 jours. Ceux-ci ne peuvent pas être annulés et nécessitent toujours de capturer le montant total. Vente (SALE) : le montant a été ordonné d'être payé en une seule fois. Les transactions réussies auront un StatusCode=9. Si vous ne faites qu'autoriser les paiements, assurez-vous de les capturer plus tard. Ce n'est qu'alors que la transaction atteindra StatusCode=9, pour laquelle vous recevrez des fonds.
Configuration de la capture	Cela vous permet de définir une procédure de capture automatique en utilisant un travail de capture automatique. Ce travail vous permet de définir le délai de capture de X jours dans le champ donné. À la fin de cette durée, une tâche automatisée capturera automatiquement la transaction.
Activer les journaux de débogage	Permet de consigner les transactions pour le débogage en cas de problème. Vous pouvez également les télécharger pour les partager ultérieurement.

Gérer les paiements

Nous avons conçu le plugin pour suivre vos commandes automatiquement et de manière autonome, vous libérant ainsi de l'administration impliquée. Apprenez ici comment utiliser efficacement notre plugin qui pourrait aider votre entreprise à prospérer !

Effectuer des opérations de maintenance
Les captures, remboursements et annulations d'autorisations sont des processus standards (également appelés opérations de maintenance) dans votre logique commerciale quotidienne. Apprenez ici comment effectuer ces opérations directement depuis le centre marchand de Commercetools :

Accédez à Worldline > Orders. La page Détails de la commande sépare les commandes en fonction des combinaisons de magasins et de pays. La page des commandes d'échantillon ressemble à ceci :

En fonction du statut de paiement, les boutons suivants sont disponibles dans les "Actions" :

Opérations de maintenance	Description/Actions
Capture	Capture des transactions autorisées (StatusCode=5 / Status=PENDING_CAPTURE / AUTHORIZED/ PARTIALLY CAPTURED / PARTIALLY CANCELLED) pour recevoir effectivement les fonds pour la commande : Cliquez sur le bouton « Capture ». Entrez le montant et cliquez sur « Capture ». Si vous souhaitez que notre plugin capture automatiquement les transactions, assurez-vous de configurer la capture dans la configuration des méthodes de paiement.
Annuler	Annuler les transactions autorisées (StatusCode=5 / Status=PENDING_CAPTURE / AUTHORIZED / PARTIALLY CAPTURED / PARTIALLY CANCELLED) Cliquez sur le bouton « Cancel ». Entrez le montant et cliquez sur « Cancel ». *Veuillez noter qu'actuellement, Worldline ne prend pas en charge l'annulation partielle. Par conséquent, indépendamment du montant mentionné, la commande sera annulée totalement.*
Remboursement	Remboursez vos clients pour les transactions capturées (StatusCode=9 / Status=COMPLETED / CAPTURED / PARTIALLY CAPTURED / PARTIALLY REFUNDED) Cliquez sur le bouton « Refund ». Entrez le montant et cliquez sur « Refund ».

Effectuer des transactions de test

Utilisez l'environnement de test de notre plateforme pour vous assurer que votre plugin fonctionne comme prévu. Nous proposons des ensembles de données de test sur notre page dédiée aux Cas de test. Ciblez notre environnement de test comme décrit dans la section Configuration du Plugin.

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

Commercetools