Migrer vers Direct

Worldline Direct est la plateforme de paiement modernisee remplacant les systemes Worldline herites. Ce guide vous aide a migrer vers la solution contemporaine basee sur une API REST avec des capacites ameliorees.

Pourquoi migrer ?

Avantage	Description
Nouveaux moyens de paiement	Acces a plus de 10 nouveaux moyens de paiement
API moderne	Architecture API REST de pointe
Mobile first	Optimise pour les experiences mobiles
Conformite	Conforme au RGPD et a la DSP2
Developpement continu	Ameliorations continues des fonctionnalites

Apercu de la migration

Etapes de migration

Etape 1 : Activer Direct sur le compte de test

1. Connectez-vous a votre ancien Back Office
2. Naviguez vers Configuration > Compte > Vos options
3. Trouvez "DIR (Merchant using Direct integration)" dans les options disponibles
4. Cliquez sur Activer

remarque

L'option DIR peut deja etre activee par defaut. Verifiez la section Options par defaut si elle n'est pas visible.

Etape 2 : Examiner les moyens de paiement

Pris en charge sans modifications

Ces moyens de paiement fonctionnent parfaitement dans Direct :

• Visa, Mastercard, American Express
• Bancontact
• iDEAL
• Klarna
• Intersolve
• TWINT

Necessite des mises a jour de configuration

Methode	Action requise
PayPal	Configurer dans le Portail Marchand
Przelewy24	Contacter le fournisseur de paiement
EPS	Contacter le fournisseur de paiement

Periode de transition

Lors de l'activation de PayPal, Przelewy24 ou EPS pour Direct, ils peuvent cesser de fonctionner sur les systemes herites selon le statut de votre compte. Utilisez le parametre EXCLPMLIST pour les exclure des operations heritees pendant la transition.

Nouveau dans Direct

Profitez de ces nouveaux moyens de paiement :

• Apple Pay, Google Pay, WeChat Pay
• Prelevement SEPA
• Virement bancaire par Worldline
• Bizum, MB Way, Multibanco
• Oney, FloaPay (options BNPL)

Non disponible dans Direct

Certaines methodes heritees n'ont pas d'equivalent Direct :

• Pass ES
• Visa Purchasing Card
• American Express CPC
• PaySafeCard
• GiroPay
• Ikano

Etape 3 : Choisir la methode d'integration

Faites correspondre votre integration actuelle a l'equivalent Direct :

Methode legacy	Equivalent Direct	Documentation
Hosted Payment Page	Page de paiement hebergee	Voir le guide
FlexCheckout	Page de tokenisation hebergee	Voir le guide
DirectLink	Serveur a serveur	Voir le guide
e-Terminal	e-Terminal	Portail Marchand

Nouvelles options d'integration :

• Pay-by-link - Generation de lien de paiement sans code
• SDKs mobile/client - Integration d'application native

Etape 4 : Approche d'implementation

Choisissez votre methode d'implementation :

Plugins (le plus simple)

Integrations pre-construites pour les principales plateformes :

Plateforme	Plugin disponible
Magento 2.4	Oui
WooCommerce	Oui
PrestaShop	Oui
Shopify	Oui
BigCommerce	Oui
SAP Commerce Cloud	Oui
Salesforce Commerce Cloud	Oui

SDKs

SDKs serveur :

• .NET
• Java
• Node.js
• PHP
• Python
• Ruby

SDKs client :

• iOS (Swift/Objective-C)
• Android
• JavaScript
• Flutter
• React Native

Integration personnalisee

Acces direct a l'API en utilisant l'authentification standard pour des implementations entierement personnalisees.

Etape 5 : Tester votre integration

Important

Les donnees de test de l'ancien Back Office ne sont pas pertinentes pour Direct. Utilisez uniquement les donnees de test specifiques a Direct.

Testez minutieusement dans l'environnement sandbox :

1. Utilisez l'API Explorer pour tester les scenarios
2. Testez tous les moyens de paiement que vous prevoyez de prendre en charge
3. Verifiez que les webhooks sont correctement recus
4. Testez les flux 3-D Secure
5. Validez la gestion des erreurs

Numeros de cartes de test :

Carte	Numero	Scenario
Visa (Succes)	4111 1111 1111 1111	Approuve
Visa (3DS)	4012 0000 3333 0026	Challenge 3DS
Visa (Refus)	4000 0000 0000 0002	Refuse

Etape 6 : Mise en production

Une fois les tests termines :

1. Repliquez votre configuration de test dans le compte de production
2. Activez l'option DIR dans le Back Office de production
3. Basculez votre application vers les points d'acces de production
4. Surveillez attentivement les transactions apres la mise en production

Procedez avec prudence

Les erreurs de configuration en production peuvent perturber vos flux de paiement existants. Verifiez tous les parametres avant l'activation.

Changements de points d'acces API

Environnement	Legacy	Direct
Test	Divers points d'acces legacy	https://payment.preprod.direct.worldline-solutions.com
Production	Divers points d'acces legacy	https://payment.direct.worldline-solutions.com

Differences cles par rapport au legacy

Authentification

Legacy	Direct
Signature SHA	Cle API + Secret API (HMAC)
Plusieurs methodes de signature	v1HMAC standardise

Architecture API

Legacy	Direct
Parametres POST	API JSON RESTful
Divers points d'acces	URLs basees sur les ressources coherentes
Reponses XML/HTML	Reponses JSON

Webhooks

Legacy	Direct
Notifications par email	Evenements webhook
Verifications de statut Back Office	Callbacks HTTP en temps reel
Types d'evenements limites	Couverture complete des evenements

Continuite du compte

Vos comptes PREPROD et PROD existants continuent de fonctionner sous Direct. Aucune creation de nouveau compte n'est requise, seulement une reconfiguration.

Support pendant la migration

• Support technique - Disponible pour les clients existants
• Documentation API - Reference API et Explorer complets
• Environnement de test - Sandbox complet pour la validation
• Plugins - Solutions pre-construites pour les principales plateformes

Besoin d'aide ?

Contactez votre gestionnaire de compte Worldline ou le support technique pour une assistance a la migration.

Checklist de migration

• Activer l'option DIR sur le compte de test
• Examiner la compatibilite des moyens de paiement
• Choisir la methode d'integration (plugin/SDK/personnalise)
• Mettre a jour les points d'acces API
• Implementer la nouvelle authentification
• Configurer les webhooks
• Tester tous les flux de paiement
• Tester les scenarios d'erreur
• Activer l'option DIR en production
• Mettre a jour la configuration de production
• Surveiller apres la migration

Prochaines etapes

• Demarrer avec Direct
• Choisir une methode d'integration
• Configurer les webhooks
• Configurer 3-D Secure