> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Evento charge.failed

> Evento charge.failed.

## Evento `charge.failed`

Disparado quando uma `charge` chega ao estado `failed`.

`data.object` usa o mesmo shape de [`GET /v1/charges/:id`](/api-reference/charges/get). O motivo da recusa vem no objeto `payment_error` (`category`, `code`, `message`) — veja [Códigos de falhas](/api-reference/charges/failure-codes) para a lista de códigos.

<ResponseExample>
  ```json 200 theme={}
  {
    "id": "evt_123",
    "object": "event",
    "created_at": "2026-05-19T18:35:00Z",
    "data": {
      "object": {
        "id": "ch_123",
        "object": "charge",
        "amount": 9990,
        "amount_captured": 0,
        "amount_refunded": 0,
        "billing_details": {},
        "captured": false,
        "created_at": "2026-05-19T18:34:58Z",
        "currency": "brl",
        "customer": "cus_123",
        "description": null,
        "disputed": false,
        "invoice": "inv_123",
        "livemode": true,
        "metadata": {},
        "paid": false,
        "payment_error": {
          "category": "issuer_declined",
          "code": "payment_failed",
          "message": "Payment failed."
        },
        "payment_intent": "pi_123",
        "payment_method": "pm_123",
        "payment_method_details": {},
        "receipt_url": null,
        "refunded": false,
        "refunds": {
          "object": "list",
          "data": [],
          "has_more": false,
          "url": "/v1/refunds?charge=ch_123"
        },
        "status": "failed",
        "updated_at": "2026-05-19T18:35:00Z"
      }
    },
    "livemode": true,
    "organization": "org_123",
    "request": {
      "id": null
    },
    "type": "charge.failed"
  }
  ```
</ResponseExample>