worldline Direct
S'inscrire

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.

Worldline Direct Server to Server Page screen

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.

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:

  1. Familiarisez-vous avec le Server-to-server
  2. Configurer/Créer un compte de test
  3. Choisissez la manière dont vous souhaitez implémenter Direct
  4. Modifiez l'URL de l'endpoint cible
  5. Configurez votre compte de test
  6. Adaptez votre page de paiement
  7. Assurez-vous de recevoir les retours de transaction de notre plateforme
  8. 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 :

  1. Connectez-vous au Back Office PREPROD (test).
  2. Allez dans Configuration > Abonnement > Vos options.
  3. 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

Vous êtes maintenant prêt ? Commencez à profiter de tous les avantages de Direct!

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.