限られた在庫の管理

在庫に限りのある一部のビジネスでは、顧客が購入を完了せずに長時間アイテムを確保したままになるのを防ぐ必要があります。たとえば、イベントのチケット販売者は、顧客が選択したチケットを購入できる有効期限を数分間のみに制限して、期限後は購入をキャンセルしてチケットをまた販売できるようにしたいと考えます。Checkout セッションを期限切れにすることで、保留中の販売をキャンセルすることができます。

Checkout は、手動と時間指定のどちらのセッション期限切れにも対応しています。Checkout セッションを期限切れにすると、そのステータスプロパティは expired に変わります。

手動の有効期限

未処理の Checkout セッションをただちに期限切れにし、保留中の購入をキャンセルするには、expire エンドポイントを使用します。

curl -X POST https://api.stripe.com/v1/checkout/sessions/
{{SESSION_ID}}
/expire \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

有効期限を設定する

Checkout セッションの作成時に、有効期限のタイムスタンプを expires_at パラメーターで指定します。この値は、現在時刻から 30 分後以降、24 時間以内で指定する必要があります。expires_at を指定しなかった場合、デフォルト値は 24 時間後になります。

curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer=
{{CUSTOMER_ID}} \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d success_url="https://example.com/success" \
  -d expires_at="{{NOW_PLUS_TWO_HOURS}}"

アイテムを在庫に戻す

Checkout セッションの期限が切れると、Stripe は checkout.session.expired イベントを送信します。このイベントをリッスンするように Webhook エンドポイントを設定して、Webhook ハンドラが期限切れのセッションで予約されていたアイテムを在庫に戻せるようにします。詳細については、セッションを期限切れにするのページをご覧ください。