オプションアイテムを設定する

Checkout セッションでオプションアイテムを設定すると、顧客が決済時に複数のオプション商品を注文に追加できるようになります。そうすると、平均注文金額と売上が増加する可能性があります。たとえば、サブスクリプションサービスを販売している場合、決済時に 1 回限りの設定手数料や継続的な優先サポートプランといったオプションのアドオンを顧客に提供することもできます。

オプションアイテムが含まれる Checkout セッションを作成する

Checkout セッションの作成時に、line_items を設定するのと同じ方法で optional_items を設定し、顧客に提供するオプションアイテムごとに price と quantity を指定します。1 回の Checkout セッションで最大 10 個のオプションアイテムを提供できます。

await stripe.checkout.sessions.create({
  // ...
  line_items: [
    {
      price: '{{PRICE_ID}}',
      quantity: 1,
    },
  ],
  optional_items: [
    {
      price: '{{OTHER_PRICE_ID}}',
      quantity: 1,
    },
    {
      price: '{{ANOTHER_PRICE_ID}}',
      quantity: 1,
    },
  ],
});

顧客が数量を調整できるようにする

また、ラインアイテムの場合と同じ方法で adjustable_quantity を指定することによって、顧客がオプションアイテムを注文に追加した後で数量を調整できるようにすることもできます。

await stripe.checkout.sessions.create({
  // ...
  optional_items: [
    {
      price: '{{PRICE_ID}}',
      quantity: 1,
      adjustable_quantity: {
        enabled: true,
        minimum: 0,
        maximum: 10,
      },
    },
  ],
});

貴社が quantity または adjustable_quantity.minimum に 0 より大きい値を指定した場合でも、顧客はいつでも注文からオプションアイテムを削除できます。

制限事項

• 最大 10 個のオプションアイテムに対応しています。
• ラインアイテムにサブスクリプションのアップセルが設定されている場合、継続的なオプションアイテムはサポートされません。
• カスタム金額を使用するオプションアイテムや、カスタム金額を使用しているラインアイテムがある場合にオプションアイテムを使用することはサポートされていません。
• setup モードではサポートされていません。
• payment モードでは継続的なオプションアイテムには対応していません。
• 継続的なオプションアイテム (月次、年次など) の請求間隔は、継続的なラインアイテムの間隔と一致している必要があります。
• 商品カタログで設定されたクロスセルは、オプションアイテムを使用して作成された Checkout セッションには表示されません。

Add a product-associated optional item

Use cross-sells to specify complementary products that you always want recommended as optional items at checkout. When you configure a cross-sell associated with a product, the optional item appears across all eligible Checkout Sessions with that product. Cross-sells won’t appear if you specify additional optional items on a payment link.

To configure a cross-sell:

1. On the Product catalog page, select your product.
2. On the product details page, under Cross-sells, find the product you want to cross-sell.

After you configure a cross-sell, the Checkout Sessions that contain your designated product automatically add the cross-sell as an optional item.