サブスクリプションのアップセル

アップセルを使用し、顧客が決済フローでサブスクリプションプランをアップグレードできるようにします。

サブスクリプションのアップセルは、Checkout を使用して顧客に長期プランにアップグレードするオプションを提示します。顧客に対して、より長期のサブスクリプション期間 (月次から年次など) へのアップセルを行うことで、平均注文額とキャッシュフローを増加させることができます。

従量課金以外の継続価格はすべて、サブスクリプションのアップセルを使用する対象になります。対象の価格に対して、次の条件を満たす別の価格へのサブスクリプションのアップセルを設定できます。

価格は同じ Product (商品) を参照する必要があります。
価格は同じ通貨である必要があります。
価格は recurring タイプである必要があります。
価格で、税金処理を使用する場合は、値が同じである必要があります。
価格で段階を使用する場合には、各段階の up_to の値が同じである必要があります。
数量の変換を使用する場合、divide_by と round の値は同じである必要があります。

Create a subscription upsell

Configure a subscription upsell in the Dashboard on the Price details page. To view the details for a Price, select a Product and select a price associated with the Product. In the Upsells section, select an upsell price from the dropdown menu. Upsells immediately apply to eligible Checkout Sessions that use that price.

Configure a subscription upsell on the Price details page.

Checkout flow

During checkout, customers see an option to select the upsell with savings displayed, if applicable. For a Checkout Session to be eligible for upsells, it must:

Be a subscription mode Checkout Session
Have only one type=recurring price in the Checkout Session
Have a valid configuration for the upsell price

Stripe calculates savings based on the amount the user saves in one billing cycle if they chose upsell pricing. For example, a monthly subscription of 100 USD that upsells to an annual subscription of 1000 USD shows savings of 200 USD. Checkout displays the savings as an amount or a percentage, depending on the character length of the savings.

Users can toggle between the initial price option and the upsell price option and then checkout.

Customer preview.

Retrieve Checkout Session line items

After a customer selects an upsell, the line_items for the Checkout Session update to reflect the upsell price. When fulfilling your order using the checkout.session.completed webhook, make sure to retrieve the line items.

Trial behavior

If a customer selects an upsell for a Checkout Session with a trial available, the trial length won’t change.

Coupon behavior

If you pass a coupon to the discounts array of the Checkout Session, that coupon is also applied to the upsell price if a customer selects the upsell. For example, if a monthly subscription upsells to a yearly subscription, and you pass in a 50% off coupon with a duration of four months, the discount applies to all invoices in the four month period starting when the coupon is first applied. If the customer selects the upsell, the 50% discount applies to the entire yearly subscription because the yearly invoice is created during the coupon’s four month period.

Remove a subscription upsell

You can remove a subscription upsell on the Price details page. After you remove a subscription upsell, that upsell won’t be available to any new Checkout Sessions.

Remove an upsell.