Si vous traitez des moyens de paiement réutilisables sur l'API Sources (prélèvement automatique SEPA, prélèvement automatique Bacs ou Alipay), vous devrez effectuer une migration de données pour convertir vos objets Sources réutilisables en objets PaymentMethods. Cela vous permettra de continuer à traiter les paiements récurrents sans interruption pour vos clients existants. Pour vous guider dans ce processus de migration étape par étape, nous avons créé un outil de migration de données dans le Dashboard Stripe.
Comment accéder à cet outil de migration?
Vous pouvez accéder à cet outil en cliquant sur ce lien vers votre Dashboard. Si vous ne l'avez pas encore fait, vous devrez d'abord accepter de participer à une version bêta de Workbench. Veuillez accepter en sélectionnant « démarrer la migration avec Workbench ».
La page principale de l'outil est l'onglet « Résumé », qui est conçu pour :
Une fois que vous avez cessé de traiter les paiements au moyen de l'API Sources, des coches vertes seront affichées pour tous les moyens de paiement, ce qui confimera que vous avez terminé la migration.
À côté de l'onglet « Résumé », vous verrez un onglet supplémentaire pour chaque moyen de paiement réutilisable qui nécessite une migration de données. Cet onglet sera intitulé « Migrer Sources {type} » où {type} est « Prélèvement automatique SEPA », « Prélèvement automatique Bacs » ou « Alipay ».
Cet onglet vous guidera étape par étape dans le processus de migration. Au fur et à mesure que vous avancez dans le processus, chaque étape est mise en évidence sur le côté gauche, avec les instructions correspondantes pour effectuer l'étape en question sur le côté droit.
Quand utiliser l'outil de migration?
Nous vous recommandons d'exécuter la migration après avoir migré votre intégration pour utiliser les API PaymentIntents et PaymentMethods afin de ne plus créer de nouveaux objets Source réutilisables. La première étape de l'outil consiste à vérifier que vous n'avez pas créé de Sources au cours des dernières24 heures.
Puis-je exécuter l'outil de migration plusieurs fois?
Nous vous recommandons d'exécuter la migration une seule fois pour migrer tous les objets Source en une seule fois. Toutefois, si vous devez exécuter à nouveau l'outil de migration, vous pouvez le faire sans problème. L'outil vérifie d'abord si un objet Source a déjà été migré et crée uniquement des PaymentMethods pour les objets qui n'ont pas encore été migrés.
L'outil de migration est-il sécuritaire? Puis-je l'utiliser sans perturber mon flux de paiement?
Oui, vous pouvez convertir en toute sécurité les objets Sources en objets PaymentMethods (étape 2). Les deux ensembles d'objets (les anciens objets Sources et les nouveaux objets PaymentMethods) seront actifs et facturables (capables de créer des paiements), de sorte que la conversion ne perturbera pas vos flux de paiement.
Les nouveaux objets ne commenceront pas à être utilisés dans vos flux de paiement tant que vous n'aurez pas mis à jour votre code ou défini les nouveaux PaymentMethods par défaut pour les clients, les factures ou les abonnements à l'étape 4. La seule étape irréversible est l'étape 6, qui dissocie les anciens objets Source et les empêche d'être réutilisés. Avant d'exécuter cette étape, assurez-vous que vous avez supprimé toutes les références aux anciens objets Source de votre base de codes et que vous avez effectué les mises à jour nécessaires pour que votre système utilise plutôt les nouveaux objets PaymentMethods.
Comment tester l'outil avant de l'utiliser en mode production?
Vous pouvez utiliser l'outil de migration en mode test en passant le Dashboard Stripe en mode test à l'aide du bouton « Mode test » en haut à droite de l'écran. Vous pouvez également vous rendre sur la page https://dashboard.stripe.com/test/dashboard. Une fois que le Dashboard est en mode test, vous pouvez exécuter la migration sur tous les objets de test réutilisables existants (ou utiliser l'API Stripe pour créer de nouveaux objets en mode test à migrer).
Comment l'outil de migration fonctionnera-t-il pour moi en tant que plateforme Connect?
Si tous les objets Source sont directement associés à votre compte de la plateforme, vous pouvez utiliser l'outil de migration tel qu'il est conçu et suivre le processus de migration des données tel que décrit ci-dessus.
Toutefois, si les objets Source sont associés à vos comptes associés, vous pouvez vous connecter au Dashboard Stripe de chaque compte associé pour terminer la migration des données en leur nom. Nous comprenons que cela peut être fastidieux si vous avez de nombreux comptes associés. Nous travaillons sur une meilleure approche et fournirons une mise à jour aux plateformes une fois qu'une solution aura été mise en place. Entre-temps, si vous êtes sur le point de terminer votre migration et que vous souhaitez faire appel à nous directement pour mener à bien cette étape pour un grand nombre de comptes associés, veuillez nous contacter ici.