Migrer des abonnements vers Stripe Billing à l'aide du kit d'outils

Créez un environnement de test dans le Dashboard si vous souhaitez d’abord effectuer un test de migration.

1. Accédez au Dashboard > Abonnements > Migrations.

   Vous pouvez également cliquer sur le menu déroulant) à côté de + Créer un abonnement, et sélectionner Migrer les abonnements.

2. Pour démarrer votre migration, cliquez sur Commençons.

Exportez tout d’abord vos abonnements existants en faisant correspondre les données exportées à un fichier CSV compatible avec la migration. Vous pouvez créer votre propre fichier CSV ou télécharger l’un des modèles CSV suivants fournis par Stripe :

• Basique
• Articles à prix multiples
• Tarifs ad hoc

Vous trouverez également des exemples de fichiers CSV pour les cas d’usage courants en matière de migration dans la Référence pour le fichier CSV du kit d’outils.

1. Cliquez sur Télécharger le modèle au format CSV.

2. Choisissez un modèle CSV (basique, articles à prix multiples ou tarifs ad hoc) en fonction de votre cas d’usage en matière de facturation.

   CSV basique

   Cet exemple montre une migration d’abonnements pour des cas d’usage courants, notamment la migration des quantités, taxes, dates de début du cycle de facturation, réductions, périodes d’essai ou antidatages.

   Spécifier les champs suivants pour un fichier CSV basique :

   Fichier CSV d’articles à prix multiples

   Cet exemple illustre une migration comportant plusieurs produits par abonnement.

   Spécifier les champs suivants pour un fichier CSV d'articles à prix multiples :

   Tarifs ad hoc CSV

   Cet exemple illustre la gestion d’une migration d’abonnement à l’aide de tarifs ad hoc pour des produits existants.

   Spécifier les champs suivants pour un fichier CSV de tarifs ad hoc :

3. Dans le fichier CSV, indiquez les informations des abonnements que vous souhaitez exporter.

   Pour les migrations Stripe vers Stripe

   Si vous effectuez des migrations d’abonnements entre des comptes Stripe, reportez-vous à l’exemple CSV avant de spécifier et de télécharger un fichier CSV.

Cliquez sur Charger un fichier CSV. La taille limite des fichiers CSV est de 120 Mo.

Stripe valide le fichier pour vérifier que les abonnements chargés sont au format CSV requis. Ce processus peut prendre jusqu’à quelques heures selon la taille du fichier. Si le fichier est valide, vous pouvez passer à l’étape suivante de la migration.

Résoudre les erreurs de validation

Si le fichier que vous avez chargé comporte des erreurs, le kit d’outils affiche un récapitulatif des échecs. Pour corriger les erreurs :

1. Cliquez sur Télécharger le fichier pour vérifier les erreurs.

2. Vérifiez la colonne processing_error pour voir les erreurs.

3. Corrigez toutes les erreurs. Les erreurs courantes incluent :

   Erreur	Résolution des problèmes
   Dates non valides	Assurez-vous que toutes les dates sont au format d’horodatage epoch ou Unix.
   Plage start_date incorrecte	Assurez-vous que la date de début start_date de chaque abonnement soit dans plus de 24 heures.
   Données manquantes	Assurez-vous que chaque enregistrement contient les champs requis.
   Tarif et taxe incompatibles	Veillez à ce que les tarifs respectifs pour les taux de taxe spécifiés aient le même tax_behavior (TTC ou hors taxes).

4. Cliquez sur Charger le fichier corrigé pour charger le fichier CSV corrigé (la taille du fichier CSV est limitée à 120 Mo).

5. Attendez que le nouveau processus de validation soit terminé pour voir l’état de validation le plus récent.

Une fois que Stripe a validé votre fichier CSV, vérifiez le récapitulatif des abonnements chargés afin de détecter d’éventuelles incohérences :

1. Faites une vérification croisée pour déterminer si les éléments suivants sont corrects :

   • Date de chargement
   • Nom du fichier chargé
   • Nombre d’abonnements
   • Nombre de clients
   • Date de mise en service du premier abonnement

2. Si tout est valide, cliquez sur Démarrer la migration.

   Si vous voyez des erreurs, cliquez sur Annuler la migration et recommencez la migration à partir de Télécharger un fichier CSV.

Après avoir examiné vos abonnements téléchargés, suivez la progression de votre migration :

Migration en cours

Vos abonnements sont mis en file d’attente pour être planifiés à la date de début spécifiée. Ce processus peut prendre de quelques minutes à quelques heures selon la taille du fichier. Par exemple, la validation et la migration de 100 000 abonnements prennent environ 30 minutes.

La boîte à outils de migration de Billing utilise la planification d’abonnement pour migrer vos abonnements. Vos abonnements peuvent ainsi rester à l’état planifié pendant 24 heures avant la mise en production. Dans un environnement de test, ce délai est réduit à 1 heure pour une évaluation et des tests plus rapides.

Abonnements planifiés

Après la migration, vos abonnements restent dans un état planifié pendant 24 heures avant la mise en production. Vous disposez de 10 heures pour annuler ces planifications d’abonnements via le kit d’outils.

Vous ne pouvez actuellement pas mettre à jour les abonnements planifiés à l’aide du kit d’outils. Si vous souhaitez mettre à jour vos abonnements planifiés, vous pouvez appeler le endpoint de mise à jour ou mettre à jour chaque abonnement (un par un) dans le Dashboard des abonnements.

Les clients ne peuvent pas annuler les abonnements planifiés via leur portail client. Ils ne peuvent annuler que les abonnements en cours.

Mettre vos abonnements en production

Après 24 heures, vos abonnements planifiés sont mis en production et facturent les clients aux dates de début applicables. Vous pouvez consulter tous vos abonnements en cours dans le Dashboard des abonnements.

Une fois la migration mise en production, nous vous recommandons de surveiller vos abonnements à partir du premier paiement. Assurez-vous que les dates de prélèvement et les montants des abonnements migrés correspondent à la start_date spécifiée.

Les clients peuvent annuler les abonnements en temps réel via leur portail client.

Surveiller les abonnements

Lorsque vous surveillez vos abonnements après que la migration a été mise en production, soyez attentif aux problèmes liés aux moyens de paiement.

Par exemple, vérifiez que les transactions ne comportent pas de codes de refus irrécupérables de l’émetteur, tels que incorrect_number, et prenez des mesures pour vous assurer que les factures sont payées. Envisagez de notifier les clients dont les moyens de paiement ne sont pas valides par d’autres canaux que l’e-mail, tels que des SMS ou des notifications dans l’application.

Lorsque vous utilisez le recouvrement automatique, vérifiez les factures en cours ou en retard pour vous assurer que les clients disposent bien de moyens de paiement par défaut, sans lequel le recouvrement de la facture ne pourrait avoir lieu.

Pour afficher toutes vos migrations :

1. Sélectionnez la migration que vous souhaitez examiner dans Migrations.

2. Pour ouvrir une migration, cliquez sur Afficher dans le menu déroulant.

   Vous pouvez suivre les champs suivants :

   • Date de chargement
   • Nom du fichier
   • ID de migration Stripe Billing
   • Nombre d’abonnements
   • État de la migration