Migrer des abonnements vers Stripe Billing à l'aide des API Stripe

Si vous avez besoin d’utiliser vos modèles tarifaires antérieurs dans Stripe, créez un produit substituable (par exemple, Legacy plan). En voici un exemple :

curl https://api.stripe.com/v1/products \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d id={{NEW_PRODUCT_ID}} \
  -d name="Legacy plan" \
  -d description="Imported legacy plan from source system" \
  -d "metadata[OLD_PRODUCT_ID]"={{OLD_PRODUCT_ID}}

Pour modifier des abonnements correspondant à des offres antérieures, transmettez les tarifs voulus à l’aide du paramètre items.price_data. Cette action remplace tous les tarifs existants. Pour en savoir plus, veuillez consulter la page consacrée aux tarifs variables.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price_data][currency]"=USD \
  -d "items[0][price_data][product]"={{PRODUCT_ID}} \
  -d "items[0][price_data][recurring][interval]"=month \
  -d "items[0][price_data][recurring][interval_count]"=3 \
  -d "items[0][price_data][unit_amount]"=1000 \
  -d "items[0][quantity]"=1

Une fois que vous avez importé vos clients et créé un modèle tarifaire, vous pouvez commencer à importer vos abonnements. Vous devriez pouvoir exporter les données d’abonnement des systèmes tiers via leur interface utilisateur ou leur API. Si cette option n’est pas proposée, contactez le prestataire auprès duquel vous avez créé vos abonnements.

Pour importer des abonnements, utilisez la liste de vos clients afin de créer pour chacun d’eux l’abonnement qui convient. Par exemple, si un abonné souscrit une offre d’abonnement mensuel Basic dans votre ancien modèle, utilisez le tarif récurrent mensuel associé à ce niveau lorsque vous créez son abonnement dans Stripe.

Rendre les données source compatibles avec Stripe

Avant de lancer l’importation des abonnements dans Stripe, veillez à ce que toutes vos données sources correspondent au format que nous attendons.

Champs importants pour migrer des abonnements

Si des données d’abonnement pertinentes sont utilisées dans votre intégration personnalisée mais pas par Stripe, vous pouvez appliquer vos données au champ metadata des abonnements que vous créez dans Stripe. Le tableau suivant décrit les autres champs importants à prendre en compte lors de l’importation d’abonnements.

Préparer les tarifs existants

Si vous avez créé des paramètres substituables pour vos anciens tarifs, vous devez faire correspondre ces tarifs aux abonnements et aux clients que vous importez. Pour chaque abonnement bénéficiant d’un ancien tarif, utilisez le paramètre price_data de l’API Subscriptions afin de transmettre des informations relatives au tarif et à l’abonnement. Les champs suivants sont obligatoires :

Importer des données d’abonnement dans Stripe

Une fois que vous avez préparé vos données sources, vous pouvez commencer l’importation de vos abonnements dans Stripe.

Tests

Utilisez un environnement de test pour réaliser au moins une fois le processus d’importation du modèle tarifaire avant de l’exécuter en mode production. Vous devez remapper votre script :

• Si vous supprimez les données dans l’environnement de test et que vous réalisez à nouveau l’importation.
• Au moment de passer en mode production, car les ID des tarifs diffèrent selon le mode utilisé.

Dans un environnement de test, vous pouvez utiliser des horloges de simulation pour tester l’évolution des abonnements dans le temps. Vous pouvez ainsi observer le comportement des abonnements migrés en mode production.

Créer des abonnements

Bien qu’il soit possible de créer des abonnements à l’aide de l’API Subscription, nous vous recommandons d’utiliser l’API Subscription Schedules, qui permet de planifier des abonnements démarrant à une date ultérieure. Par exemple, seule cette API vous donne la possibilité de démarrer des abonnements mensuels avec plus de 30 jours d’avance. Le fait de pouvoir planifier des abonnements futurs vous permet également de vérifier l’importation avant de lancer la facturation de vos clients en mode production.

En outre, l’API Subscription Schedules propose des phases, qui permettent une bien meilleure flexibilité en matière de définition de paramètres (tels que le comportement fiscal, la méthode d’encaissement et l’utilisation des bons de réduction) sur des périodes plus précises. Vous avez également la possibilité de définir un comportement différent pour des périodes distinctes. Par exemple, vous pourriez appliquer un bon de réduction pour les 3 premiers mois d’un abonnement annuel.

Voici comment créer des abonnements démarrant le 1 juin 2022 à 00:00 UTC.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "default_settings[billing_cycle_anchor]"=phase_start \
  -d "phases[0][items][0][price]"=
{{PRICE_ID}} \
  -d start_date=1654066801

Une fois vos abonnements importés, utilisez l’API pour vérifier que les abonnements ont bien été créés dans Stripe.

Pour afficher tous les abonnements dans Stripe, utilisez l’API List Subscriptions. Vous pouvez transmettre le paramètre created pour afficher uniquement les abonnements récents.

curl -G https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "created[gt]"=1647294709