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.

curl "https://api-dev.messagefy.io/api/v1/billing/Transactions?pageSize=50" -H "API-KEY: acc_..."

Parâmetros

integer

default:"50"

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

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).

uuid

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

Resposta

{
  "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). `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

Lançamentos anteriores a esta versão vêm com channelId: null: o canal passou a ser registrado a partir dela.

Paginação

Chame sem cursor: vêm os lançamentos mais recentes.
Se nextCursor não for null, chame de novo com cursor=<nextCursor>.
Repita até nextCursor voltar 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

Início

Contas

API Keys

Canais

WhatsApp Oficial

Cobranças

Tipos de Mensagem

Operações de Mensagem

Sessão e Conexão

Consultas

Interação

Lançamentos

Lançamentos

Parâmetros

Resposta

Campos

Tipos de lançamento

Paginação

Erros

​Lançamentos

​Parâmetros

​Resposta

​Campos

​Tipos de lançamento

​Paginação

​Erros

Lançamentos

Parâmetros

Resposta

Campos

Tipos de lançamento

Paginação

Erros