Stripe checkout webhook events

Stripe sends 4 checkout events, all for Checkout Sessions. checkout.session.completed is the one most integrations fulfil on.

Every event here can also reach agents as an MCP event through Hookdeck: MCP events →

checkout.session.completed

verified from a captured delivery

Checkout Session completes

Identified by type field in the body Resource checkout

stripe-checkout-session-completed.json
{
  "id": "evt_1MhUT6E0b6fckueSlc4GyvIi",
  "object": "event",
  "api_version": "2022-11-15",
  "created": 1677834000,
  "data": {
    "object": {
      "id": "cs_test_a1CagZ1XmCLIZb3ME6r06G1h8ygwbbbMw8Nqk0R86MWMT4dmCjDiUYfQDr",
      "object": "checkout.session",
      "after_expiration": null,
      "allow_promotion_codes": false,
      "amount_subtotal": 0,
      "amount_total": 0,
      "automatic_tax": { … },
      "billing_address_collection": "auto",
      "cancel_url": "https://stripe.com",
      "client_reference_id": null,
      "created": 1677833849,
      "customer": "cus_NSPHp4fOlXGw8P",
      "status": "complete"
    }
  },
  "livemode": false,
  "pending_webhooks": 3,
  "request": { … },
  "type": "checkout.session.completed"
}

Key fields

Field Type Example
data.object.id string cs_test_a1CagZ1XmCLIZb3ME6r06G1h8ygwbbbMw8Nqk0R86MWMT4dmCjDiUYfQDr
data.object.status string complete
data.object.amount_subtotal integer 0
data.object.customer string cus_NSPHp4fOlXGw8P
data.object.created integer 1677833849

Full schema: 81 fields.

Seen in a captured delivery

  • Content type application/json; charset=utf-8
  • API version 2022-11-15
  • Headers user-agent , content-type

Send example to Inspect → View as JSON

checkout.session.async_payment_failed

documented official schema

Delayed payment on a Checkout Session fails

Identified by type field in the body Resource checkout

stripe-checkout-session-async-payment-failed.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "after_expiration": { … },
      "allow_promotion_codes": null,
      "amount_subtotal": null,
      "amount_total": null,
      "automatic_tax": { … },
      "billing_address_collection": null,
      "cancel_url": "https://example.com/cancel",
      "client_reference_id": null,
      "created": 1234567890,
      "id": "cs_test_a1YS1URlnyQCN5fUUduORoQ7Pw41PJqDWkIVQCpJPqkfIhd6tVY8XB1OLY",
      "status": "open"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "checkout.session.async_payment_failed"
}

Key fields

Field Type Example
data.object.id string cs_test_a1YS1URlnyQCN5fUUduORoQ7Pw41PJqDWkIVQCpJPqkfIhd6tVY8XB1OLY
data.object.status string open
data.object.created integer 1234567890

Full schema: 156 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

checkout.session.async_payment_succeeded

documented official schema

Delayed payment on a Checkout Session succeeds

Identified by type field in the body Resource checkout

stripe-checkout-session-async-payment-succeeded.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "after_expiration": { … },
      "allow_promotion_codes": null,
      "amount_subtotal": null,
      "amount_total": null,
      "automatic_tax": { … },
      "billing_address_collection": null,
      "cancel_url": "https://example.com/cancel",
      "client_reference_id": null,
      "created": 1234567890,
      "id": "cs_test_a1YS1URlnyQCN5fUUduORoQ7Pw41PJqDWkIVQCpJPqkfIhd6tVY8XB1OLY",
      "status": "open"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "checkout.session.async_payment_succeeded"
}

Key fields

Field Type Example
data.object.id string cs_test_a1YS1URlnyQCN5fUUduORoQ7Pw41PJqDWkIVQCpJPqkfIhd6tVY8XB1OLY
data.object.status string open
data.object.created integer 1234567890

Full schema: 156 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

checkout.session.expired

documented official schema

Checkout Session expires

Identified by type field in the body Resource checkout

stripe-checkout-session-expired.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "after_expiration": { … },
      "allow_promotion_codes": null,
      "amount_subtotal": null,
      "amount_total": null,
      "automatic_tax": { … },
      "billing_address_collection": null,
      "cancel_url": "https://example.com/cancel",
      "client_reference_id": null,
      "created": 1234567890,
      "id": "cs_test_a1YS1URlnyQCN5fUUduORoQ7Pw41PJqDWkIVQCpJPqkfIhd6tVY8XB1OLY",
      "status": "open"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "checkout.session.expired"
}

Key fields

Field Type Example
data.object.id string cs_test_a1YS1URlnyQCN5fUUduORoQ7Pw41PJqDWkIVQCpJPqkfIhd6tVY8XB1OLY
data.object.status string open
data.object.created integer 1234567890

Full schema: 156 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

Route Stripe events by type.

Event Gateway receives every Stripe delivery and filters and routes it by event type, so each service gets only the events it handles.

Not affiliated with Stripe. Facts are compiled from public sources and linked inline.