worldline Direct
S'inscrire
L’image ci-dessus montre un écran de paiement mobile avec une barre de progression et un bouton "Payer en toute sécurité".

Introduction

Notre Hosted Checkout Page est la solution idéale pour offrir à vos clients des paiements dans votre boutique en ligne. Elle combine une grande polyvalence avec un minimum d'exigences.

  • Déléguez nous la gestion des données sensibles pour être conforme à la norme PCI
  • Adaptation visuelle flexible et facile
  • Intégration facile, paiement instantané !

Get started

To process transactions on our platform with this solution, make sure that

  • You have an account on our platform.
  • At least one of our available payment methods is activated in the Merchant Portal via Entreprise > Moyens de paiement.
    Are you using the Back Office?
    You can check the payment method’s activation status via Configuration > Activation PM.
  • You have configured your API Key and API Secret in your account.
  • Your server can process server-to-server request via our RESTful API. Using one of our Server SDKs will greatly ease this task.

Are you all set? Then learn how to use our Hosted Checkout Page in the next chapter!

Get started

Comment ça fonctionne

Acquirer Secure transfer of card
data via a form hosted 
on our platform Real-time 1 Merchant Connection between our 
platform & acquirer to 
process the transaction 2 Our platform

Avant de traiter des transactions en production, utilisez notre environnement de test. Découvrez notre solution sans frais ni engagements ! Une fois que vous souhaitez passer en production, consultez ici comment obtenir un compte de production ou contactez-nous !

Ciblez l'URL de base de l'API la plus à jour

Nous vous encourageons à toujours cibler l'URL de base de l'API la plus à jour lors de l'envoi de requêtes à notre plateforme. Consultez notre guide dédié pour un aperçu complet.

Pour vous permettre une transition en douceur, les anciennes URL de base de l'API restent disponibles jusqu'à nouvel ordre.

Modes d'intégration

1Utilisez nos SDK

Utilisez nos SDK serveur pour connecter de manière transparente votre environnement serveur à l'API serveur de notre platforme. Ces SDK simplifient la fonctionnalité de l'API avec des objets faciles à utiliser - spécifiques à la plateforme.

Ruby PHP Node.js Java Python 3 .NET

2Utilisez nos plugins

Nos plugins offrent un lien entre votre boutique en ligne et notre plateforme. En encapsulant efficacement notre API RESTful, ces plugins vous font gagner du temps dans l'écriture de code et rendent l'intégration rapide et facile.

Prestashop WooCommerce WooCommerce SAP Magento Shopify Salesforce Shopware Chargebee BigCommerce Aero Commerce OpenCart Proximis
Hosted Checkout Page

Trouvez des exemples d'implémentations côté serveur pour la Hosted Checkout Page dans tous les langages de programmation.

Supported languages
Product
Hosted Checkout Page

Étapes d'intégration

Au cours du processus de paiement, vous redirigez vos clients vers notre page de paiement sécurisée. Ils saisissent leurs informations de carte, nous les transférons à votre acquéreur et vous fournissons le résultat.

Notre Hosted Checkout Page fonctionne avec toutes les méthodes de paiement disponibles sur notre plateforme. Si vos clients choisissent une méthode de paiement par redirection, nous redirigerons directement vos clients vers le prestataire.

Les chapitres suivants fournissent un aperçu général d'un flux typique. Ils décrivent toutes les étapes à suivre pour traiter les transactions de Hosted Checkout Page . Rerouvez un aperçu détaillé incluant des étapes optionnelles, l'authentification 3-D Secure, etc. dans le chapitre dédié.

  1. Initialiser le SDK serveur
  2. Créer une session HostedCheckout
  3. Rediriger le client vers la Hosted Checkout Page
  4. Obtenez le résultat de la transaction & redirigez le client vers la boutique en ligne.
  5. Afficher le résultat de la transaction

Initialiser le SDK serveur

Initialisez le SDK serveur en définissant les URLs de connexion, votre PSPID sur notre plateforme et votre API key/secret. Lisez la documentation de votre SDK préféré pour en savoir plus.

URLs des API endpoints en test / production

Notre plateforme vous permet d'envoyer des requêtes soit à notre environnement de test, soit à l'environnement de production :

  • Endpoint URL de TEST : https://payment.preprod.direct.worldline-solutions.com/v2/MERCHANT_ID/hostedcheckouts
  • Endpoint URL de PRODUCTION : https://payment.direct.worldline-solutions.com/v2/MERCHANT_ID/hostedcheckouts

Si vous utilisez nos SDK serveur, votre application doit cibler l'URL de la méthode d'intégration / environnement respective via des instances de CommunicatorConfiguration/ IClient/ CreateHostedCheckoutRequest. Des informations détaillées sur la façon de procéder sont disponibles dans les chapitres suivants, y compris des exemples de code complets. Si vous utilisez des plugins, vous devrez peut-être configurer manuellement les API endpoints test / production dans le back office de votre plugin. Nous le décrivons dans le chapitre "Configurer le plugin" dans le guide respectif.


Créer une session HostedCheckout

Envoyez vos clients vers notre page de paiement sécurisée pour saisir les données de la carte. Pour ce faire, vous avez besoin d'une URL de redirection vers notre Hosted Checkout Page. Obtenez cette URL en envoyant une requête CreateHostedCheckout à notre plateforme.

Personnalisez-vous la durée d'une session Hosted Checkout Page dans l'ancien système ?

Dans l'ancien système, cela nécessite une configuration de notre part pour chacun de vos PSPIDs par lesquels vous canalisez les transactions.

Direct externalise cette fonctionnalité vers l'API, vous permettant de personnaliser la durée d'une Hosted Checkout Page par transaction individuelle.
Incluez la propriété hostedCheckoutSpecificInput.sessionTimeout dans vos demandes CreateHostedCheckout comme décrit dans notre documentation API en conséquence.

Une session CreateHostedCheckout est valable pendant trois heures. Assurez-vous d'exécuter les étapes suivantes dans ce délai. 


Rediriger le client vers la Hosted Checkout Page

En réponse à votre requête, notre plateforme envoie une réponse sous la forme de CreateHostedCheckoutResponse. Utilisez la propriété redirectUrl pour rediriger vos clients vers notre Hosted Checkout Page.

// Propriétés de createHostedCheckoutResponse
{
    "RETURNMAC": "12345678-90ab-cdef-1234-567890abcdef",
    "hostedCheckoutId": "123456",
    "merchantReference": "7e21badb48fe45848bbc1efef2a88504",
    "partialRedirectUrl": "preprod.direct.worldline-solutions.com/hostedcheckout/PaymentMethods/Selection/e61340e579e04172a740676ffdda162e"
    "redirectUrl": "https://payment.preprod.direct.worldline-solutions.com/hostedcheckout/PaymentMethods/Selection/e61340e579e04172a740676ffdda162e"
}
  • Si vous chargez le partialRedirectUrl/redirectUrl dans un WebView, intégré dans votre application mobile, assurez-vous d'initialiser l'option settings.setDomStorageEnabled(true); lors de la création du WebView. Cela évitera des problèmes avec la redirection.
  • Le redirectUrl est valable pendant trois heures. Assurez-vous de rediriger vos clients dans ce délai.
  • Nous vous recommandons fortement de ne pas utiliser d'iframe pour le partialRedirectUrl/redirectUrl situé sur votre page de paiement, car cela peut entraîner un comportement indésirable lors du processus de paiement. Si vous préférez une solution basée sur un <iframe>, notre Hosted Tokenization Page est la solution idéale pour vous !


Obtenez le résultat de la transaction & redirigez le client vers la boutique en ligne.

Êtes-vous en train de migrer de l'ancien système vers Direct ?

Contrairement à l'ancien système, notre plateforme n'envoie pas de notifications par e-mail pour les commandes Direct traitées ou les mises à jour de statut.

Utilisez les webhooks pour recevoir des notifications sur les mises à jour de statut des transactions. En fonction du résultat, implémentez un mécanisme sur votre serveur pour envoyer des e-mails à votre/vos clients. Cela vous permettra de personnaliser le contenu, le moment et de sélectionner les mises à jour de statut pour lesquelles vous souhaitez envoyer des e-mails.

En savoir plus sur la migration des fonctionnalités héritées vers Direct dans notre guide dédié.

Vos clients saisissent leurs coordonnées de carte sur le Hosted Checkout Page que nous soumettons à votre acquéreur. Nous recevons le résultat de la transaction et redirigeons vos clients vers votre boutique en ligne. Définissez un hostedCheckoutSpecificInput.returnUrl dans la requête initiale CreateHostedCheckout pour cette redirection. Assurez-vous d'implémenter un mécanisme sur ce returnUrl qui notifie votre serveur de cette redirection. Dès réception de cette notification, envoyez une requête GetHostedCheckoutStatus pour obtenir le résultat de la transaction. Utilisez le hostedCheckoutId de la réponse initiale CreateHostedCheckoutResponse :


Afficher le résultat de la transaction

Adaptez le returnUrl en fonction du statusOutput.statusCode tel que retourné par la requête GetHostedCheckoutStatus.

Apprenez-en davantage dans notre guide de Statut dédié sur les propriétés de la réponse, leur signification et comment procéder de manière appropriée en fonction du statut des transactions.

  • Par défaut, le hostedCheckoutId est valide pendant trois heures, période durant laquelle vous pouvez envoyer une requête GetHostedCheckoutStatus. Vous pouvez personnaliser la durée de la session via la propriété hostedCheckoutSpecificInput.sessionTimeout comme décrit dans notre Référence API.
  • Après cette période, vous pouvez recevoir le résultat via les webhooks ou demander le statut de la transaction à tout moment via une requête GetPaymentDetails.
  • Sachez que les webhooks sont des événements asynchrones. Par conséquent, ils ne conviennent pas pour gérer des événements en temps réel pendant le processus de paiement.


Cinématique

Trouvez une cinématique de transaction complète impliquant chaque partie et les étapes (facultatives) dans cet aperçu :

  1. Votre client se rend sur votre page de paiement et finalise l'achat.
  2. Vous envoyez une requête CreateHostedCheckout à notre plateforme.
  3. Notre plateforme renvoie une redirectionUrl.
  4. Vous redirigez votre client vers la redirectionUrl.
    4'(facultatif). Nous effectuons une vérification des contrôles de fraude.
  5. Nous redirigeons le client vers sa banque émettrice pour l'authentification 3-D Secure. Le client s'identifie.
  6. Notre plateforme reçoit le résultat d'authentification 3-D Secure de l'émetteur. En fonction du résultat, deux scénarios sont possibles :
    a) Si l'identification a échoué, nous redirigeons vos clients vers votre returnUrl, terminant la cinématique. Vous demandez le résultat de la transaction comme décrit à l'étape 9.
    b) Si l'identification a réussi, la cinématique continue à l'étape 8.
  7. Nous traitons la transaction et recevons le résultat de l'acquéreur.
  8. Nous redirigeons votre client vers votre returnUrl.
  9. Vous demandez le résultat de la transaction à notre plateforme et l'affichez sur votre returnUrl.
  10. Si la transaction a réussi, vous pouvez livrer les biens / services.

Ajouter des possibilités

Notre Hosted Checkout Page offre de nombreuses autres possibilités. Découvrez ici toutes ses fonctionnalités disponibles.

Utiliser un token pour Card On File

1-click payments sont un excellent moyen d'améliorer l'expérience de paiement de vos clients et peuvent contribuer à augmenter votre taux de conversion. En utilisant un token existant, vous pouvez préremplir la Hosted Checkout Page pour vos clients :

Personnaliser l'apparence de la page de paiement

Notre plateforme vous permet d'adapter l'apparence de notre Hosted Checkout Page dans une large mesure. Adapter la page de paiement à votre identité d'entreprise peut inciter vos clients à finaliser leur commande après les avoir redirigés vers la Hosted Checkout Page.

Choisir la langue

Notre Hosted Checkout Page est disponible dans plusieurs langues. Remplissez locale pour l'afficher dans la langue préférée de vos clients. La valeur est une combinaison de l'ISO 639-1 (langue) et de l'ISO 3166-1 (pays) :

"hostedCheckoutSpecificInput": {
        "locale": "fr_FR",
		/* autres propriétés omises */
}


Nous prendrons en charge les langues suivantes :

Version linguistique valeur locale Version linguistique valeur locale
Arabe ar_AE Japonais ja_JP
Catalan ca_ES Coréen ko_KR
Chinois zh_CN Lituanien lt_LT
Croate hr-HR Letton lv-LV
Tchèque cs_CZ Norvégien no_NO
Danois da_DK Polonais pl_PL
Estonien et-EE Portugais pt_PT
Hollandais / Flamand nl_NL
nl_BE
Roumain ro_RO
Anglais UK / US en_UK
en_US
Russe ru_RU
Finnois fi_FI Slovaque sk_SK
Français fr_FR Slovène sl_SI
Allemand
Allemagne/Autriche/Suisse
de_DE
de_AT
de_CH
Espagnol es_ES
Grec el_GR Suédois sv_SE
Hébreu he_IL Turc tr_TR
Hongrois hu_HU
Italien it_IT

Personnaliser le modèle

Nous proposons deux approches distinctes pour mettre en œuvre un modèle personnalisé :

Méthode 1 : Créer un modèle personnalisé et le télécharger dans le Back Office

Créez un modèle entièrement personnalisé à partir de zéro en utilisant notre puissant Outil de constructions de modèles. Alternativement, vous pouvez télécharger et personnaliser les fichiers nécessaires directement depuis notre référentiel GitHub. Cette approche offre un haut degré de personnalisation mais nécessite certaines compétences techniques pour être mise en œuvre efficacement.

Une fois que vous avez créé un modèle qui correspond à l'apparence et à la convivialité de votre boutique en ligne, téléchargez-le ainsi que tous les fichiers .css / image nécessaires sur notre plateforme. Pour ce faire, suivez ces étapes :

  1. Connectez-vous au Back Office.
  2. Allez dans Configuration > Modèle > Gestionnaire de fichiers > Télécharger les fichiers de modèle. Cliquez sur « Fichier... » et sélectionnez les fichiers .html (et, le cas échéant, les fichiers .css / image supplémentaires).
  3. Après quelques minutes, notre système aura validé les fichiers (dans « Fichiers téléchargés », ils apparaissent comme « Validés » dans la colonne « État »). Ils seront alors prêts à être utilisés sur la Hosted Checkout Page.

Méthode 2 : Personnaliser le modèle dans le Merchant Portal

Bien qu'elle offre une flexibilité inférieure par rapport à la méthode 1, cela ne nécessite aucune compétence technique. Référez-vous au chapitre dédié dans notre Merchant Portal guide pour apprendre à personnaliser facilement l'expérience de paiement de vos clients.

Notre plateforme vous permet de télécharger plusieurs fichiers de modèle. Utilisez celui de votre choix en remplissant la propriété hostedCheckoutSpecificInput.variant avec le nom du fichier dans la requête CreateHostedCheckout.

Pré-sélectionner les méthodes de paiement disponibles

Réduire les étapes de paiement est essentiel pour encourager vos clients à finaliser leur commande. HostedCheckOutSpecificInput contient des propriétés qui vous le permettent.

  • Ignorez la page de sélection du moyen de paiement et redirigez vos clients directement vers le formulaire du moyen de paiement souhaité. Cela fonctionne également pour les redirections vers un fournisseur tiers (c'est-à-dire PayPal).
    Toutes nos méthodes de paiement ont un identifiant de moyen de paiement individuel. Vous pouvez le trouver dans l'onglet “Aperçu” de la méthode de paiement respective.

    Cet exemple de code redirige vos clients vers le portail PayPal juste après les avoir envoyés à l'redirectURL/PartialRedirectUrl :

  • En savoir plus sur ces propriétés et leur plage de valeurs acceptées dans notre API.
  • Assurez-vous que la méthode de paiement que vous souhaitez utiliser est active dans votre compte de test/production. Vérifiez dans le Back Office via Configuration > Méthodes de paiement.
  • Inclure/Exclure des groupes de paiement / produits sur l'écran de sélection de méthode de paiement. Utilisez soit une sélection d'ID de moyen de paiement, soit des groupes prédéfinis :

Grouper les méthodes de paiement par carte

La propriété hostedCheckoutSpecificInput.cardPaymentMethodSpecificInput.groupCards=true vous permet de regrouper toutes les méthodes de paiement par carte de crédit en un groupe "Cartes" sur la Hosted Checkout Page.

Le regroupement peut être un outil pratique pour ajouter de la clarté à l'écran de sélection de paiement.

Toutes vos moyens de paiement par carte actifs dans votre compte sont inclus dans ce groupe. Une fois que vos clients sélectionnent "Cartes", nous les redirigeons vers pour qu'il saisisse le numéro de carte.

Notre plateforme détecte automatiquement le réseau de la carte dès que vos clients commencent à taper le numéro. Cela fonctionne également pour les cartes co-badgées (le cas échéant).

Si vos clients saisissent un numéro provenant d'un réseau de carte qui n'est pas disponible dans votre compte, il sera affich" "Numéro de carte incorrect ou incompatible".

Par conséquent, nous vous conseillons fortement d'informer vos clients dans votre environnement de boutique en ligne sur toutes les méthodes de paiement par carte disponibles avant de les rediriger vers la Hosted Checkout Page.

Contrôler le nombre de tentatives de paiement

La propriété hostedCheckoutSpecificInput.allowedNumberOfPaymentAttempts vous permet de limiter le nombre de tentatives de paiement pour les commandes de vos clients.

Cela aidera à

  • Atténuer la fraude (puisque les fraudeurs essaieront différents numéros de carte et/ou méthodes de paiement).
  • Réduire vos coûts de transaction (puisque Direct et/ou votre acquéreur pourraient vous facturer chaque nouvelle tentative, en fonction de votre contrat).

Pour ce faire, ajoutez cette propriété à votre requête CreateHostedCheckout standard avec une valeur entre 1 et 10. Après chaque tentative de paiement infructueuse (c'est-à-dire en raison d'une autorisation refusée ou d'un échec de la vérification 3-D Secure), nous redirigeons vos clients vers notre page d'état intermédiaire. S'il reste encore des tentatives, elle affichera un bouton "Réessayer", permettant aux clients d'essayer une autre carte et/ou méthode de paiement (selon votre pré-sélection des méthodes de paiement disponibles). Si la dernière tentative échoue, notre page d'état intermédiaire dira "Vous avez atteint le nombre maximum de tentatives". Notre plateforme redirigera alors vos clients vers votre returnURL.

  • Si vous omettez allowedNumberOfPaymentAttempts dans votre requête, notre plateforme accorde 10 tentatives.
  • Trouvez des informations détaillées sur cette propriété dans notre API Reference.

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.