Endpoints
Consultar Saldo
Visión General
El endpoint GET /api/accounts/balances devuelve el saldo de la cuenta autenticada en el formato { data: [...] }, compatible con integraciones que siguen el estándar del Banco Central.
Endpoint
GET https://<api-host>/api/accounts/balancesAutenticación
Token Bearer obtenido en POST https://<api-host>/api/auth/token. Esta ruta no usa certificado de cliente.
Los parámetros de query se aceptan por compatibilidad, pero se ignoran: la respuesta siempre es el saldo actual de la cuenta del token.
Request
curl -X GET https://<api-host>/api/accounts/balances \
-H "Authorization: Bearer <token>"const response = await fetch('https://<api-host>/api/accounts/balances', {
method: 'GET',
headers: {
'Authorization': `Bearer ${token}`,
},
});
const balance = await response.json();import requests
response = requests.get(
'https://<api-host>/api/accounts/balances',
headers={
'Authorization': f'Bearer {token}',
}
)
balance = response.json()Response
Campos de la Respuesta
dataarrayLista de saldos. Siempre contiene un único ítem.
Cálculo del Saldo Total
saldoTotal = available + blockedComparación con la API Estándar
API Estándar (GET /api/balance) | API BACEN (GET /api/accounts/balances) |
|---|---|
grossBalance | available + blocked |
blockedBalance | blocked |
netBalance | available |
consultedAt | eventDate |
Ejemplo de Equivalencia
// API Estándar
{
"grossBalance": 50234.90,
"blockedBalance": 1500.00,
"netBalance": 48734.90,
"consultedAt": "2025-01-15T10:30:00.000Z"
}
// API BACEN (equivalente)
{
"data": [{
"eventDate": "2025-01-15T10:30:00.000Z",
"balanceAmount": {
"available": 48734.90,
"blocked": 1500.00,
"overdraft": 0
}
}]
}Buenas Prácticas
Errores Comunes
| Código HTTP | Causa | Solución |
|---|---|---|
| 401 | Header Authorization ausente | Incluya Authorization: Bearer <token> |
| 401 | Token inválido o expirado | Genere un nuevo token en POST /api/auth/token |