Evento setup.intent.canceled

Evento `setup.intent.canceled`

Disparado quando um setup_intent chega ao estado canceled. Use este evento para encerrar localmente um fluxo de salvamento de método de pagamento que não deve mais avançar. Um setup intent cancelado é terminal: ele não salva método e não deve ser confirmado novamente. data.object usa o mesmo shape do objeto setup_intent. data.previous_attributes mostra os valores anteriores dos campos que mudaram, como status, canceled_at e cancellation_reason.

Um setup intent nunca cobra valor. Cancelar esse recurso encerra apenas a coleta do método de pagamento.

Quando acontece

Situação	Como aparece no payload
Setup intent cancelado pela API	`data.object.status: "canceled"`.
Fluxo abandonado	`cancellation_reason` pode vir como `abandoned`.
Estado anterior mudou para terminal	`previous_attributes.status` mostra o status anterior.

Como processar

Registre o id do evento (evt_*) para processar o webhook de forma idempotente.
Use data.object.id (seti_*) para marcar o fluxo de salvamento como cancelado.
Não tente confirmar novamente o mesmo setup intent depois deste evento.
Use cancellation_reason para decidir se deve abrir um novo fluxo para o comprador.
Desconsidere o client_secret para novas ações depois que o status for canceled.

Campos importantes

Campo	O que observar
`data.object.status`	Sempre vem como `canceled` neste evento.
`canceled_at`	Horário em que o setup intent foi cancelado.
`cancellation_reason`	Motivo público do cancelamento.
`data.previous_attributes`	Valores anteriores dos campos alterados.
`customer`	Customer associado ao fluxo, quando informado.
`payment_method`	Normalmente `null`, já que o método não foi salvo.
`metadata`	Objeto livre para correlacionar com seu sistema.

Motivos de cancelamento

Valor	Descrição
`abandoned`	O comprador não concluiu a coleta e o fluxo foi abandonado.
`requested_by_customer`	O cliente pediu para não salvar o método de pagamento.
`duplicate`	Outro setup intent já cobre a mesma coleta.

Exemplo de payload

{
  "id": "evt_M68zBuide9qEMHig",
  "object": "event",
  "created_at": "2026-05-16T18:33:00Z",
  "data": {
    "object": {
      "id": "seti_E4r847v3eQpdzxxA",
      "object": "setup_intent",
      "canceled_at": "2026-05-16T18:33:00Z",
      "cancellation_reason": "abandoned",
      "client_secret": "seti_E4r847v3eQpdzxxA_secret_0f38c1006bbb394db19d25a03f64eda9d86d42fb01c288d2",
      "created_at": "2026-05-16T18:30:00Z",
      "customer": "cus_SaUbXFJRBM656cPF",
      "last_setup_error": null,
      "latest_attempt": null,
      "livemode": true,
      "metadata": {},
      "next_action": null,
      "payment_method": null,
      "payment_method_types": [
        "credit_card"
      ],
      "status": "canceled",
      "updated_at": "2026-05-16T18:33:00Z",
      "usage": "off_session"
    },
    "previous_attributes": {
      "canceled_at": null,
      "cancellation_reason": null,
      "status": "requires_payment_method"
    }
  },
  "livemode": true,
  "organization": "org_6YvjJ2L2cWFh2qJM",
  "request": {
    "id": null
  },
  "type": "setup.intent.canceled"
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Evento setup.intent.canceled