# Mises à niveau d'abonnements

Permettre aux clients de faire évoluer leur plan d'abonnement lors du paiement à l'aide de mises à niveau.

# Page hébergée

> This is a Page hébergée for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/upsells?payment-ui=stripe-hosted.

Les mises à niveau d’abonnements offrent la possibilité aux clients d’utiliser Checkout pour souscrire un plan à plus long terme. La mise à niveau vers un abonnement de plus longue durée (par exemple, d’un abonnement mensuel à un abonnement annuel) peut contribuer à augmenter la valeur moyenne des commandes et les flux de trésorerie.

Tous les tarifs récurrents qui ne sont pas facturés à la consommation sont éligibles aux mises à niveau d’abonnement. Pour tout tarif éligible, vous pouvez configurer une mise à niveau d’abonnement vers un autre tarif répondant aux critères suivants&nbsp;:

- Les tarifs doivent faire référence au même [produit](https://docs.stripe.com/api/prices/object.md#price_object-product).
- Les tarifs doivent présenter la même [devise](https://docs.stripe.com/api/prices/object.md#price_object-currency).
- Les tarifs doivent être de [type](https://docs.stripe.com/api/prices/object.md#price_object-type) `recurring`.
- Si vos tarifs font appel au [comportement fiscal](https://docs.stripe.com/api/prices/object.md#price_object-tax_behavior), leurs valeurs doivent être identiques.
- Si votre tarif utilise des [niveaux](https://docs.stripe.com/api/prices/object.md#price_object-tiers), la valeur de `up_to` doit être identique dans chaque niveau.
- Si vous utilisez la [modification de la quantité](https://docs.stripe.com/api/prices/object.md#price_object-transform_quantity), les valeurs de `divide_by` et `round` doivent être identiques.

## Créer une mise à niveau d’abonnement

Procédez à une mise à niveau d’abonnement sur la page des informations tarifaires du Dashboard. Pour consulter les détails relatifs à un tarif, sélectionnez un produit, puis un tarif que vous avez associé au produit). Dans la section **Mises à niveau**, sélectionnez un tarif de mise à niveau dans la liste déroulante. Le tarif s’applique immédiatement aux Checkout Sessions admissibles qui utilisent ce tarif.
![Configurer une mise à niveau d'abonnement sur la page des informations tarifaires](https://b.stripecdn.com/docs-statics-srv/assets/add-upsell.08bc9bf9425295edb1ada9ff297ee257.gif)

Configurer une mise à niveau d’abonnement sur la page des informations tarifaires.

## Tunnel de paiement

Lors du paiement, les clients ont la possibilité de sélectionner le produit additionnel et de voir les économies réalisées, le cas échéant. Pour qu’une session Checkout soit éligible aux mises à niveau, elle doit&nbsp;:

- Être une session Checkout en mode abonnement
- Avoir un unique tarif `type=recurring` dans la session Checkout
- Disposer d’une configuration valide pour le tarif de mise à niveau

Stripe calcule les économies en fonction du montant que l’utilisateur pourrait économiser au cours d’un cycle de facturation s’il choisissait la mise à niveau. Par exemple, un abonnement mensuel de 100&nbsp;USD qui se transforme en un abonnement annuel de 1&nbsp;000&nbsp;USD représente une économie de 200&nbsp;USD. Checkout affiche les économies sous la forme d’un montant ou d’un pourcentage, en fonction de la longueur des caractères.

Les utilisateurs peuvent basculer entre l’option de tarif initial et l’option de tarif mis à niveau avant de passer au paiement.
![Basculer entre l'option de tarif initial et l'option de tarif mis à niveau](https://b.stripecdn.com/docs-statics-srv/assets/upsell-preview.2a43c1a8acb9f167178b7fda6a2b0796.gif)

Affichage client.

## Récupérer les postes de facture de la session Checkout

Une fois qu’un client sélectionne une mise à niveau, les `line_items` de la session Checkout sont mis à jour pour refléter le tarif mis à niveau. Lors de la [réalisation de votre commande](https://docs.stripe.com/checkout/fulfillment.md#create-payment-event-handler) à l’aide du webhook `checkout.session.completed`, veillez à [récupérer les postes de facture](https://docs.stripe.com/api/checkout/sessions/line_items.md).

## Comportement de l’essai

Si un client sélectionne une mise à niveau pour une session Checkout ayant une période d’essai disponible, la longueur de cette dernière ne sera pas modifiée.

## Comportement du bon de réduction

Si vous transmettez un bon de réduction dans la matrice des [réductions](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-discounts) de la Checkout Session, il est également appliqué au tarif de la vente additionnelle, le cas échéant. Par exemple, si un client passe d’un abonnement mensuel à un abonnement annuel et que vous transmettez un bon de réduction de 50&nbsp;% d’une durée de quatre mois, cette remise s’appliquera à toutes les factures pendant quatre mois, à compter de la date d’application initiale du bon de réduction. Si la le client sélectionne la mise à niveau, la remise de 50&nbsp;% est appliquée à l’abonnement annuel dans son intégralité, puisque la facture est créée pendant la période de quatre mois associée au bon de réduction.

## Supprimer une mise à niveau d’abonnement

Vous pouvez supprimer une mise à niveau d’abonnement sur la page des informations tarifaires. Une fois supprimée, la mise à niveau d’abonnement ne sera plus disponible pour les nouvelles sessions Checkout.
![Supprimer une mise à niveau](https://b.stripecdn.com/docs-statics-srv/assets/remove-upsell.36e5e59619f3c13f0aa94a3bd48bafdb.gif)

Supprimer une mise à niveau.


# Page intégrée

> This is a Page intégrée for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/upsells?payment-ui=embedded-form.

Les mises à niveau d’abonnements offrent la possibilité aux clients d’utiliser Checkout pour souscrire un plan à plus long terme. La mise à niveau vers un abonnement de plus longue durée (par exemple, d’un abonnement mensuel à un abonnement annuel) peut contribuer à augmenter la valeur moyenne des commandes et les flux de trésorerie.

Tous les tarifs récurrents qui ne sont pas facturés à la consommation sont éligibles aux mises à niveau d’abonnement. Pour tout tarif éligible, vous pouvez configurer une mise à niveau d’abonnement vers un autre tarif répondant aux critères suivants&nbsp;:

- Les tarifs doivent faire référence au même [produit](https://docs.stripe.com/api/prices/object.md#price_object-product).
- Les tarifs doivent présenter la même [devise](https://docs.stripe.com/api/prices/object.md#price_object-currency).
- Les tarifs doivent être de [type](https://docs.stripe.com/api/prices/object.md#price_object-type) `recurring`.
- Si vos tarifs font appel au [comportement fiscal](https://docs.stripe.com/api/prices/object.md#price_object-tax_behavior), leurs valeurs doivent être identiques.
- Si votre tarif utilise des [niveaux](https://docs.stripe.com/api/prices/object.md#price_object-tiers), la valeur de `up_to` doit être identique dans chaque niveau.
- Si vous utilisez la [modification de la quantité](https://docs.stripe.com/api/prices/object.md#price_object-transform_quantity), les valeurs de `divide_by` et `round` doivent être identiques.

## Créer une mise à niveau d’abonnement

Procédez à une mise à niveau d’abonnement sur la page des informations tarifaires du Dashboard. Pour consulter les détails relatifs à un tarif, sélectionnez un produit, puis un tarif que vous avez associé au produit). Dans la section **Mises à niveau**, sélectionnez un tarif de mise à niveau dans la liste déroulante. Le tarif s’applique immédiatement aux Checkout Sessions admissibles qui utilisent ce tarif.
![Configurer une mise à niveau d'abonnement sur la page des informations tarifaires](https://b.stripecdn.com/docs-statics-srv/assets/add-upsell.08bc9bf9425295edb1ada9ff297ee257.gif)

Configurer une mise à niveau d’abonnement sur la page des informations tarifaires.

## Tunnel de paiement

Lors du paiement, les clients ont la possibilité de sélectionner le produit additionnel et de voir les économies réalisées, le cas échéant. Pour qu’une session Checkout soit éligible aux mises à niveau, elle doit&nbsp;:

- Être une session Checkout en mode abonnement
- Avoir un unique tarif `type=recurring` dans la session Checkout
- Disposer d’une configuration valide pour le tarif de mise à niveau

Stripe calcule les économies en fonction du montant que l’utilisateur pourrait économiser au cours d’un cycle de facturation s’il choisissait la mise à niveau. Par exemple, un abonnement mensuel de 100&nbsp;USD qui se transforme en un abonnement annuel de 1&nbsp;000&nbsp;USD représente une économie de 200&nbsp;USD. Checkout affiche les économies sous la forme d’un montant ou d’un pourcentage, en fonction de la longueur des caractères.

Les utilisateurs peuvent basculer entre l’option de tarif initial et l’option de tarif mis à niveau avant de passer au paiement.
![Basculer entre l'option de tarif initial et l'option de tarif mis à niveau](https://b.stripecdn.com/docs-statics-srv/assets/upsell-preview.2a43c1a8acb9f167178b7fda6a2b0796.gif)

Affichage client.

## Récupérer les postes de facture de la session Checkout

Une fois qu’un client sélectionne une mise à niveau, les `line_items` de la session Checkout sont mis à jour pour refléter le tarif mis à niveau. Lors de la [réalisation de votre commande](https://docs.stripe.com/checkout/fulfillment.md#create-payment-event-handler) à l’aide du webhook `checkout.session.completed`, veillez à [récupérer les postes de facture](https://docs.stripe.com/api/checkout/sessions/line_items.md).

## Comportement de l’essai

Si un client sélectionne une mise à niveau pour une session Checkout ayant une période d’essai disponible, la longueur de cette dernière ne sera pas modifiée.

## Comportement du bon de réduction

Si vous transmettez un bon de réduction dans la matrice des [réductions](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-discounts) de la Checkout Session, il est également appliqué au tarif de la vente additionnelle, le cas échéant. Par exemple, si un client passe d’un abonnement mensuel à un abonnement annuel et que vous transmettez un bon de réduction de 50&nbsp;% d’une durée de quatre mois, cette remise s’appliquera à toutes les factures pendant quatre mois, à compter de la date d’application initiale du bon de réduction. Si la le client sélectionne la mise à niveau, la remise de 50&nbsp;% est appliquée à l’abonnement annuel dans son intégralité, puisque la facture est créée pendant la période de quatre mois associée au bon de réduction.

## Supprimer une mise à niveau d’abonnement

Vous pouvez supprimer une mise à niveau d’abonnement sur la page des informations tarifaires. Une fois supprimée, la mise à niveau d’abonnement ne sera plus disponible pour les nouvelles sessions Checkout.
![Supprimer une mise à niveau](https://b.stripecdn.com/docs-statics-srv/assets/remove-upsell.36e5e59619f3c13f0aa94a3bd48bafdb.gif)

Supprimer une mise à niveau.

