Migrer vers Hosted Tokenization Page
Avis important
Nos modes d'intégration, méthodes de paiement et fonctionnalités héritées resteront disponibles jusqu'au 31 décembre 2025.
Intro
La Hosted Tokenization Page est la version améliorée de Direct de l'FlexCheckout. Elle vous offre le niveau de personnalisation le plus élevé possible et est conforme au choix de marque dans le cadre du co-badging .
- Déléguez le traitement des données sensibles à notre plateforme pour être conforme à la norme PCI
- Adaptation visuelle et personnalisation flexibles et faciles
- Facilitez les achats futurs et les paiements Card On File
Faites le pas
Grâce aux API REST de Direct et aux fonctionnalités de notre plateforme, la migration de l'Flexcheckout héritée vers le Direct Hosted Tokenization Page est facile.
Use this checklist to let us guide you through the whole migration proces:
- Familiarisez-vous avec le Hosted Tokenization Page
- Comprendre les similitudes et les différences entre Hosted Tokenization Page et FlexCheckout
- Configurer/Créer un compte de test
- Choisissez la manière dont vous souhaitez implémenter Direct
- Modifiez l'URL de l'endpoint cible et votre page de paiement
- Configurez votre compte de test
- Adaptez le Hosted Tokenization Page
- Assurez-vous de recevoir les retours de transaction de notre plateforme
- Testez votre nouvelle intégration
Familiarisez-vous avec le Hosted Tokenization Page
Familiarisez-vous avec le Hosted Tokenization Page, le flux de paiement et ses fonctionnalités spécifiques à Direct.
Voir la Hosted Tokenization Page
Comprendre les similitudes et les différences entre Hosted Tokenization Page et FlexCheckout
Le Hosted Tokenization Page implémente les mêmes fonctionnalités que FlexCheckout :
- Vos clients restent sur votre page de paiement pour entrer les détails de carte pertinents pour PCI.
- Ils saisissent les données de la carte dans un formulaire intégré dans un <iframe> hébergé par notre serveur.
- Notre plateforme tokenise les données de la carte. Nous retournons un token (temporaire) que vous pouvez utiliser pour initialiser le paiement réel.
- En utilisant ce token, vous demandez le paiement réel via une deuxième méthode d'intégration dédiée. Server-to-server remplace DirectLink pour cette étape.
Cependant, il y a certaines différences à prendre en compte lors de la migration :
| Article | Hosted Tokenization Page | FlexCheckout |
|---|---|---|
|
<iframe> |
En invoquant la fonction initialize() de ce code Javascript, vous ajoutez le <iframe> à votre page de paiement. |
Vous ajoutez le <iframe> à votre page de paiement en utilisant votre propre code. |
|
<iframe> |
En invoquant la fonction initialize() de ce code Javascript, l'URL cible s'ouvre automatiquement lors de l'ajout du <iframe>. |
Vous ouvrez l'URL cible lors de l'ajout du <iframe> sur votre page de paiement. |
|
Bouton de soumission des données de la carte |
Situé sur votre page de paiement. |
Fait partie du <iframe> lui-même. |
|
Obtention du token |
Lors de l'invocation de la fonction submitForm() de ce code Javascript, nous retournons le token en tant que valeur de retour. |
Via un paramètre GET à une URL que vous avez définie lors de l'initialisation du <iframe>. |
|
Obtention du résultat de la transaction |
Via une requête GetPaymentDetails ou des webhooks. En savoir plus dans le chapitre dédié. |
Via une requête DirectQuery ou des canaux de retour de la Hosted Payment Page. |
Configurer/Créer un compte de test
Vous pouvez continuer à utiliser votre compte PREPROD (test) existant pour commencer. Pour activer Direct dans votre compte PREPROD (test), suivez ces étapes :
- Connectez-vous au Back Office PREPROD (test).
- Allez dans Configuration > Abonnement > Vos options.
- Dans "Options disponibles", recherchez "DIR (Marchand utilisant l'intégration Direct)" et cliquez sur "Activer".
Si vous ne trouvez pas "DIR (Marchand utilisant l'intégration Direct)", c'est qu'il est activé par défaut. Consultez les "Options par défaut" pour confirmer.
Choisissez la manière dont vous souhaitez implémenter Direct
1Utilisez nos plugins
Le raccourci idéal: Installez l'un de nos plugins que vous pouvez utiliser parallèlement à votre version existante. Allez directement au guide correspondant pour le mettre en marche!
2Utilisez nos SDK
Vous souhaitez créer une application de toutes pièces? Nos SDK Serveur/SDK Client encapsulent l'API Direct de manière très efficace et accessible, vous permettant de créer votre propre boutique en ligne/application mobile.
Modifiez l'URL de l'endpoint cible et votre page de paiement
Modifiez l'URL de l'endpoint cible et les données que vous devez envoyer à notre plateforme pour obtenir l'URL de tokenisation. Assurez-vous également d'ajouter ces éléments HTML/code Javascript à votre page de paiement.
Les paramètres hérités se traduisent par des propriétés Direct au format JSON dans votre requête CreateHostedTokenization/CreatePayment. Pour vous aider à recréer votre intégration héritée pour la nouvelle plateforme, utilisez ce mappage des propriétés des paramètres hérités Direct.
Configurez votre compte de test
Direct réduit vos efforts en externalisant la plupart des paramètres techniques du Back Office vers l'CreatePaymentAPI. Cependant, vous devez effectuer quelques configurations de base dans votre compte :
- Configurez votre clé API/Secret API pour mettre en place le mécanisme d'authentification de Direct. Lisez notre guide dédié pour apprendre comment faire cela.
- Configurez votre clé Webhooks/Secret Webhooks pour recevoir des retours concernant les transactions traitées. Lisez notre guide dédié pour apprendre comment faire cela.
Consultez notre guide complet pour en savoir plus sur la manière dont les paramètres de votre compte existant se traduisent dans l'API Direct.
Adaptez le Hosted Tokenization Page
Adaptez le Hosted Tokenization Page à l'apparence de votre boutique en ligne et améliorez encore le flux de paiement en
- Utilisant les différents outils de personnalisation avancée.
- Téléchargeant un modèle entièrement personnalisé ou une version adaptée de notre repository GitHub.
Assurez-vous de recevoir les retours de transaction de notre plateforme
Assurez-vous que l'infrastructure de votre boutique en ligne reçoit et traite les retours de transaction de notre plateforme selon la logique de payment.id.
Direct propose des webhooks et un point de terminaison GetPaymentDetails pour obtenir toutes les informations nécessaires afin de suivre vos commandes.
Pour améliorer la transparence, Direct implémente trois propriétés pour représenter le statut d'une transaction :
- status
- statusCategory
- statusCode
Pour un contrôle manuel rapide, consultez le statut des transactions dans le Merchant Portal. Lisez le chapitre dédié dans notre guide Merchant Portal pour apprendre comment faire cela.
Consultez notre guide complet sur les Statuts pour tous les codes de retour possibles, y compris un mappage du paramètre classique STATUS aux propriétés mentionnées ci-dessus.
Testez votre nouvelle intégration
Utilisez nos Cas de test pour déclencher des scénarios spécifiques pour tout moyen de paiement donné. Notre API Explorer vous permet de créer et de tester d'innombrables scénarios en seulement quelques clics !
Notez que les données de test / paramètres dans le Back Office (Configuration > Informations techniques > Informations sur les tests) sont sans pertinence pour Direct.
Passer en production
Êtes-vous prêt à passer en production ?
Utilisez votre compte en direct existant – pas besoin d'en créer un nouveau ! Mais assurez-vous de
- Modifier l'URL de l'endpoint cible (comme expliqué à l'étape 5)
- Configurer votre clé API/secret API et votre clé Webhooks/secret Webhooks (comme expliqué à l'étape 8)
- Transférer vos paramètres du Back Office hérités vers le Merchant Portal ou les externaliser à l'API Direct
Vous êtes maintenant prêt ? Commencez à profiter de tous les avantages de Direct!
- Modules de prévention des fraudes efficaces.
- De nombreuses fonctionnalités avancées.
- Directives sur les bonnes pratiques.