Consultar saldo

GET/v1/balance

Devuelve el saldo actual de la cuenta INFI.

Respuesta `200 OK`

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

Campo	Descripción
`available`	Saldo bruto de la cuenta, en centavos. No descuenta los bloqueos cautelares activos (ver Callout abajo).
`pending`	Reservado para uso futuro. Hoy siempre `0`.
`currency`	Siempre `"BRL"`.
`updatedAt`	Timestamp Unix en milisegundos del momento de la respuesta.

Atención: `available` puede no coincidir con lo retirable

Si la cuenta tiene bloqueos cautelares activos (p.ej. MED del Bacen, disputa, bloqueo administrativo), el valor efectivamente retirable es available − suma de bloqueos activos. Un intento de retiro por encima de ese límite devuelve 422 Saldo insuficiente.

Consistencia eventual

Tras la confirmación de un cobro o retiro, available refleja el nuevo monto en pocos segundos. Para conciliación fina, usa GET /v1/transactions/:id.

Ejemplos

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 transacción Configuración

Consultar saldo

Respuesta 200 OK

Ejemplos

Respuesta `200 OK`