Evento checkout.session.created

Evento `checkout.session.created`

Disparado quando uma checkout.session é criada e fica disponível para o comprador iniciar o checkout. Use este evento para registrar a tentativa de compra e armazenar os dados de correlação antes de redirecionar ou acompanhar o comprador. data.object usa o mesmo shape de PublicCheckoutSession em todos os eventos checkout.session.*. Neste ponto a sessão normalmente ainda está open, com payment_status: "unpaid" e payment_data: null.

Este evento não significa pagamento confirmado. A sessão acabou de nascer; o comprador ainda precisa abrir a página hospedada, preencher o formulário e confirmar a escolha do método de pagamento.

Quando acontece

Situação	Como aparece no payload
Criação direta pela API	`request.id` identifica a chamada que criou a sessão.
Clique em um payment link	A Chargefy materializa uma sessão nova a partir da oferta do link.
Criação pelo dashboard	O payload tem o mesmo `data.object`; use `metadata` e `line_items` para conciliar.

Como processar

Registre o id do evento (evt_*) para processar o webhook de forma idempotente.
Salve data.object.id como a chave da checkout session no seu sistema.
Salve metadata e line_items para correlacionar com o pedido ou carrinho.
Redirecione ou acompanhe o comprador pela url da sessão quando o fluxo exigir.
Não marque o pedido como pago; aguarde checkout.session.completed e, para PIX ou boleto, o evento assíncrono de sucesso.

Campos importantes

Campo	O que observar
`data.object.status`	Normalmente `open`: a sessão está aguardando o comprador.
`payment_status`	Nasce `unpaid`, exceto quando não há valor devido.
`payment_data`	Vem `null` antes do `confirm`; dados de PIX, boleto ou cartão aparecem depois.
`expires_at`	Prazo de 24h da sessão; se continuar `open`, pode gerar `checkout.session.expired`.
`line_items`	Retrato dos itens, preços, descontos e recorrência resolvidos na criação.
`marketing_attribution`	Primeiro contexto de aquisição da sessão. Pode ser `null` até a entrada do comprador.
`metadata`	Ecoa os metadados enviados na criação para correlacionar com seu pedido.
`client_secret` / `url`	Credenciais de uso da página hospedada; não substituem confirmação financeira.

Exemplo de payload

{
  "id": "evt_8h3K2pQ9mN4tR7vL",
  "object": "event",
  "created_at": "2026-05-03T18:31:00Z",
  "data": {
    "object": {
      "id": "cs_ut4owPgCbhvBqamZ",
      "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": "f0b13260778342deb182f9aeaad46a5652171cb411732e4565778699fc692aa4",
      "created_at": "2026-05-03T18:31:00Z",
      "currency": "brl",
      "customer": "cus_xrqB9qfXH3PV5aST",
      "customer_document": "12345678901",
      "customer_document_type": "cpf",
      "customer_email": "nome@email.com",
      "customer_name": "Cliente Exemplo",
      "discount": "disc_855GojUKrqboBWt2",
      "expires_at": "2026-05-04T18:31:00Z",
      "has_surcharge": false,
      "invoice_creation": false,
      "line_items": [
        {
          "id": "li_GFNCAv6ekYaL32a3",
          "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_AHTSANHNb1mYsEUa",
          "price_data": null,
          "product": "prod_JHyFbeG3NXaaACRi",
          "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": "open",
      "submit_type": "auto",
      "subscription": null,
      "success_url": "https://meusite.com/sucesso",
      "url": "https://pay.chargefy.io/session/9f4c2a1b8e3d7f06a5c4b2e1d8f3a6b09c5e2a1f4b7d8c3e6a9f1d2c4b5e8a0f"
    }
  },
  "livemode": true,
  "organization": "org_9Akv2Ts684kfALHW",
  "request": {
    "id": "req_pQCzv8MhAX9y4rtM"
  },
  "type": "checkout.session.created"
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Evento checkout.session.created