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 existants. Pour vous guider dans cette procédure pas-à-pas, nous avons conçu un outil de migration des données disponible dans le Dashboard Stripe.
Comment accéder à cet outil de migration ?
Suivez ce lien pour accéder à cet outil dans le Dashboard. Le cas échéant, vous serez d'abord invité à activer la version bêta de Workbench. Veuillez procéder en sélectionnant « Commencer la migration avec Workbench ».
La page principale de notre outil est l'onglet « Récapitulatif », qui a été conçu pour :
Une fois que vous aurez cessé de traiter des paiements via l'API Sources, tous les moyens de paiement seront associés à une coche verte, confirmant que la migration est terminée.
En regard de l'onglet « Récapitulatif », vous verrez s'afficher un onglet supplémentaire pour chaque moyen de paiement réutilisable qui requiert une migration des données. Cet onglet aura pour nom « Migration Sources {type} », dans lequel {type} sera remplacé par « des prélèvements automatiques SEPA », « des prélèvements automatiques Bacs » ou « d'Alipay ».
Cet onglet vous guide étape par étape dans le processus de migration. À mesure de votre avancement, chaque étape sera mise en surbrillance sur la gauche avec à droite les instructions correspondantes.
Quand utiliser l'outil de migration ?
Afin de ne plus créer de nouveaux objets Sources réutilisables, nous vous recommandons d'exécuter l'outil après avoir migré votre intégration pour utiliser les API PaymentIntents et PaymentMethods. 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 fois ?
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 des 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 tunnel 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 tunnels de paiement.
Les nouveaux objets ne seront pas utilisés dans vos tunnels 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 basculant vers ce mode à l'aide du bouton dédié, situé en haut à droite de l'écran du Dashboard. Vous pouvez également accéder à 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 directement associés à 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 devez vous connecter au Dashboard Stripe de chacun d'eux pour réaliser la migration des données en leur nom. Nous avons conscience qu'il s'agit d'une approche fastidieuse pour ceux qui disposent de nombreux comptes connectés. Nous travaillons actuellement sur la question et reviendrons vers les plateformes dès qu'une solution de substitution sera en place. Dans l'intervalle, si vous êtes prêt à réaliser votre migration et souhaitez collaborer directement avec nous afin de mener à bien cette étape pour un grand nombre de comptes connectés, veuillez nous contacter.