# オプションアイテムを設定する 顧客が決済時にオプションアイテムを使用して補完的な商品を購入できるようにします。 # 完全ホスト型ページ > This is a 完全ホスト型ページ for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/optional-items?payment-ui=stripe-hosted. ![](https://docs.stripecdn.com/84b8dfc6dd8a1b5c8d1375a930b8c2d38f48d151fb004cbdd88f048e25a79ff5.mp4) *Checkout セッション* (A Checkout Session represents your customer's session as they pay for one-time purchases or subscriptions through Checkout. After a successful payment, the Checkout Session contains a reference to the Customer, and either the successful PaymentIntent or an active Subscription)でオプションアイテムを設定すると、顧客が決済時に複数のオプション商品を注文に追加できるようになります。そうすると、平均注文金額と売上が増加する可能性があります。たとえば、サブスクリプションサービスを販売している場合、決済時に 1 回限りの設定手数料や継続的な優先サポートプランといったオプションのアドオンを顧客に提供することもできます。 ## オプションアイテムが含まれる Checkout セッションを作成する Checkout セッションの作成時に、`line_items` を設定するのと同じ方法で `optional_items` を設定し、顧客に提供するオプションアイテムごとに `price` と `quantity` を指定します。1 回の Checkout セッションで最大 10 個のオプションアイテムを提供できます。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "optional_items[0][price]={{PRICE_ID}}" \ -d "optional_items[0][quantity]=1" \ -d "optional_items[1][price]={{PRICE_ID}}" \ -d "optional_items[1][quantity]=1" ``` ## 顧客が数量を調整できるようにする また、ラインアイテムの場合と同じ方法で `adjustable_quantity` を指定することによって、顧客がオプションアイテムを注文に追加した後で数量を調整できるようにすることもできます。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "optional_items[0][price]={{PRICE_ID}}" \ -d "optional_items[0][quantity]=1" \ -d "optional_items[0][adjustable_quantity][enabled]=true" \ -d "optional_items[0][adjustable_quantity][minimum]=0" \ -d "optional_items[0][adjustable_quantity][maximum]=10" ``` 貴社が `quantity` または `adjustable_quantity.minimum` に 0 より大きい値を指定した場合でも、顧客はいつでも注文からオプションアイテムを削除できます。 ## 制限事項 - 最大 10 個のオプションアイテムに対応しています。 - ラインアイテムにサブスクリプションのアップセルが設定されている場合、継続的なオプションアイテムはサポートされません。 - カスタム金額を使用するオプションアイテムや、カスタム金額を使用しているラインアイテムがある場合にオプションアイテムを使用することはサポートされていません。 - `setup` モードではサポートされていません。 - `payment` モードでは継続的なオプションアイテムには対応していません。 - 継続的なオプションアイテム (月次、年次など) の請求間隔は、継続的なラインアイテムの間隔と一致している必要があります。 - 商品カタログで設定された[クロスセル](https://docs.stripe.com/payments/checkout/cross-sells.md)は、オプションアイテムを使用して作成された Checkout セッションには表示されません。 ### 商品関連のオプションアイテムを追加する [クロスセル](https://docs.stripe.com/payments/checkout/cross-sells.md)を使用して、決済フロー中にオプションアイテムとして薦める補完的な定番商品を指定します。商品に関連付けられたクロスセルを設定すると、その商品のすべての適格な Checkout Sessions にオプション項目が表示されます。クロスセルは、決済用リンクに追加のオプションアイテムを指定した場合は表示されません。 クロスセルを設定するには: 1. [商品カタログ](https://dashboard.stripe.com/test/products)ページで、商品を選択します。 1. 商品の詳細ページの **クロスセル** で、クロスセルする商品を見つけます。 クロスセルを設定すると、指定した商品を含む Checkout Sessions によって、クロスセルがオプションアイテムとして自動的に追加されます。 ![](https://docs.stripecdn.com/73a4baa89ea5ac0e30a39cd03f33b21e35979759cdc9293b680695226a5b7dbe.mp4) # 完全埋め込みページ > This is a 完全埋め込みページ for when payment-ui is embedded-page. View the full page at https://docs.stripe.com/payments/checkout/optional-items?payment-ui=embedded-page. ![](https://docs.stripecdn.com/84b8dfc6dd8a1b5c8d1375a930b8c2d38f48d151fb004cbdd88f048e25a79ff5.mp4) *Checkout セッション* (A Checkout Session represents your customer's session as they pay for one-time purchases or subscriptions through Checkout. After a successful payment, the Checkout Session contains a reference to the Customer, and either the successful PaymentIntent or an active Subscription)でオプションアイテムを設定すると、顧客が決済時に複数のオプション商品を注文に追加できるようになります。そうすると、平均注文金額と売上が増加する可能性があります。たとえば、サブスクリプションサービスを販売している場合、決済時に 1 回限りの設定手数料や継続的な優先サポートプランといったオプションのアドオンを顧客に提供することもできます。 ## オプションアイテムが含まれる Checkout セッションを作成する Checkout セッションの作成時に、`line_items` を設定するのと同じ方法で `optional_items` を設定し、顧客に提供するオプションアイテムごとに `price` と `quantity` を指定します。1 回の Checkout セッションで最大 10 個のオプションアイテムを提供できます。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "optional_items[0][price]={{PRICE_ID}}" \ -d "optional_items[0][quantity]=1" \ -d "optional_items[1][price]={{PRICE_ID}}" \ -d "optional_items[1][quantity]=1" ``` ## 顧客が数量を調整できるようにする また、ラインアイテムの場合と同じ方法で `adjustable_quantity` を指定することによって、顧客がオプションアイテムを注文に追加した後で数量を調整できるようにすることもできます。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "optional_items[0][price]={{PRICE_ID}}" \ -d "optional_items[0][quantity]=1" \ -d "optional_items[0][adjustable_quantity][enabled]=true" \ -d "optional_items[0][adjustable_quantity][minimum]=0" \ -d "optional_items[0][adjustable_quantity][maximum]=10" ``` 貴社が `quantity` または `adjustable_quantity.minimum` に 0 より大きい値を指定した場合でも、顧客はいつでも注文からオプションアイテムを削除できます。 ## 制限事項 - 最大 10 個のオプションアイテムに対応しています。 - ラインアイテムにサブスクリプションのアップセルが設定されている場合、継続的なオプションアイテムはサポートされません。 - カスタム金額を使用するオプションアイテムや、カスタム金額を使用しているラインアイテムがある場合にオプションアイテムを使用することはサポートされていません。 - `setup` モードではサポートされていません。 - `payment` モードでは継続的なオプションアイテムには対応していません。 - 継続的なオプションアイテム (月次、年次など) の請求間隔は、継続的なラインアイテムの間隔と一致している必要があります。 - 商品カタログで設定された[クロスセル](https://docs.stripe.com/payments/checkout/cross-sells.md)は、オプションアイテムを使用して作成された Checkout セッションには表示されません。 ### 商品関連のオプションアイテムを追加する [クロスセル](https://docs.stripe.com/payments/checkout/cross-sells.md)を使用して、決済フロー中にオプションアイテムとして薦める補完的な定番商品を指定します。商品に関連付けられたクロスセルを設定すると、その商品のすべての適格な Checkout Sessions にオプション項目が表示されます。クロスセルは、決済用リンクに追加のオプションアイテムを指定した場合は表示されません。 クロスセルを設定するには: 1. [商品カタログ](https://dashboard.stripe.com/test/products)ページで、商品を選択します。 1. 商品の詳細ページの **クロスセル** で、クロスセルする商品を見つけます。 クロスセルを設定すると、指定した商品を含む Checkout Sessions によって、クロスセルがオプションアイテムとして自動的に追加されます。 ![](https://docs.stripecdn.com/73a4baa89ea5ac0e30a39cd03f33b21e35979759cdc9293b680695226a5b7dbe.mp4)