# サブスクリプションのアップセル アップセルを使用し、顧客が決済フローでサブスクリプションプランをアップグレードできるようにします。 # ホスト型ページ > This is a ホスト型ページ for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/upsells?payment-ui=stripe-hosted. サブスクリプションのアップセルでは、Checkout で長期プランにアップグレードするオプションを顧客に提示します。より長期間のサブスクリプション (月次から年次など) にアップセルすることで、平均注文金額とキャッシュフローを増やすことができます。 従量課金ではない継続価格はすべて、サブスクリプションのアップセルを利用できる対象となります。どの対象価格でも、次の条件を満たす別の価格にサブスクリプションをアップセルするように設定できます。 - 価格は同じ[商品](https://docs.stripe.com/api/prices/object.md#price_object-product)を参照する必要があります。 - 価格は同じ[通貨](https://docs.stripe.com/api/prices/object.md#price_object-currency)である必要があります。 - 価格は `recurring` [タイプ](https://docs.stripe.com/api/prices/object.md#price_object-type)である必要があります。 - 価格で[税金処理](https://docs.stripe.com/api/prices/object.md#price_object-tax_behavior)を使用する場合、それらの値は同じである必要があります。 - 価格で[段階](https://docs.stripe.com/api/prices/object.md#price_object-tiers)を使用する場合、各段階の `up_to` の値は同じである必要があります。 - [数量の変換](https://docs.stripe.com/api/prices/object.md#price_object-transform_quantity)を使用している場合、`divide_by` と `round` の値は同じである必要があります。 ## サブスクリプションのアップセルを作成する ダッシュボードの価格の詳細ページでサブスクリプションのアップセルを設定します。価格の詳細を表示するには、商品を選択し、商品に関連付けられた価格を選択します。**アップセル**セクションで、ドロップダウンメニューからアップセル価格を選択します。アップセルは、その価格を使用する対象の Checkout Sessions に直ちに適用されます。 ![「料金詳細」ページでサブスクリプションのアップセルを設定する](https://b.stripecdn.com/docs-statics-srv/assets/add-upsell.08bc9bf9425295edb1ada9ff297ee257.gif) 「料金詳細」ページでサブスクリプションのアップセルを設定します。 ## 決済フロー 該当する場合、決済フロー中にアップセルを選択するオプションが割引額とともに顧客に表示されます。Checkout セッションでアップセルを適用するには、以下の要件を満たしている必要があります。 - サブスクリプションモードの Checkout セッションである - Checkout セッションに設定されている `type=recurring` 料金が 1 つのみである - アップセル価格が有効に設定されている ユーザーがアップセル価格を選択した場合、Stripe は 1 回の請求サイクルで節約される金額を基に割引額を計算します。たとえば、100 USD の月額サブスクリプションから 1,000 USD の年額サブスクリプションへのアップセルの場合、割引額は 200 USD で表示されます。Checkout では、文字数の長さに応じて、金額またはパーセントで割引額 (率) が表示されます。 ユーザーは、初期価格オプションとアップセル価格オプションを切り替えてから購入を行えます。 ![初期価格オプションとアップセル価格オプションを切り替える](https://b.stripecdn.com/docs-statics-srv/assets/upsell-preview.2a43c1a8acb9f167178b7fda6a2b0796.gif) 顧客向けのプレビュー。 ## Checkout セッションの項目を取得する 顧客がアップセルを選択すると、そのアップセル価格を反映して Checkout セッションの `line_items` が更新されます。`checkout.session.completed` Webhook を使用して[注文のフルフィルメントを履行](https://docs.stripe.com/checkout/fulfillment.md#create-payment-event-handler)する場合は、必ず[項目を取得](https://docs.stripe.com/api/checkout/sessions/line_items.md)してください。 ## トライアルでの動作 トライアル期間が設定された Checkout セッションに対して顧客がアップセルを選択した場合、トライアル期間の変更は生じません。 ## クーポンの動作 Checkout Session の [discounts](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-discounts) 配列にクーポンを渡すと、顧客がアップセルを選択した場合、そのクーポンがアップセル価格にも適用されます。たとえば、月次サブスクリプションが年次サブスクリプションにアップセルし、期間が 4 カ月の 50% オフクーポンを渡した場合、クーポンが最初に適用されてから 4 カ月の期間のすべての請求書に割引が適用されます。顧客がアップセルを選択すると、年次請求書はクーポンの 4 カ月の期間中に作成されるため、50% 割引が年次サブスクリプション全体に適用されます。 ## サブスクリプションのアップセルを削除する サブスクリプションのアップセルは、「料金詳細」ページで削除できます。サブスクリプションのアップセルを削除すると、そのアップセルを新しい Checkout セッションで利用することはできなくなります。 ![アップセルを削除](https://b.stripecdn.com/docs-statics-srv/assets/remove-upsell.36e5e59619f3c13f0aa94a3bd48bafdb.gif) アップセルを削除。 # 埋め込み型ページ > This is a 埋め込み型ページ for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/upsells?payment-ui=embedded-form. サブスクリプションのアップセルでは、Checkout で長期プランにアップグレードするオプションを顧客に提示します。より長期間のサブスクリプション (月次から年次など) にアップセルすることで、平均注文金額とキャッシュフローを増やすことができます。 従量課金ではない継続価格はすべて、サブスクリプションのアップセルを利用できる対象となります。どの対象価格でも、次の条件を満たす別の価格にサブスクリプションをアップセルするように設定できます。 - 価格は同じ[商品](https://docs.stripe.com/api/prices/object.md#price_object-product)を参照する必要があります。 - 価格は同じ[通貨](https://docs.stripe.com/api/prices/object.md#price_object-currency)である必要があります。 - 価格は `recurring` [タイプ](https://docs.stripe.com/api/prices/object.md#price_object-type)である必要があります。 - 価格で[税金処理](https://docs.stripe.com/api/prices/object.md#price_object-tax_behavior)を使用する場合、それらの値は同じである必要があります。 - 価格で[段階](https://docs.stripe.com/api/prices/object.md#price_object-tiers)を使用する場合、各段階の `up_to` の値は同じである必要があります。 - [数量の変換](https://docs.stripe.com/api/prices/object.md#price_object-transform_quantity)を使用している場合、`divide_by` と `round` の値は同じである必要があります。 ## サブスクリプションのアップセルを作成する ダッシュボードの価格の詳細ページでサブスクリプションのアップセルを設定します。価格の詳細を表示するには、商品を選択し、商品に関連付けられた価格を選択します。**アップセル**セクションで、ドロップダウンメニューからアップセル価格を選択します。アップセルは、その価格を使用する対象の Checkout Sessions に直ちに適用されます。 ![「料金詳細」ページでサブスクリプションのアップセルを設定する](https://b.stripecdn.com/docs-statics-srv/assets/add-upsell.08bc9bf9425295edb1ada9ff297ee257.gif) 「料金詳細」ページでサブスクリプションのアップセルを設定します。 ## 決済フロー 該当する場合、決済フロー中にアップセルを選択するオプションが割引額とともに顧客に表示されます。Checkout セッションでアップセルを適用するには、以下の要件を満たしている必要があります。 - サブスクリプションモードの Checkout セッションである - Checkout セッションに設定されている `type=recurring` 料金が 1 つのみである - アップセル価格が有効に設定されている ユーザーがアップセル価格を選択した場合、Stripe は 1 回の請求サイクルで節約される金額を基に割引額を計算します。たとえば、100 USD の月額サブスクリプションから 1,000 USD の年額サブスクリプションへのアップセルの場合、割引額は 200 USD で表示されます。Checkout では、文字数の長さに応じて、金額またはパーセントで割引額 (率) が表示されます。 ユーザーは、初期価格オプションとアップセル価格オプションを切り替えてから購入を行えます。 ![初期価格オプションとアップセル価格オプションを切り替える](https://b.stripecdn.com/docs-statics-srv/assets/upsell-preview.2a43c1a8acb9f167178b7fda6a2b0796.gif) 顧客向けのプレビュー。 ## Checkout セッションの項目を取得する 顧客がアップセルを選択すると、そのアップセル価格を反映して Checkout セッションの `line_items` が更新されます。`checkout.session.completed` Webhook を使用して[注文のフルフィルメントを履行](https://docs.stripe.com/checkout/fulfillment.md#create-payment-event-handler)する場合は、必ず[項目を取得](https://docs.stripe.com/api/checkout/sessions/line_items.md)してください。 ## トライアルでの動作 トライアル期間が設定された Checkout セッションに対して顧客がアップセルを選択した場合、トライアル期間の変更は生じません。 ## クーポンの動作 Checkout Session の [discounts](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-discounts) 配列にクーポンを渡すと、顧客がアップセルを選択した場合、そのクーポンがアップセル価格にも適用されます。たとえば、月次サブスクリプションが年次サブスクリプションにアップセルし、期間が 4 カ月の 50% オフクーポンを渡した場合、クーポンが最初に適用されてから 4 カ月の期間のすべての請求書に割引が適用されます。顧客がアップセルを選択すると、年次請求書はクーポンの 4 カ月の期間中に作成されるため、50% 割引が年次サブスクリプション全体に適用されます。 ## サブスクリプションのアップセルを削除する サブスクリプションのアップセルは、「料金詳細」ページで削除できます。サブスクリプションのアップセルを削除すると、そのアップセルを新しい Checkout セッションで利用することはできなくなります。 ![アップセルを削除](https://b.stripecdn.com/docs-statics-srv/assets/remove-upsell.36e5e59619f3c13f0aa94a3bd48bafdb.gif) アップセルを削除。