Skip to content
Create account
 or
Sign in
The Stripe Docs logo
/
Create account
Sign in
OverviewUpgrade your integration
Start an integration
Payment scenarios
In-person payments
Other Stripe products

Manage limited inventory with Checkout

Prevent customers from holding inventory in carts by expiring Checkout Sessions.

For some types of limited-inventory businesses, it’s necessary to prevent customers from reserving items for a long time without completing the purchase. For example, an event ticket seller wants to allow customers only a few minutes to buy their selected tickets before cancelling the sale and making those tickets available again. You can cancel a pending sale by expiring the Checkout Session.

Checkout supports both manual and timed session expiry. When a Checkout Session expires, its status property changes to expired.

Manual expiry

To immediately expire an open Checkout Session and cancel any pending purchase, use the expire endpoint.

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

Set an expiry time

When you create a Checkout Session, specify an expiration timestamp by setting the expires_at parameter. The value must be between 30 minutes and 24 hours after the current time. If you don’t specify expires_at, the default value is 24 hours after the current time.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -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}}"

Return items to your inventory

When a Checkout Session expires, Stripe sends the checkout.session.expired event. Configure your webhook endpoint to listen for this event so your webhook handler can return to inventory any items reserved in the expired session. For more information, see Expire a Session.

Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access programme.
Check out our product changelog.
Questions? Contact Sales.
Powered by Markdoc
On this page
Manual expiry
Set an expiry time
Return items to your inventory
Products Used
Checkout
Payments