Migrer vers Server-to-server
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.
.png?language_id=2)
Intro
Server-to-server est la version améliorée de Direct de la méthode d'intégration héritée Directlink. Offrant le flux de paiement le plus simple, elle permet un contrôle total de l'expérience de paiement.
- Adaptation visuelle flexible et personnalisation faciles
- Expérience de paiement fluide pour les clients utilisant les paiements Card On File ou notre solution Hosted Tokenization Page
Faites le pas
Grâce aux API REST de Direct et aux fonctionnalités de notre plateforme, la migration de l'DirectLink héritée vers la méthode d'intégration Direct Server-to-server est facile.
Utilisez cette liste de contrôle pour nous laisser vous guider tout au long du processus de migration:
- Familiarisez-vous avec le Server-to-server
- 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
- Adaptez votre page de paiement
- Assurez-vous de recevoir les retours de transaction de notre plateforme
- Testez votre nouvelle intégration
Familiarisez-vous avec le Server-to-server
Familiarisez-vous avec la méthode d'intégration Server-to-server, le flux de paiement et ses fonctionnalités spécifiques à Direct.
Voir Server-to-server
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
Utilisez nos SDK
Nos SDK Serveur encapsulent l'API Direct de manière très efficace et accessible, vous permettant de créer facilement votre propre application.











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 traiter les transactions.
Les paramètres hérités se traduisent par des propriétés Direct au format JSON dans votre requête 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 votre page de paiement
Comme les clients restent dans l'environnement de votre boutique en ligne, vous êtes complètement libre de concevoir votre page de paiement. Suivez nos meilleures pratiques pour une expérience de paiement optimisée.
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 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.