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 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 Batch.
ne prend pas en charge le mode d’intégration hérité Worldline Batch (Basic).
Faites le pas
Grâce aux API REST et aux fonctionnalités de notre plateforme, la migration de l’intégration Batch (advanced) héritée vers le Batch est simple.
Utilisez cette liste de contrôle pour nous laisser vous guider tout au long du processus de migration:
- Se familiariser avec Batch
- Comprendre les différences entre l’ancien Worldline Batch (advanced) et Batch
- Configurer/Créer un compte de test
- Choose the way you want to implement
- Modifier l’URL de l’endpoint cible et le format du fichier batch
- Configurez votre compte de test
- Reporting et statut instantanné
Se familiariser avec Batch
Comprendre les différences entre l’ancien Worldline Batch (advanced) et Batch
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 | 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 Batch dédié fournit le statut au niveau du Batch-level status. Des résultats détaillés au niveau de la transaction sont disponibles via les fonctionnalités de reporting. | 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 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".
En complément de cela, assurez-vous que l'option Batch est activée pour l'abonnement de votre compte Contactez-nous pour le confirmer..
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
1Utilisez nos SDK
Nos SDK Serveur encapsulent l’API 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 /hérité utilise des endpoints d’API distincts pour chaque étape du flux de traitement batch.
| Endpoint hérité | Endpoint |
|---|---|
|
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. |
Un endpoint Batch dédié fournit le statut au niveau du Batch. Des résultats détaillés au niveau de la transaction sont disponibles via les fonctionnalités de reporting. |
Format du fichier Batch
Les fichiers batch hérités sont des fichiers texte brut, chaque ligne individuelle représentant une transaction. Batch via est basé sur JSON, ce qui vous oblige à reformater les données envoyées dans vos requêtes. Notre guide dédié 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
réduit vos efforts en externalisant la plupart des paramètres techniques du Back Office vers l’API . 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 . 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 .
Reporting et statut instantanné
Vous pouvez suivre les transactions Batch via le e-Portal.
Le e-Portal propose un reporting détaillé via des :
- Rapports immédiats pour un suivi en quasi temps-réel des transactionset pour les investigations.
- Rapports planifiés pour le reporting récurrent, la réconciliation et les exportations de données volumineuses.
Les fonctionnalités de reporting disponibles incluent :
- Le Reporting au niveau transactionne;
- Les Totaux agrégés des transactions;
- Les Reporting des Captures;
- La Livraison automatisée des rapports via SFTP;
Veuillez vous reporter au chapitre du guide e-Portal pour plus d'information.
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.
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, implémente trois propriétés pour représenter le statut d'une transaction :
- status
- statusCategory
- statusCode
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
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.