Modifier le tarif des abonnements existants

Lorsqu’un client modifie son abonnement, vous devez modifier le poste d’abonnement pour qu’il prenne en compte la nouvelle sélection. Par exemple, un client peut passer à un niveau premium ou revenir à un niveau de base, ce qui vous demande de remplacer le tarif sous-jacent de ce poste d’abonnement. Pour ce faire, différentes méthodes sont possibles.

Récupérer les identifiants

Quelle que soit la méthode choisie, vous devrez fournir des identifiants pour les objets que vous mettez à jour. Utilisez la méthode de listage d’abonnements avec un filtre approprié (par exemple, l’ID client) pour trouver l’abonnement et le poste à mettre à jour.

curl -G https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}}

Cette requête renvoie l’ensemble des abonnements pour le client spécifié, à partir duquel vous pouvez récupérer l’ID de l’abonnement (id), l’ensemble des ID des postes d’abonnement (items.data.id) et l’ID du tarif des postes d’abonnement (items.data.price.id).

{
  "object": "list",
  "url": "/v1/subscriptions",
  "has_more": false,
  "data": [
    {
      "id": "su_1NXPiE2eZvKYlo2COk9fohqA",
      "object": "subscription",
      "application": null,
      "application_fee_percent": null,
      "automatic_tax": {
        "enabled": false
      },
      "items": {
        "object": "list",
        "data": [
          {
            "id": "si_OK3pbS1dvdQYJP",
            "object": "subscription_item",
            "billing_thresholds": null,
            "created": 1690208774,
            "metadata": {},
            "price": {
              "id": "price_1NOhvg2eZvKYlo2CqkpQDVRT",
              "object": "price"
            }
          }
        ]
      }
    }
  ]
}

Mettre à jour l’abonnement

Modifier un abonnement comprenant les paramètres suivants :

• item ID : vous devez spécifier l’élément d’abonnement pour remplacer le tarif actuel par le nouveau. Sinon, la mise à jour de l’abonnement avec un nouveau tarif ajoute un nouvel élément d’abonnement et les deux tarifs seront actifs pour l’abonnement.
• item price : indiquez l’identifiant du tarif de remplacement.
• item quantity : la mise à jour du tarif d’un abonnement rétablit automatiquement la quantité à la valeur par défaut de 1. Si la quantité existante de l’abonnement est différente de 1 et que vous souhaitez conserver cette valeur, vous devez l’inclure dans la mise à jour.

curl https://api.stripe.com/v1/subscriptions/sub_xxxxxxxxx \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "items[0][id]"={{SUB_ITEM_ID}} \
  -d "items[0][price]"={{NEW_PRICE_ID}}

Vous pouvez également supprimer le poste d’abonnement actuel et en créer un nouveau avec le nouveau tarif.

curl https://api.stripe.com/v1/subscriptions/sub_xxxxxxxxx \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "items[0][id]"={{SUB_ITEM_ID}} \
  -d "items[0][deleted]"=true \
  -d "items[1][price]"={{NEW_PRICE_ID}}

Mettre à jour le poste d’abonnement

Modifier un abonnement avec le paramètre suivant :

• item price : indiquez l’identifiant du tarif de remplacement.
• item quantity : la mise à jour du tarif d’un abonnement rétablit automatiquement la quantité à la valeur par défaut de 1. Si la quantité existante de l’abonnement est différente de 1 et que vous souhaitez conserver cette valeur, vous devez l’inclure dans la mise à jour.

Utilisez cette option si vous n’avez pas besoin d’apporter d’autres modifications au niveau de l’abonnement.

curl https://api.stripe.com/v1/subscription_items/si_xxxxxxxxx \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d price={{NEW_PRICE_ID}}

Périodes de facturation

Si les deux tarifs sont affectés aux mêmes périodes de facturation (interval et interval_count identiques), l’abonnement conserve les mêmes dates de facturation. Si les tarifs sont affectés à des périodes de facturation différentes, le nouveau tarif est facturé selon la nouvelle périodicité, à partir du jour du changement. Par exemple, basculer un client d’un abonnement mensuel donné vers un autre ne modifie pas les dates de facturation. À l’inverse, le faire passer d’un abonnement mensuel à un abonnement annuel modifie la date de facturation, qui est établie à la date du changement d’abonnement. Basculer un client d’un abonnement mensuel donné vers un autre tout en introduisant une période d’essai modifie également la date de facturation (qui sera définie à la fin de l’essai).

Planifications d’abonnements

Si vous modifiez un abonnement à la fin de son cycle de facturation, envisagez d’utiliser une planification d’abonnement pour gérer la transition. Lorsque vous utilisez des planifications d’abonnement, veillez à respecter les bonnes pratiques afin d’éviter les remplacements d’abonnement inattendus.

Facturation à l’usage avec les dispositifs de mesure Billing

Les informations sur les modifications en cours de cycle pour les tarifs associés à un dispositif de mesure à des fins de facturation sont décrites dans la section sur les modèles tarifaires. La transmission de clear_usage lors de la mise à jour d’un prix avec un dispositif de mesure à des fins de facturation n’a aucun effet.

Facturation à l’usage avec des enregistrements d’utilisation Ancien

Si vous disposez d’une tarification à l’usage basée sur des enregistrements d’utilisation anciens et que vous passez à une nouvelle tarification basée sur des enregistrements d’utilisation, l’utilisation est transférée au nouveau tarif.

curl https://api.stripe.com/v1/subscriptions/sub_xxxxxxxxx \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "items[0][id]"={{SUB_ITEM_ID}} \
  -d "items[0][price]"={{NEW_PRICE_ID}} \
  -d "items[0][clear_usage]"=true

Au prorata

Un changement d’abonnement entraîne souvent un calcul au prorata de façon à répercuter le nouveau tarif sur les jours restants dans la période de facturation. Vous pouvez préparer votre client à l’éventuelle dépense supplémentaire découlant d’un changement de tarif en prévisualisant un calcul au prorata. Vous pouvez également désactiver les calculs au prorata.

Paiement immédiat

Les modifications d’abonnement ci-après entraînent le lancement par Stripe d’une tentative de paiement immédiat :

• Lors du passage d’un abonnement qui ne nécessite pas de paiement (par exemple, un abonnement avec une période d’essai ou un abonnement gratuit) à un abonnement payant
• Lorsque la période de facturation est modifiée

Lorsque la facturation est effectuée immédiatement, mais que le paiement requis échoue, la demande de modification de l’abonnement aboutit et l’abonnement bascule sur past_due.

Pour facturer immédiatement un client en cas de modification d’un abonnement au cours du même cycle de facturation, définissez proration_behavior sur always_invoice. Le système calcule le prorata, puis génère immédiatement une facture une fois le changement effectué. Combinez ce paramètre avec la fonctionnalité de mise en attente des mises à jour afin que l’abonnement ne soit pas mis à jour tant que le paiement de la nouvelle facture n’a pas abouti.

Crédits pour un passage à une offre inférieure

En cas de facturation immédiate pour un passage à une offre inférieure, le client pourra bénéficier d’un crédit, qui sera ajouté à son solde créditeur pour être appliqué aux prochaines factures. Pour rembourser votre client, émettez des remboursements, puis rajustez le solde de son compte pour le ramener à zéro. Pour en savoir plus sur les remboursements des clients, veuillez consulter notre page de support dédiée.

Gérer les tarifs et les quantités nuls

Si votre client présente un abonnement dont le tarif est nul (par exemple, dans le cadre d’une période d’essai), le remplacement du tarif par un montant non nul génère une facture et réinitialise la période de facturation à la date de modification.

Si votre client présente un abonnement dont le tarif n’est pas nul, mais la quantité est nulle, le remplacement de la quantité par un nombre non nul ne génère aucune facture et ne réinitialise pas la période de facturation.