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

# Lançamentos

> Cada crédito, cobrança, estorno e ajuste da sua conta, com o canal de cada mensagem, do mais novo para o mais antigo.

# Lançamentos

Todo movimento do saldo da conta é um **lançamento**: um crédito que entrou, uma mensagem cobrada, um estorno, um
ajuste. Lançamento nunca é alterado nem apagado: uma correção é sempre um lançamento novo.

```bash theme={null}
curl "https://api-dev.messagefy.io/api/v1/billing/Transactions?pageSize=50" -H "API-KEY: acc_..."
```

## Parâmetros

**pageSize** `integer` (default: 50)

Lançamentos por página, de 1 a 200. Valor fora da faixa é ajustado ao limite.

**cursor** `integer`

Para a próxima página, envie o `nextCursor` recebido na página anterior. Sem ele, a primeira página (os lançamentos
mais recentes).

**accountId** `uuid`

Só para chaves `org_`: a conta a consultar. Com chave `acc_`, a conta vem da chave.

## Resposta

```json theme={null}
{
  "account": { "id": "11111111-1111-1111-1111-111111111111" },
  "transactions": [
    {
      "id": 1043,
      "channelId": null,
      "type": "Credit",
      "amount": 100.0000,
      "feeCode": null,
      "description": "Recarga",
      "occurredAt": "2026-10-15T13:37:58Z"
    },
    {
      "id": 1042,
      "channelId": "22222222-2222-2222-2222-222222222222",
      "type": "Reversal",
      "amount": 0.0485,
      "feeCode": "meta-utility",
      "description": "meta-failed",
      "occurredAt": "2026-10-15T13:37:58Z"
    },
    {
      "id": 1041,
      "channelId": "22222222-2222-2222-2222-222222222222",
      "type": "Debit",
      "amount": -0.3717,
      "feeCode": "meta-marketing",
      "description": null,
      "occurredAt": "2026-10-14T14:00:00Z"
    }
  ],
  "nextCursor": 1041
}
```

Lendo esse exemplo, do mais novo para o mais antigo: entrou um crédito de **R$ 100,00**; uma mensagem de utilidade do
canal `2222…` foi estornada (**R$ 0,0485** de volta); e uma mensagem de marketing do mesmo canal foi cobrada
(**R\$ 0,3717**).

## Campos

| Campo | O que é | Exemplo |
| - | - | - |
| `account.id` | A sua conta | `11111111-...` |
| `transactions[].id` | Número do lançamento. Também é o cursor | `1041` |
| `transactions[].channelId` | O canal da mensagem (em cobrança, estorno e ajuste). `null` em crédito | `2222…` |
| `transactions[].type` | O tipo do lançamento (tabela abaixo) | `Debit` |
| `transactions[].amount` | Valor **com sinal**: positivo entrou no saldo, negativo saiu | `-0.3717` = R\$ 0,3717 cobrados |
| `transactions[].feeCode` | O tipo de mensagem cobrada (veja os códigos em [Consumo diário](https://docs.messagefy.io/cobrancas/consumo-diario.md)). `null` em crédito | `meta-marketing` |
| `transactions[].description` | Descrição do lançamento (no estorno e no ajuste, o motivo) | `meta-failed` |
| `transactions[].occurredAt` | Quando o fato aconteceu (UTC): na cobrança e no ajuste, o envio da mensagem; no crédito e no estorno, o lançamento | `2026-10-14T14:00:00Z` |
| `nextCursor` | Envie em `cursor` para a próxima página. `null` = acabou | `1041` |

### Tipos de lançamento

| `type` | Significado | Sinal de `amount` |
| - | - | - |
| `Credit` | Crédito na conta | `+` |
| `Debit` | Mensagem cobrada | `−` |
| `Reversal` | Estorno de uma cobrança (ex.: a Meta não entregou) | `+` |
| `Adjustment` | Ajuste de uma cobrança (a Meta cobrou outra categoria) | `+` devolveu, `−` cobrou a mais |

> [!NOTE]
>
> Lançamentos anteriores a esta versão vêm com `channelId: null`: o canal passou a ser registrado a partir dela.

## Paginação

1. Chame sem `cursor`: vêm os lançamentos mais recentes.
2. Se `nextCursor` não for `null`, chame de novo com `cursor=<nextCursor>`.
3. Repita até `nextCursor` voltar `null`.

```bash theme={null}
curl "https://api-dev.messagefy.io/api/v1/billing/Transactions?pageSize=50&cursor=1041" -H "API-KEY: acc_..."
```

## Erros

| HTTP | `errorCode` | Quando |
| - | - | - |
| `401` | — | Chave inválida ou ausente |
| `404` | `ACCOUNT_NOT_FOUND` | Chave `org_` com `accountId` de outra *Organization* |
| `503` | `BILLING_UNAVAILABLE` | Serviço indisponível; tente de novo em instantes |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.