> ## 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 transaction.canceled

> Um lançamento foi cancelado

## Evento `transaction.canceled`

Disparado quando um lançamento pendente é cancelado (ex.: a cobrança de origem foi anulada antes de liquidar). Lançamentos cancelados nunca somam no extrato.

O `data.object` usa o mesmo shape de
[`GET /v1/transactions/:id`](/api-reference/transactions/get). Movimentos de
saída (estornos) têm `amount` e `net_amount` negativos — somar os eventos de
um período é somar o extrato.

## Como processar

* Registre o `id` do evento (`evt_*`) para processar de forma idempotente.
* Use `data.object.id` (`txn_*`) como chave do lançamento no seu sistema.
* Relacione o movimento à venda por `payment_intent` e ao causador por `source`.

## Payload

```json theme={"theme":"css-variables"}
{
  "id": "evt_5R8sT9fK2mQ4xW7p",
  "object": "event",
  "created_at": "2026-07-20T14:32:12Z",
  "data": {
    "object": {
      "id": "txn_2eMBWoadBKMdRPbJ",
      "object": "transaction",
      "amount": 11000,
      "available_at": "2026-09-19T00:00:00Z",
      "created_at": "2026-07-20T14:32:11Z",
      "currency": "brl",
      "description": "Installment 2/10",
      "fee_amount": 1399,
      "fee_details": [
        {
          "amount": 1000,
          "description": "Installment interest",
          "type": "installment_interest"
        },
        {
          "amount": 399,
          "description": "Chargefy processing fee",
          "type": "chargefy_fee"
        }
      ],
      "installment": 2,
      "installment_count": 10,
      "livemode": true,
      "metadata": {},
      "net_amount": 9601,
      "payment_intent": "pi_uUWKKPGcQ74HUcsE",
      "settled_at": null,
      "source": "ch_uMioQBJys7w5SjqZ",
      "status": "canceled",
      "type": "charge",
      "updated_at": null
    },
    "previous_attributes": {
      "status": "pending"
    }
  },
  "livemode": true,
  "organization": "org_L9kR3sTM2nQ7xW4p",
  "request": null,
  "type": "transaction.canceled"
}
```