Migrate to Batch
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 Batch est la version améliorée Direct du mode d'intégration Worldline Batch (advanced) hérité. Vous collectez les données de carte de vos clients ou utilisez des tokens existants pour soumettre des transactions à votre propre rythme.
- Scalabilité optimisée pour la soumission de très grands volumes de transactions/opérations de maintenance
- Sécurité renforcée en incluant directement les données dans le corps de la requête
- Validation robuste des données grâce à des contrôles en amont
Ce guide explique comment migrer de Worldline Batch (advanced) vers Direct Batch.
Direct ne prend pas en charge le mode d’intégration hérité Worldline Batch (Basic).
Faites le pas
Grâce aux API REST Direct et aux fonctionnalités de notre plateforme, la migration de l’intégration Batch (advanced) héritée vers le Direct Batch est simple.
Utilisez cette liste de contrôle pour nous laisser vous guider tout au long du processus de migration:
Faites le pas
- Get familiar with Batch
- Comprendre les différences entre l’ancien Worldline Batch (advanced) et Direct Batch
- Configurer/Créer un compte de test
- Choose the way you want to implement Direct
- Modifier l’URL de l’endpoint cible et le format du fichier batch
- Configurez votre compte de test
- Assurez-vous de recevoir les retours de transaction de notre plateforme
Get familiar with Batch
Familiarisez-vous avec Batch, le flux de paiement et ses fonctionnalités spécifiques à Direct.
View Batch
Comprendre les différences entre l’ancien Worldline Batch (advanced) et Direct Batch
Direct Batch implémente la même fonctionnalité principale que l’ancienne intégration Worldline Batch (advanced) : l’upload en masse de données de carte pour le traitement asynchrone des transactions.
Cependant, certaines différences sont à prendre en compte lors de la migration :
| Élément | Direct Batch | Ancien Worldline Batch (advanced) |
|---|---|---|
| URLs des endpoints cibles | Endpoints dédiés pour chaque étape du cycle de vie d’un fichier Batch. Pour en savoir plus, consultez le chapitre « 4. Modifier l’URL de l’endpoint cible et le format du fichier batch ». | Un seul endpoint pour chaque étape du cycle de vie d’un fichier Batch. |
| Pipeline d’analyse des fichiers | Analyse automatique/validation du format de fichier. | Analyse et validation du format de fichier en plusieurs étapes (manuelles). |
| Format du fichier Batch | Prend uniquement en charge les données JSON. Pour en savoir plus, consultez le chapitre « 4. Modifier l’URL de l’endpoint cible et le format du fichier batch ». | Intégration classique d’upload de fichier ASP. Prend en charge plusieurs formats de fichier. |
| Modèle de validation du fichier Batch | Les fichiers Batch sont soit valides, soit invalides. | Distinction entre états de Batch valides / invalides / partiellement valides. |
| Notification de complétion du Batch / retour sur les transactions | Un endpoint dédié fournit le statut global du fichier Batch, mais pas de reporting détaillé des transactions. Voir « 6. Assurez-vous de recevoir les retours de notre plateforme ». | Notifications par e-mail de notre plateforme concernant les résultats de validation des fichiers batch. Reporting détaillé des transactions disponible via un endpoint dédié. |
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.
Choose the way you want to implement Direct
1Utilisez nos SDK
Nos SDK Serveur encapsulent l’API Direct de manière très efficace et accessible, ce qui vous permet de créer facilement votre propre application.
2Créer des intégrations personnalisées
Pour vous libérer de toute dépendance, tous nos endpoints d’API REST sont également directement accessibles via un processus d’authentification spécifique.
Modifier l’URL de l’endpoint cible et le format du fichier batch
Modifiez l’URL de l’endpoint cible et le formatage des données pour traiter des transactions ou des opérations de maintenance.
URLs des endpoints cibles
Batch via Direct/hérité utilise des endpoints d’API distincts pour chaque étape du flux de traitement batch.
| Endpoint hérité | Endpoint Direct |
|---|---|
|
https://ogone.test.v-psp.com/ncol/test/AFU_agree.asp Utilisé pour
en une seule fois ou en plusieurs étapes. |
Utilisé uniquement pour l’upload et la validation des données en une seule fois. |
|
Utilisé pour traiter des données préalablement uploadées. |
|
|
https://ogone.test.v-psp.com/ncol/test/payment_download_ncp.asp Utilisé pour récupérer les transactions contenues dans un fichier batch. |
Notre plateforme renverra uniquement un rapport de statut concernant la demande d’upload du batch, et non les transactions individuelles. |
Format du fichier Batch
Les fichiers batch hérités sont des fichiers texte brut, chaque ligne individuelle représentant une transaction. Batch via Direct est basé sur JSON, ce qui vous oblige à reformater les données envoyées dans vos requêtes. Notre guide dédié Direct Batch fournit des informations détaillées, à la fois pour les instructions générales et pour les cas d’usage spécifiques.
Configurez votre compte de test
Direct réduit vos efforts en externalisant la plupart des paramètres techniques du Back Office vers l’API Direct. Cependant, vous devez effectuer quelques configurations de base dans votre compte :
- Configurez votre API Key/API Secret pour mettre en place le mécanisme d’authentification Direct. Consultez notre guide dédié pour savoir comment procéder.
- Configurez votre Webhooks Key/Webhooks Secret pour recevoir les retours concernant les transactions traitées. Consultez notre guide dédié pour savoir comment procéder.
Consultez notre guide complet pour découvrir comment vos paramètres de compte existants sont traduits dans l’API Direct.
Assurez-vous de recevoir les retours de transaction de notre plateforme
Le endpoint Batches renvoie uniquement un rapport de statut concernant la demande d’upload du batch, et non les transactions individuelles.
Un reporting détaillé des transactions Batch est disponible via l’e-Portal, notre plateforme de gestion des informations clients entreprise.
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.
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.