Si vous traitez des moyens de paiement réutilisables sur l'API Sources (prélèvements automatiques SEPA, prélèvements automatiques Bacs ou Alipay), il vous faudra migrer les données pour convertir vos objets Sources réutilisables en PaymentMethods. Cette mesure vous permettra de continuer à traiter les paiements récurrents sans aucune interruption pour vos clients actuels. 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?

Cliquez sur ce lien pour accéder à cet outil dans le Dashboard. Le cas échéant, vous serez d'abord invité(e) à activer la version d'essai de Workbench. Pour ce faire, sélectionner « Commencer la migration avec Workbench ». 

La page principale de notre outil est l'onglet « Résumé », qui a été conçu pour :

• Clarifier les moyens de paiement que vous avez déjà acceptés jusqu'ici par le biais de l'API Sources.
• Indiquer par une croix rouge (« x ») les moyens de paiement traités par l'intermédiaire de cette API au cours des dernières 24 heures, des 7 derniers jours ou des 31 derniers jours. 

Une fois que vous aurez cessé de traiter des paiements par l'entremise de l'API Sources, tous les moyens de paiement seront associés à une coche verte, ce qui confirme que la migration est terminée.

À côté de l'onglet « Résumé », vous verrez un onglet supplémentaire pour chaque moyen de paiement réutilisable qui requiert une migration des données. Cet onglet s'intitulera « Migration Sources{type} », dans lequel {type} sera remplacé par « Prélèvements automatiques SEPA », « Prélèvements automatiques Bacs » ou « Alipay ».

Cet onglet vous guide étape par étape dans le processus de migration. Au fur et à mesure que vous progressez dans le processus, chaque étape est mise en évidence sur le côté gauche et des instructions correspondantes pour terminer cette étape se trouvent sur le côté droit. 

Quand dois-je utiliser l'outil de migration? 

Nous vous recommandons d'exécuter l'outil de 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 exécutée par l'outil consiste à vérifier qu'aucun objet Sources n'a été créé au cours des dernières 24 heures. 

Puis-je exécuter l'outil de migration à plusieurs reprises? 

Nous vous recommandons de procéder à la migration de tous les objets Sources en une seule fois. En cas de besoin, l'outil peut toutefois être exécuté à plusieurs reprises en toute sécurité. L'outil vérifie d'abord si les objets Sources ont déjà été migrés et ne crée de PaymentMethods que pour ceux dont ce n'est pas le cas. 

L'outil de migration est-il sécurisé? Puis-je l'utiliser sans perturber mon flux de paiement?

Oui, la conversion d'objets Sources en PaymentMethods (étape 2) est sécurisée. Les deux ensembles d'objets, anciens (Sources) et nouveaux (PaymentMethods), seront actifs et facturables (compatibles avec la création de paiements) de sorte que la conversion n'interrompe pas vos flux de paiement.

Les nouveaux objets ne seront pas utilisés dans vos flux de paiement avant que vous ayez mis à jour votre code et défini les nouveaux PaymentMethods par défaut pour vos clients, vos factures ou vos abonnements à l'étape 4. L'étape 6, qui dissocie les anciens objets Sources et fait en sorte d'empêcher qu'ils soient réutilisés, est la seule qui est irréversible. Avant d'exécuter cette étape, assurez-vous d'avoir supprimé de votre code toutes les références aux anciens objets Sources et d'avoir effectué les mises à jour nécessaires pour faire référence aux nouveaux PaymentMethods.

Comment tester l'outil avant de l'utiliser en mode production?

Vous pouvez utiliser l'outil de migration en mode test en le basculant vers ce mode à l'aide du bouton à cet effet, situé en haut à droite de l'écran. Vous pouvez également vous rendre sur la page https://dashboard.stripe.com/test/dashboard. Une fois le Dashboard en mode test, vous pouvez exécuter l'outil de migration sur n'importe quel objet test réutilisable existant (ou utiliser l'API Stripe pour créer de nouveaux objets à migrer en mode test).

Je suis une plateforme Connect. Comment l'outil de migration fonctionne-t-il pour moi?

Si tous vos objets Sources sont associés directement à votre compte de plateforme, vous pouvez utiliser l'outil tel quel et suivre le processus de migration des données comme décrit ci-dessus.

En revanche, si vos objets Sources sont associés à vos comptes connectés, vous devrez vous connecter au Dashboard Stripe de chacun d'eux pour effectuer la migration des données en leur nom. Nous comprenons que cela peut être fastidieux si vous avez de nombreux comptes connecté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 prêt(e) à terminer votre migration et que vous souhaitez travailler directement avec nous pour mener à bien cette étape pour un grand nombre de comptes connectés, contactez le service d'assistance.