Migrer vers Hosted Checkout 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
Le Hosted Checkout Page est la version améliorée de Direct de l'Hosted Payment Page. Solution préparée pour l'avenir, elle prend en charge plus de 40 méthodes de paiement (et ça ne fait qu'augmenter) et offre de vastes possibilités de personnalisation.
- Déléguez le traitement des données sensibles à notre plateforme pour être conforme à la norme PCI
- Adaptation visuelle flexible et facile
- Intégration facile, paiement instantané !
Faites le pas
Grâce aux API REST de Direct et aux fonctionnalités de notre plateforme, la migration de la Hosted Payment Page vers la Direct Hosted Checkout Page est facile.
Utilisez cette liste de contrôle pour nous laisser vous guider tout au long du processus de migration:
- Familiarisez-vous avec le Hosted Checkout Page
- Configurer/Créer un compte de test
- Choisissez la manière dont vous souhaitez implémenter Direct
- Modifiez l'URL de l'endpoint cible
- Configurez votre compte de test
- Adapter le Hosted Checkout Page
- Assurez-vous de recevoir les retours de transaction de notre plateforme
- Testez votre nouvelle intégration
Familiarisez-vous avec le Hosted Checkout Page
Familiarisez-vous avec le Hosted Checkout Page, le flux de paiement et ses fonctionnalités spécifiques à Direct.
Voir Hosted Checkout 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
Modifiez l'URL de l'endpoint cible et les données que vous devez envoyer à notre plateforme pour obtenir l'URL de redirection.
Les paramètres hérités se traduisent par des propriétés Direct au format JSON dans votre requête CreateHostedCheckout. Pour vous aider à recréer votre intégration héritée pour la nouvelle plateforme, utilisez ce paramètre hérité – mappage des propriété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'CreateHostedCheckoutAPI. 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.
Adapter le Hosted Checkout Page
Adaptez le Hosted Checkout Page à l'apparence de votre boutique en ligne.
Direct vous permet de personnaliser considérablement l'expérience de paiement de vos clients en
- Ajoutant des propriétés spécifiques à votre requête CreateHostedCheckout. Lisez notre guide dédié pour apprendre ce qui est possible et comment le faire.
- Modifiant le Hosted Checkout Page directement dans votre compte ou en téléchargeant un modèle entièrement personnalisable dans votre compte.
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 l’identifiant de paiement.
Direct propose des Webhooks et des points de terminaison GetHostedCheckout/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 des Statuts pour tous les codes de retour possibles, y compris le 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 4)
- Configurer votre clé API/secret API et votre clé Webhooks/secret Webhooks (comme expliqué à l'étape 5)
- 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.