Evento payment.intent.succeeded

Evento `payment.intent.succeeded`

Disparado quando um payment_intent chega ao estado succeeded. Este é o evento principal para confirmar que uma cobrança foi concluída. Use-o para avançar a operação de negócio, marcar faturas como pagas no seu sistema e registrar o valor recebido. data.object usa o mesmo shape de GET /v1/payment-intents/:id. Em webhooks, payment_method vem como ID; consulte ou expanda o recurso pela API quando precisar do retrato completo do cartão. O objeto é completo no estado succeeded; ele não é um patch. Este evento normalmente não precisa de data.previous_attributes para confirmar o pagamento: use data.object como fonte do estado final.

Uma charge representa a tentativa concreta de cobrança. O payment_intent representa o ciclo inteiro: ele pode ter latest_charge, invoice, customer e metadata para conciliação.

Quando acontece

Situação	Como aparece no payload
Cartão confirmado com captura automática	`status: "succeeded"`, `amount_received` preenchido e `latest_charge` apontando para a charge.
Captura manual concluída	O intent sai de `requires_capture` para `succeeded` e `amount_capturable` volta a `0`.
PIX ou boleto confirmado de forma assíncrona	O intent que estava `pending` passa para `succeeded`.
Cobrança ligada a invoice	`invoice` vem preenchida para conciliar o pagamento com a fatura.

Como processar

Registre o id do evento (evt_*) para processar o webhook de forma idempotente.
Use data.object.id (pi_*) como chave canônica da cobrança.
Libere o pedido usando data.object.status === "succeeded", não apenas a existência de uma charge.
Grave amount_received, amount_details.amount e currency para conciliação financeira.
Use latest_charge para salvar a tentativa que concluiu o pagamento.
Use customer, invoice e metadata para ligar o pagamento ao seu pedido ou fatura.

Campos importantes

Campo	O que observar
`data.object.status`	Sempre vem como `succeeded` neste evento.
`amount_received`	Valor recebido em centavos; normalmente igual ao total cobrado.
`amount` / `amount_details.amount`	Total do intent e quebra entre principal, repasse e juros de parcelamento.
`amount_capturable`	Em sucesso, fica `0` quando não há valor pendente de captura.
`latest_charge`	Charge que materializou a tentativa concluída.
`invoice`	Fatura associada, quando o intent nasceu de uma invoice.
`payment_method`	Método salvo usado no pagamento; em webhook vem como ID.
`metadata`	Ecoa os metadados enviados na criação para correlacionar com seu pedido.

Status possíveis

Neste evento, data.object.status é succeeded. A tabela abaixo resume os status que um payment_intent pode assumir ao longo do ciclo de vida:

Valor	Descrição
`requires_payment_method`	Falta definir o método de pagamento.
`requires_confirmation`	Pronto para confirmar.
`requires_capture`	Cartão autorizado; falta capturar.
`pending`	Aguardando ação do comprador ou confirmação assíncrona.
`processing`	Pagamento em processamento.
`succeeded`	Pagamento concluído.
`failed`	Pagamento falhou.
`canceled`	Pagamento cancelado.

Motivos de cancelamento

cancellation_reason vem null em payment.intent.succeeded. Quando você consultar intents cancelados, os valores possíveis são:

Valor	Descrição
`duplicate`	Cobrança duplicada.
`fraudulent`	Cobrança suspeita de fraude.
`requested_by_customer`	Cancelamento solicitado pelo comprador.
`abandoned`	O comprador saiu do fluxo; só aparece se você enviou esse motivo.

Exemplo de payload

{
  "id": "evt_Tg9uLJ9nSwRotsdm",
  "object": "event",
  "created_at": "2026-05-16T18:35:00Z",
  "data": {
    "object": {
      "id": "pi_cp8PEHDrfGwR5YRM",
      "object": "payment_intent",
      "amount": 10528,
      "amount_capturable": 0,
      "amount_details": {
        "amount": 10528,
        "installment_interest_amount": 528,
        "principal_amount": 10000,
        "surcharge_amount": 0
      },
      "amount_received": 10528,
      "canceled_at": null,
      "cancellation_reason": null,
      "capture_method": "automatic",
      "client_secret": "pi_cp8PEHDrfGwR5YRM_secret_4b7bf30e198800ec597ad30ba8c0f4392056ca099d831e07",
      "confirmation_method": "automatic",
      "created_at": "2026-05-16T18:34:58Z",
      "currency": "brl",
      "customer": "cus_sLdVsaNg2A2AW6P5",
      "installment_interest_amount": 528,
      "installments": 3,
      "invoice": "inv_jM1Qm4rT3rCKGuqa",
      "last_payment_error": null,
      "latest_charge": "ch_fdpq9wUDuJA2gd9k",
      "livemode": true,
      "metadata": {},
      "next_action": null,
      "payment_method": "pm_x7aLHPtAfeDLD3Hg",
      "payment_method_options": {
        "credit_card": {
          "installments": {
            "amount": 10528,
            "count": 3,
            "has_interest": true,
            "installment_interest_amount": 528,
            "principal_amount": 10000,
            "surcharge_amount": 0
          }
        }
      },
      "payment_method_types": [
        "credit_card"
      ],
      "principal_amount": 10000,
      "status": "succeeded",
      "surcharge_amount": 0,
      "updated_at": "2026-05-16T18:35:00Z"
    }
  },
  "livemode": true,
  "organization": "org_U2cZB4rnrAhBSPDD",
  "request": {
    "id": null
  },
  "type": "payment.intent.succeeded"
}

Páginas relacionadas

Objeto Payment Intent

Campos financeiros, relações e timestamps de data.object.

Integração com Payment Intents

Handler idempotente para concluir a operação no seu sistema.

Charge concluída

Histórico da tentativa concreta que concluiu o intent.

Conciliação

Relação com Charge, Transaction e Invoice.

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Evento payment.intent.succeeded