Consultar Saldo - Delfinance

A consulta de saldo retorna quanto a conta tem disponível para movimentar e quanto está bloqueado, separado por motivo do bloqueio. Use o saldo disponível para validar se uma transferência ou um pagamento cabe na conta antes de enviá-lo. Isso evita o erro de saldo insuficiente em Pix, TED e pagamento de contas.

Consultar o saldo

curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/balances' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'

{
    "amountAvailable": 15230.40,
    "amountJudicialyBlocked": 0.00,
    "amountTempBlocked": 0.00,
    "amountPixBlocked": 200.99,
    "amountTempBlockedOperationInternal": 250.00,
    "amountBlockedForDebit": 0.00
}

Campos da resposta

Campo	Descrição
`amountAvailable`	Saldo disponível para movimentar. É o valor que você pode transferir ou usar em pagamentos
`amountJudicialyBlocked`	Valor bloqueado por ordem judicial
`amountTempBlocked`	Valor com bloqueio temporário
`amountPixBlocked`	Valor bloqueado em transações Pix, por exemplo por uma notificação de infração (MED)
`amountTempBlockedOperationInternal`	Valor com bloqueio temporário por operação interna
`amountBlockedForDebit`	Valor reservado para um débito já programado

Os valores bloqueados não fazem parte do amountAvailable. Para mostrar o saldo bloqueado total, some os cinco campos de bloqueio.

Saldo e extrato

O saldo mostra a posição atual da conta. Para ver como a conta chegou nesse valor, use o extrato. Cada transação do extrato traz o saldo antes e depois do lançamento, no objeto balance.

Não consulte o saldo em loop para detectar recebimentos. Os créditos chegam via webhooks.

Referência da API

Consultar saldo

GET /baas/api/v1/balances