Consultar saldo

GET/v1/balance

Retorna o saldo atual da conta INFI.

Resposta `200 OK`

{
  "available": 124530,
  "pending": 0,
  "currency": "BRL",
  "updatedAt": 1715000000000
}

Campo	Descrição
`available`	Saldo bruto da conta, em centavos. Não desconta bloqueios cautelares ativos (ver Callout abaixo).
`pending`	Reservado para uso futuro. Sempre `0` hoje.
`currency`	Sempre `"BRL"`.
`updatedAt`	Unix timestamp em milissegundos do momento da resposta.

Atenção: `available` pode não bater com o sacável

Se a conta tem bloqueios cautelares ativos (ex.: MED do Bacen, disputa, bloqueio administrativo), o valor efetivamente sacável é available − soma de bloqueios ativos. Uma tentativa de saque acima desse limite retorna 422 Saldo insuficiente.

Eventual consistência

Após a confirmação de uma cobrança ou saque, available reflete o novo valor em até alguns segundos. Para reconciliação fina, use GET /v1/transactions/:id.

Exemplos

curl https://api.internationalfinance.com.br/v1/balance \
  -H "Authorization: Bearer $INFI_API_KEY"

const res = await fetch('https://api.internationalfinance.com.br/v1/balance', {
  headers: { Authorization: `Bearer ${process.env.INFI_API_KEY}` },
})
const balance = await res.json()
console.log('R$', (balance.available / 100).toFixed(2))

import os, requests
 
res = requests.get(
    "https://api.internationalfinance.com.br/v1/balance",
    headers={"Authorization": f"Bearer {os.environ['INFI_API_KEY']}"},
)
balance = res.json()
print(f"R$ {balance['available'] / 100:.2f}")

<?php
$client = new GuzzleHttp\Client();
$res = $client->get('https://api.internationalfinance.com.br/v1/balance', [
  'headers' => ['Authorization' => 'Bearer ' . getenv('INFI_API_KEY')],
]);
$balance = json_decode($res->getBody(), true);

Consultar transação Configurando

Consultar saldo

Resposta 200 OK

Exemplos

Resposta `200 OK`