Conta
Saldo
Consulte o saldo disponível, reservado em saques e em depósitos pendentes.
Saldo
Retorna o saldo do merchant autenticado em três visões:
- Disponível — pronto pra uso (gerar saque, transferência interna).
- Reservado em saques pendentes — saques criados que ainda não confirmaram no SPI.
- Pendente em depósitos — cobranças PIX criadas que ainda não foram pagas.
GET /v1/balance
Headers
| Header | Obrigatório |
|---|---|
client-id | sim |
client-secret | sim |
Exemplo
curl https://api.moneyflybr.com/v1/balance \
-H "client-id: mf_pk_live_..." \
-H "client-secret: mf_sk_live_..."Resposta (HTTP 200)
{
"available_cents": 98020,
"pending_withdrawals_cents": 5000,
"pending_deposits_cents": 0,
"currency": "BRL",
"ts": "2026-04-24T18:30:00Z"
}| Campo | Tipo | Descrição |
|---|---|---|
available_cents | integer | Saldo livre pra movimentar (em centavos) |
pending_withdrawals_cents | integer | Valor "preso" em saques que ainda não confirmaram |
pending_deposits_cents | integer | Valor de depósitos criados que ainda não foram pagos |
currency | string | Sempre BRL por enquanto |
ts | string ISO 8601 | Timestamp do snapshot |
Quando consultar
- Antes de criar saque — pra evitar erro 400 de saldo insuficiente.
- No dashboard do merchant — mostrar saldo na home.
- Em reconciliação noturna — comparar com seu sistema interno.
Se quiser saldo em "tempo real" sem polling, prefira ouvir os webhooks deposit.paid, payout.paid, payout.cancelled e payout.failed — cada um indica mudança no saldo. Polling só pra inicialização da tela.