Changelog API Grafeno: 2026-07-29

Improved: [API de Saldos] Novos campos de saldos pendentes no endpoint de detalhes de saldo

O que mudou

Campo	Descrição
`pendingCashOut`	Valor pendente e reservado na conta que ainda sairá dela, por exemplo, uma transferência aguardando aprovação ou uma tarifa a ser cobrada.
`pendingCashIn`	Valor pendente que ainda será depositado na conta, por exemplo, uma cobrança já paga, mas ainda não liquidada.

Ambos os campos ficam disponíveis dentro de data.attributes, junto aos campos de saldo já existentes.

Exemplo de resposta

{
    "data": {
        "id": "Numero da conta Grafeno",
        "type": "balance",
        "attributes": {
            "currentBalance": "10413650.94",
            "availableBalance": "10393589.21",
            "initialBalance": "10407372.13",
            "finalBalance": "10413650.94",
            "pendingCashIn": "12588.00",
            "pendingCashOut": "7473.73"
        }
    },
    "meta": {
        "search": {
            "entryAtGteq": "2026-07-01",
            "entryAtLteq": "2026-07-31"
        }
    }
}

Nota importante para integradores

A diferença entre currentBalance e availableBalance sempre será igual à soma de pendingCashIn e pendingCashOut:

currentBalance - availableBalance = pendingCashIn + pendingCashOut

No exemplo acima: 10413650.94 - 10393589.21 = 20061.73, que corresponde a pendingCashIn (12588.00) + pendingCashOut (7473.73).

Isso é útil para quem já realiza essa subtração hoje e deseja validar ou decompor essa diferença.

Compatibilidade

Essa é uma mudança retrocompatível: os campos são apenas adicionados ao objeto attributes já existente. Integrações que ignoram campos desconhecidos no payload não são impactadas.

Acesse a especificação técnica da API de saldos Grafeno para obter informações sobre como utilizar este recurso.