Evento checkout.session.expired

Evento `checkout.session.expired`

Disparado quando uma checkout session deixa de estar em status: "open" por expiração — ao chegar no prazo, ou quando você chama POST /v1/checkout-sessions/:id/expire. A sessão expirada não pode mais ser confirmada pelo comprador; crie uma nova session quando quiser oferecer outra tentativa de checkout. O prazo é definido por data.object.expires_at, sempre 24h depois de created_at. Sessões que já estão complete ou expired não disparam este evento novamente.

A sessão é dona do ciclo de vida do payment_intent dela. Se ainda havia uma tentativa de pagamento em andamento, ela é encerrada junto e você recebe também payment.intent.canceled com cancellation_reason: "expired". Os dois eventos descrevem a mesma decisão — trate-os de forma idempotente para não encerrar o pedido duas vezes.

Este evento representa abandono da sessão antes do confirm. Ele é diferente de uma falha de pagamento assíncrono: PIX ou boleto já confirmados pelo comprador usam checkout.session.async.payment.failed quando não forem pagos.

Quando acontece

Situação	Como aparece no payload
Comprador não abriu ou não concluiu o formulário	`status: "expired"` e `payment_status: "unpaid"`.
Sessão ficou `open` até `expires_at`	`created_at` e `expires_at` mostram a janela de 24h.
Sessão veio de um payment link	A sessão expira, mas o payment link continua reutilizável para gerar outra sessão.

Como processar

Registre o id do evento (evt_*) para processar o webhook de forma idempotente.
Marque o pedido ou carrinho como abandonado, não como pagamento recusado.
Libere reserva de estoque, bloqueio de agenda ou qualquer hold temporário associado à sessão.
Ofereça uma nova tentativa com uma nova checkout session ou por um payment link existente.
Não tente reutilizar o client_secret ou a url da sessão expirada.

Campos importantes

Campo	O que observar
`data.object.status`	Sempre `expired` neste evento.
`payment_status`	Normalmente permanece `unpaid`; não houve confirmação financeira.
`expires_at`	Momento em que a sessão deixou de aceitar confirmação.
`payment_data`	Vem `null` quando o comprador nunca confirmou a sessão.
`line_items`	Snapshot do carrinho que expirou.
`marketing_attribution`	Primeiro contexto de aquisição capturado antes da expiração, ou `null`.
`metadata`	Ecoa os metadados enviados na criação para correlacionar com seu pedido.

Status da sessão

Valor	Descrição
`open`	Aguardando o comprador antes da expiração.
`complete`	O comprador confirmou a sessão; este evento não será emitido.
`expired`	Estado terminal para sessões abertas que passaram de `expires_at`.

Exemplo de payload

{
  "id": "evt_8h3K2pQ9mN4tR7vL",
  "object": "event",
  "created_at": "2026-05-04T18:31:00Z",
  "data": {
    "object": {
      "id": "cs_kkLqvun5Y9kZZ8WZ",
      "object": "checkout.session",
      "allow_discount_codes": false,
      "amount_discount": 2000,
      "amount_subtotal": 19990,
      "amount_tax": 0,
      "amount_total": 17990,
      "cancel_url": "https://meusite.com/cancelado",
      "client_reference_id": null,
      "client_secret": "669f230c3228c975452e5866a89cc1ed4c79f1b5dd529cd123b64c30d6f7dc56",
      "created_at": "2026-05-03T18:31:00Z",
      "currency": "brl",
      "customer": "cus_9qFBhjHBT7dpJDHA",
      "customer_document": "12345678901",
      "customer_document_type": "cpf",
      "customer_email": "nome@email.com",
      "customer_name": "Cliente Exemplo",
      "discount": "disc_mturk415RbyaG8cB",
      "expires_at": "2026-05-04T18:31:00Z",
      "has_surcharge": false,
      "invoice_creation": false,
      "line_items": [
        {
          "id": "li_NtdVJKFARnr6rqwX",
          "adjustable_quantity": {
            "enabled": false,
            "maximum": null,
            "minimum": null
          },
          "amount_discount": 2000,
          "amount_subtotal": 19990,
          "amount_tax": 0,
          "amount_total": 17990,
          "currency": "brl",
          "description": "Plano Pro mensal",
          "metadata": {},
          "position": 0,
          "price": "price_pGKyGZbAvziehG66",
          "price_data": null,
          "product": "prod_V5LNQfrahoRpgHQk",
          "quantity": 1,
          "recurring_interval": "month",
          "recurring_interval_count": 1,
          "unit_amount": 19990
        }
      ],
      "livemode": true,
      "marketing_attribution": null,
      "metadata": {},
      "mode": "payment",
      "payment_data": null,
      "payment_method_collection": "always",
      "payment_status": "unpaid",
      "status": "expired",
      "submit_type": "auto",
      "subscription": null,
      "success_url": "https://meusite.com/sucesso",
      "url": "https://pay.chargefy.io/session/..."
    }
  },
  "livemode": true,
  "organization": "org_UdP44F5Hth2ctv2V",
  "request": {
    "id": "req_f4Np6RjrTTRKcQ7a"
  },
  "type": "checkout.session.expired"
}

data.object é o DTO completo de PublicCheckoutSession.

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Evento checkout.session.expired