Evento checkout.session.async.payment.succeeded

Evento `checkout.session.async.payment.succeeded`

Disparado quando um pagamento assíncrono de uma checkout session é confirmado depois do checkout.session.completed. Use este evento para liberar o produto ou serviço em sessões pagas por PIX ou boleto, que podem terminar o formulário antes da confirmação financeira. data.object contém a checkout session completa no estado atual: status: "complete" e payment_status: "paid". O método e os detalhes ficam em payment_data.

Este evento só acontece depois de checkout.session.completed ter sido emitido com payment_status: "unpaid". Cartão aprovado de forma síncrona não passa por este evento; ele já aparece como paid no completed.

Quando acontece

Situação	Como aparece no payload
PIX foi pago dentro da janela	`payment_data.payment_method: "pix"` e `payment_data.status: "succeeded"`.
Boleto foi compensado	`payment_data.payment_method: "boleto"` e `payment_data.status: "succeeded"`.
Sessão já tinha sido concluída pelo comprador	`status: "complete"` permanece; `payment_status` muda para `paid`.

Como processar

Registre o id do evento (evt_*) para processar o webhook de forma idempotente.
Use data.object.id como chave da checkout session no seu sistema.
Marque o pedido como pago usando payment_status: "paid".
Libere produto, serviço, assinatura ou reserva depois deste evento.
Use metadata, customer e line_items para conciliar com seu pedido interno.
Ignore entregas duplicadas quando a sessão já estiver marcada como paga localmente.

Campos importantes

Campo	O que observar
`data.object.status`	Permanece `complete`: o comprador já tinha concluído o formulário.
`payment_status`	Vem como `paid`; é o sinal para liberar o produto ou serviço em PIX e boleto.
`payment_data.payment_method`	Indica se o pagamento confirmado foi `pix` ou `boleto`.
`payment_data.status`	Vem como `succeeded` no exemplo de sucesso assíncrono.
`payment_data.expiration_date` / `payment_data.due_date`	Prazo original do PIX ou boleto, útil para conciliação.
`customer`	Customer resolvido no `completed`; use para histórico e atendimento.
`marketing_attribution`	Mesmo snapshot `first_touch` presente nos demais eventos da sessão.
`metadata`	Ecoa os metadados enviados na criação para correlacionar com seu pedido.

Pagamentos assíncronos

Método	Evento anterior	O que muda aqui
`pix`	`checkout.session.completed` com `payment_status: "unpaid"`	`payment_status` passa para `paid`.
`boleto`	`checkout.session.completed` com `payment_status: "unpaid"`	`payment_status` passa para `paid` após compensação.

Exemplo de payload

{
  "id": "evt_8h3K2pQ9mN4tR7vL",
  "object": "event",
  "created_at": "2026-05-03T20:14:00Z",
  "data": {
    "object": {
      "id": "cs_BcMaPCQh3Jp2YzMs",
      "object": "checkout.session",
      "allow_discount_codes": false,
      "amount_discount": 0,
      "amount_subtotal": 19990,
      "amount_tax": 0,
      "amount_total": 19990,
      "cancel_url": null,
      "client_reference_id": null,
      "client_secret": "faaba177db16706fe1c1743b40918f7c65238333e83559d0553808e5280c11b7",
      "created_at": "2026-05-03T18:31:00Z",
      "currency": "brl",
      "customer": "cus_YgBzkUAuBH6r1xDV",
      "customer_document": "123.456.789-00",
      "customer_document_type": "cpf",
      "customer_email": "nome@email.com",
      "customer_name": "Cliente",
      "discount": null,
      "expires_at": "2026-05-04T18:31:00Z",
      "has_surcharge": false,
      "invoice_creation": false,
      "line_items": [],
      "livemode": true,
      "marketing_attribution": null,
      "metadata": {},
      "mode": "payment",
      "payment_data": {
        "expiration_date": "2026-05-03T19:01:00Z",
        "payment_method": "pix",
        "qr_code": "00020126360014BR.GOV.BCB.PIX0114+5511...",
        "qr_code_url": "https://api.chargefy.io/qr/abc123.png",
        "status": "succeeded"
      },
      "payment_method_collection": "always",
      "payment_status": "paid",
      "status": "complete",
      "submit_type": "auto",
      "subscription": null,
      "success_url": "https://meusite.com/sucesso",
      "url": "https://pay.chargefy.io/session/..."
    }
  },
  "livemode": true,
  "organization": "org_CdB6D21gmcJ65XUW",
  "request": {
    "id": null
  },
  "type": "checkout.session.async.payment.succeeded"
}

data.object é o DTO completo de PublicCheckoutSession.

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Evento checkout.session.async.payment.succeeded