Migrer vers des dispositifs de mesure liés à la facturation

Comment passer des enregistrements d'utilisation aux dispositifs de mesure liés à la facturation.

Stripe met fin à la facturation reposant sur les enregistrement d’utilisation. Dorénavant, vous pouvez migrer vers les dispositifs de mesure, notre seule solution pour la facturation à l’usage. Les dispositifs de mesure offrent les avantages suivants :

Envoi de données d’utilisation à haut débit
Délai de grâce d’une heure pour la génération de factures
Collecte des données d’utilisation avant la création d’un abonnement

Toutefois, nous ne prenons pas en charge les fonctionnalités suivantes :

max formule d’agrégation

Vous pouvez continuer à utiliser les enregistrements d’utilisation en même temps que vous adoptez les dispositifs de mesure liés à la facturation.

Aperçu du dispositif de mesure lié à la facturation

Les dispositifs de mesure liés à la facturation permettent de suivre l’utilisation d’un événement particulier. Ils prennent en charge l’ingestion et l’agrégation d’événements à haut débit.

Contrairement aux enregistrements d’utilisation, les dispositifs de mesure liés à la facturation n’exigent pas que les clients aient souscrit un abonnement avant de communiquer les données d’utilisation, et un seul dispositif de mesure peut suivre l’utilisation de plusieurs clients.

Comprendre les dispositifs de mesure liés à la facturation en consultant notre guide d’implémentation.

Créer un dispositif de mesure de la consommation

Créez un dispositif de mesure à des fins de facturation. En savoir plus sur la configuration des dispositifs de mesure.

Créer un nouveau tarif

Créez un nouveau tarif associé au dispositif de mesure lié à la facturation. Veillez à ce que le nouveau tarif concerne le même produit que l’ancien.

Commencer l'enregistrement de l'utilisation

Remarque

Vous devez continuer d’envoyer des enregistrements de consommation à Stripe jusqu’à ce que la migration soit terminée.

Commencez à communiquer l’utilisation à l’API Billing Meter. Stripe ne reflète pas cette utilisation sur les factures des clients tant qu’ils ne sont pas abonnés au nouveau tarif.

En savoir plus sur l’enregistrement de l’utilisation.

FacultatifInterroger l'enregistrement d'utilisation

Gérer la planification d'abonnements

Utilisez les planifications d’abonnement pour passer automatiquement au nouveau tarif à la fin du cycle de facturation. En savoir plus sur les planifications d’abonnement.

Listez les abonnements associés à l’ancien tarif.

Stripe renvoie une liste d’abonnements associés à l’ancien tarif. Par exemple :

{
  "object": "list",
  "data": [
    {
      "id": "sub_1P1Y6gDxxK6kAaV0rS7ojBjh"
,
      "object": "subscription",
      ...
      "items": {
        "object": "list",
        "data": [
          {
            "id": "si_PrGdqMmuM1DGbQ"
,
            "object": "subscription_item",
            ...
            "price": {
              "id": "{{OLD_PRICE_ID}}",
              "object": "price",
              ...
              "recurring": {
                "aggregate_usage": "sum",
                "interval": "month",
                "interval_count": 1,
                "trial_period_days": null,
                "usage_type": "metered"
              },
              ...
            },
            ...
          }
        ],
        ...
      },
      ...
      "schedule": {
        "id": "sub_sched_1P1XxjDxxK6kAaV0YygN4tf7"
,
        "object": "subscription_schedule",
        ...
        "current_phase": {
          "end_date": 1714759200,
          "start_date": 1712167200
        },
        ...
        "phases": [
          {
            ...
            "end_date": 1714759200,
            ...
            "items": [
              {
                ...
                "price": "{{OLD_PRICE_ID}}",
                ...
              }
            ],
            ...
            "start_date": 1712167200,
            ...
            "trial_end": 1712772000
          }
        ],
        ...
      },
      ...
    },
    ...
  ],
  "has_more": false,
  "url": "/v1/subscriptions"
}

Si un abonnement dispose d’une planification, vous devez mettre à jour la planification d’abonnement existante pour passer au nouveau tarif à la fin d’un cycle de facturation. Si aucune planification n’existe pour un abonnement, créez-en une.

Créez une planification d’abonnement pour chaque abonnement associé à l’ancien tarif.

Stripe renvoie un nouvel objet de planification d’abonnement :

{
  "id": "sub_sched_1P1H37DxxK6kAaV0Iggc537m"
,
  "object": "subscription_schedule",
  ...
  "current_phase": {
    "end_date": 1714693634,
    "start_date": 1712101634
  },
  ...
  "phases": [
    {
      ...
      "end_date": 1714693634,
      ...
      "items": [
        {
          ...
          "price": "{{OLD_PRICE_ID}}",
          ...
        }
      ],
      ...
      "start_date": 1712101634,
      ...
    }
  ],
  ...
  "status": "active",
  ...
}

Mettez à jour la planification d’abonnement pour ajouter une phase avec le nouveau tarif.

Tester la migration

Créez un client test avec un abonnement associé à l’ancien tarif.

Accédez à l’onglet Clients.
Cliquez sur + Ajouter un client.
Saisissez le nom du client.
Accédez au nouveau client.
En regard de l’en-tête Subscriptions, cliquez sur + pour ouvrir le volet des abonnements.
Sélectionnez l’ancien tarif.
Cliquez sur Créer un abonnement test.

Créer une planification d’abonnement à partir de l’abonnement.

Ajoutez une phase à la planification d’abonnement pour migrer vers le nouveau tarif.

Simulez la modification d’abonnement à l’aide d’une horloge de simulation.

Découvrez comment tester les intégrations d’abonnement. Vous pouvez utiliser des horloges de simulation pour tester différents scénarios, notamment des rapports d’utilisation fictifs. Comprendre les horloges de simulation.