Webhook event

`checkout_session.created`

A session was created (API, payment link, invoice page, POS or subscription renewal).

Type: checkout_session.created
The object it carries: the checkout_session object
Subscribe with: checkout_session.created, checkout_session.* or *

Example payload

The body of the request your endpoint receives, shown here over several lines. On the wire it is compact JSON; check its signature over the bytes exactly as they arrive.

Example payload

{
  "id": "evt_c5wr2mdk8vtdrptvsep78cnd",
  "object": "event",
  "livemode": true,
  "created": "2026-10-11T14:03:22.418Z",
  "type": "checkout_session.created",
  "api_version": "2026-10-11",
  "data": {
    "object": {
      "id": "cs_z7ek5wj68fyz80j7bz1eq4e0",
      "object": "checkout_session",
      "livemode": true,
      "created": "2026-10-11T14:03:22.418Z",
      "status": "open",
      "mode": "payment",
      "order": "ord_0zymngngvf12b8b2cra7tb8e",
      "url": "https://pay.orrerie.com/c/cs_z7ek5wj68fyz80j7bz1eq4e0",
      "app_url": "https://pay.orrerie.com/o/cs_z7ek5wj68fyz80j7bz1eq4e0",
      "success_url": "https://acme.example/thanks?session={CHECKOUT_SESSION_ID}",
      "cancel_url": "https://acme.example/cart",
      "customer": "cus_8ea07c40qsvv19f7rgmeb8ha",
      "customer_email": "jane@example.com",
      "client_reference_id": "1042",
      "collect": {
        "email": "required",
        "name": "optional",
        "shipping_address": "hidden"
      },
      "collected": {
        "email": null,
        "name": null,
        "shipping_address": null
      },
      "locale": "auto",
      "subscription": null,
      "expires_at": "2026-10-11T15:03:22.418Z",
      "completed_at": null,
      "metadata": {
        "cart_id": "c_7781"
      }
    }
  },
  "request": {
    "id": "req_c454pdhvpfr55c7br4jvzqep",
    "idempotency_key": "a3f1c2de-7b0e-4a55-9d0c-2f6f1f0b8e11"
  },
  "pending_webhooks": 1
}

Fields of data.object

Fields of data.object in checkout_session.created
Field	In this example
`id`	`"cs_z7ek5wj68fyz80j7bz1eq4e0"`
`object`	`"checkout_session"`
`livemode`	`true`
`created`	`"2026-10-11T14:03:22.418Z"`
`status`	`"open"`
`mode`	`"payment"`
`order`	`"ord_0zymngngvf12b8b2cra7tb8e"`
`url`	`"https://pay.orrerie.com/c/cs_z7ek5wj68fyz80j7bz1eq4e0"`
`app_url`	`"https://pay.orrerie.com/o/cs_z7ek5wj68fyz80j7bz1eq4e0"`
`success_url`	`"https://acme.example/thanks?session={CHECKOUT_SESSION_ID}"`
`cancel_url`	`"https://acme.example/cart"`
`customer`	`"cus_8ea07c40qsvv19f7rgmeb8ha"`
`customer_email`	`"jane@example.com"`
`client_reference_id`	`"1042"`
`collect`	An object with `email`, `name`, `shipping_address`
`collected`	An object with `email`, `name`, `shipping_address`
`locale`	`"auto"`
`subscription`	`null`
`expires_at`	`"2026-10-11T15:03:22.418Z"`
`completed_at`	`null`
`metadata`	An object with `cart_id`

What each field means is on the page of the checkout_session object. This event carries no data.previous_attributes.

Endpoints behind it

Calls that change checkout sessions. An event is also sent when a payer, the network, a timer or a person in the dashboard causes the change; the sentence above says which.