Evento charge.succeeded - Chargefy

Evento `charge.succeeded`

Disparado quando uma tentativa concreta de cobrança chega ao estado succeeded. Use este evento para confirmar que a tentativa moveu dinheiro e que a charge pode ser tratada como paga no seu sistema. data.object usa o mesmo shape de GET /v1/charges/:id.

Uma charge é uma tentativa de pagamento. Em fluxos com retentativa, concilie a venda pelo payment_intent, invoice, customer ou metadata, e guarde o data.object.id para o histórico da tentativa que foi aprovada.

Quando acontece

Situação	Como aparece no payload
Pagamento aprovado	`status: "succeeded"`, `paid: true` e `captured: true`.
Captura concluída	`amount_captured` reflete o valor capturado em centavos.
Recibo disponível	`receipt_url` traz a URL pública do recibo da cobrança.
Tentativa sem erro	`payment_error` vem como `null`.

Como processar

Registre o id do evento (evt_*) para processar o webhook de forma idempotente.
Use data.object.id (ch_*) para salvar a tentativa aprovada.
Atualize o pedido usando payment_intent, invoice, customer ou metadata, conforme o seu modelo.
Confirme valores usando amount, amount_captured e currency, em vez de depender só do status.
Salve receipt_url quando quiser exibir ou enviar o recibo ao comprador.

Campos importantes

Campo	O que observar
`data.object.status`	Sempre vem como `succeeded` neste evento.
`paid` / `captured`	Indicam que a cobrança foi paga e capturada.
`amount_captured`	Valor efetivamente capturado em centavos.
`payment_method_details.type`	Meio de pagamento usado na tentativa (`credit_card`, `pix` ou `boleto`).
`receipt_url`	URL do recibo público quando disponível.
`refunds`	Lista os refunds já associados à cobrança; neste exemplo ainda está vazia.
`metadata`	Ecoa os metadados enviados na criação para correlacionar com seu pedido.

Exemplo de payload

{
  "id": "evt_5gpEGQmpc1jn59Fp",
  "object": "event",
  "created_at": "2026-05-19T18:35:00Z",
  "data": {
    "object": {
      "id": "ch_TPoPWRsehUx1c66q",
      "object": "charge",
      "amount": 9990,
      "amount_captured": 9990,
      "amount_refunded": 0,
      "billing_details": {
        "billing_address": {},
        "document": "12345678901",
        "document_type": "cpf",
        "email": "nome@email.com",
        "name": "Cliente Exemplo"
      },
      "captured": true,
      "created_at": "2026-05-19T18:34:58Z",
      "currency": "brl",
      "customer": "cus_mKuLaVCFShUX8C9V",
      "description": "Assinatura do Plano Pro",
      "disputed": false,
      "invoice": "inv_6Qz83pzJ958bhEWd",
      "livemode": true,
      "metadata": {},
      "paid": true,
      "payment_error": null,
      "payment_intent": "pi_7J2f6h8WzCzp3C9d",
      "payment_method": "pm_KZhAvLrsYz13eNq7",
      "payment_method_details": {
        "card": {
          "amount_authorized": 9990,
          "authorization_code": "123456",
          "brand": "visa",
          "checks": {
            "address_line1_check": "unchecked",
            "address_postal_code_check": "unchecked",
            "cvc_check": "pass"
          },
          "country": null,
          "exp_month": 12,
          "exp_year": 2030,
          "funding": null,
          "installments": 1,
          "last4": "4242",
          "network": null
        },
        "type": "credit_card"
      },
      "receipt_url": "https://receipts.chargefy.io/receipt/ch_TPoPWRsehUx1c66q",
      "refunded": false,
      "refunds": {
        "object": "list",
        "data": [],
        "has_more": false,
        "url": "/v1/refunds?charge=ch_TPoPWRsehUx1c66q"
      },
      "status": "succeeded",
      "updated_at": "2026-05-19T18:35:00Z"
    }
  },
  "livemode": true,
  "organization": "org_QAFE4UU16g6bugLH",
  "request": {
    "id": null
  },
  "type": "charge.succeeded"
}