API Reference · Checkout Sessions

Expire a checkout session

Transitions an OPEN session to EXPIRED immediately.

POST/v1/checkout/sessions/:id/expire

Useful for invalidating a session after your customer abandons the flow in your own UI, before the 24-hour auto-expire fires. Returns 409 if the session is already COMPLETE or EXPIRED.

Returnscheckout_session object

Path parameters

idstringRequired

Session id (`cs_…`).

Errors

404

resource_missing

No session exists with that id.

409

session_not_open

Session is already COMPLETE or EXPIRED.

Request

curl -X POST https://lunipay.io/api/v1/checkout/sessions/cs_01JRZK8WV3FYMPEQRXJ9HA5NTB/expire \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

Response

{
  "id": "cs_01JRZK8WV3FYMPEQRXJ9HA5NTB",
  "object": "checkout_session",
  "livemode": false,
  "status": "EXPIRED",
  "payment_status": "unpaid",
  "amount_cents": 5000,
  "currency": "usd",
  "success_url": "https://example.com/thanks?session_id={CHECKOUT_SESSION_ID}",
  "cancel_url": "https://example.com/cart",
  "customer_id": null,
  "customer_email": null,
  "line_items": null,
  "payment_intent_id": null,
  "payment_id": null,
  "metadata": {
    "order_id": "ORD-9821"
  },
  "expires_at": 1713187200,
  "completed_at": null,
  "url": "https://lunipay.io/checkout/cs_01JRZK8WV3FYMPEQRXJ9HA5NTB",
  "created": 1713100800,
  "updated": 1713100800
}