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

# Visão geral

> Como funciona a cobrança pré-paga da MessageFy: o saldo da sua conta, como cada mensagem é cobrada e onde acompanhar o gasto.

# Cobranças

O envio pelo **WhatsApp Oficial** é **pré-pago**: cada mensagem cobrada sai do **saldo da sua conta** (*Account*).
Nesta seção você acompanha esse saldo, quanto gastou por dia e cada lançamento.

| Quero saber | Onde | Chamada |
| - | - | - |
| Quanto tenho para usar agora | [Saldo](https://docs.messagefy.io/cobrancas/saldo.md) | `GET /api/v1/billing/Balance` |
| Quanto gastei por dia, e com qual tipo de mensagem | [Consumo diário](https://docs.messagefy.io/cobrancas/consumo-diario.md) | `GET /api/v1/billing/Usage/Daily` |
| Cada crédito, cobrança, estorno e ajuste | [Lançamentos](https://docs.messagefy.io/cobrancas/lancamentos.md) | `GET /api/v1/billing/Transactions` |

## O saldo da conta

O saldo é **da conta**. Todos os canais da conta usam o mesmo saldo (não existe saldo por canal), e todas as
respostas trazem a conta (`account`) com dois valores:

| Campo | O que é |
| - | - |
| `available` | O que pode ser usado agora. Pode ficar **negativo** (veja abaixo): aí os envios ficam bloqueados até um crédito cobrir a diferença |
| `reserved` | Separado para envios em andamento: ainda não pode ser usado. Hoje sempre `0` |

Esses dois nomes são os mesmos em todas as chamadas de Cobranças.

## O canal de cada cobrança

O saldo é um só, mas cada cobrança, estorno e ajuste guarda o **canal** (`channelId`) da mensagem. Ele aparece em cada
item dos [lançamentos](https://docs.messagefy.io/cobrancas/lancamentos.md).

## Como cada mensagem é cobrada

* Cada mensagem enviada é cobrada pelo seu **tipo** (marketing, utilidade, autenticação, atendimento), no momento do
  envio.
* Mensagens **recebidas** também podem ser cobradas e **nunca** são bloqueadas por falta de saldo. Nesse caso o saldo
  pode ficar negativo, e o próximo crédito cobre primeiro esse valor.
* Quando a Meta não entrega a mensagem, o valor volta como **estorno**. Quando a Meta cobra outra categoria, a diferença
  vira um **ajuste**. Os dois aparecem nos [lançamentos](https://docs.messagefy.io/cobrancas/lancamentos.md), e o
  [consumo diário](https://docs.messagefy.io/cobrancas/consumo-diario.md) já mostra o valor final de cada mensagem.

## Quando o envio é recusado

O envio é aceito (`200 OK`) e a cobrança acontece em seguida. Se ela não passar, você recebe um
`SEND_MESSAGE_RESPONSE` com `success: false` no canal de feedback (veja [Recebendo eventos](https://docs.messagefy.io/recebendo-eventos.md)):

| Motivo | O que fazer |
| - | - |
| Saldo insuficiente | Coloque crédito na conta e envie de novo |
| Conta ainda sem saldo configurado | Aguarde alguns instantes e tente de novo; persistindo, fale com o suporte |
| Serviço de cobrança temporariamente indisponível | Tente de novo em instantes. A mensagem não foi cobrada |

## Autenticação e escopo

Todas as chamadas de Cobranças usam a sua API Key no header `API-KEY`. A conta vem da chave: não é preciso enviar
`accountId`.

> [!NOTE]
>
> Chaves `acc_` veem só a própria *Account*. Chaves `org_` informam a conta no parâmetro `accountId`; conta de outra
> *Organization* devolve `404`.

Valores têm até **4 casas decimais** (ex.: `0.3717` = R\$ 0,3717). Para exibir em reais, arredonde só na tela.

## Próximos passos

> [card] [Saldo](https://docs.messagefy.io/cobrancas/saldo.md)
>
> Disponível e reservado da conta.

> [card] [Consumo diário](https://docs.messagefy.io/cobrancas/consumo-diario.md)
>
> Gasto por dia e por tipo de mensagem.

> [card] [Lançamentos](https://docs.messagefy.io/cobrancas/lancamentos.md)
>
> Cada crédito, cobrança, estorno e ajuste, com o canal de cada mensagem.


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