curl -X GET https://consola.mouvlatam.com/api/wallets/balance \
-H "Authorization: Bearer mvk_a1b2c3d4..."
const res = await fetch('https://consola.mouvlatam.com/api/wallets/balance', {
headers: { 'Authorization': `Bearer ${process.env.MOUV_API_KEY}` },
});
const data = await res.json();
console.log('Saldo BREB:', data.wallets.find(w => w.rail === 'BREB').availableCents);
console.log('Saldo ACH:', data.wallets.find(w => w.rail === 'ACH').availableCents);
console.log('Total:', data.consolidated.availableCents);
import requests
res = requests.get(
'https://consola.mouvlatam.com/api/wallets/balance',
headers={'Authorization': f'Bearer {os.environ["MOUV_API_KEY"]}'}
)
data = res.json()
print(f'Saldo BREB: {data["wallets"][0]["availableCents"]}')
{
"currency": "COP",
"wallets": [
{
"rail": "BREB",
"type": "FAST",
"availableCents": "5000000",
"pendingOutCents": "0",
"totalCents": "5000000",
"version": 12,
"maxTransferAmount": 4900000
},
{
"rail": "ACH",
"type": "ACH",
"availableCents": "138305296",
"pendingOutCents": "0",
"totalCents": "138305296",
"version": 47,
"maxTransferAmount": 137000000
}
],
"consolidated": {
"availableCents": "143305296",
"pendingOutCents": "0",
"totalCents": "143305296",
"currency": "COP"
}
}
Saldos
GET /wallets/balance
Obtener saldo BREB + ACH + consolidado
GET
/
api
/
wallets
/
balance
curl -X GET https://consola.mouvlatam.com/api/wallets/balance \
-H "Authorization: Bearer mvk_a1b2c3d4..."
const res = await fetch('https://consola.mouvlatam.com/api/wallets/balance', {
headers: { 'Authorization': `Bearer ${process.env.MOUV_API_KEY}` },
});
const data = await res.json();
console.log('Saldo BREB:', data.wallets.find(w => w.rail === 'BREB').availableCents);
console.log('Saldo ACH:', data.wallets.find(w => w.rail === 'ACH').availableCents);
console.log('Total:', data.consolidated.availableCents);
import requests
res = requests.get(
'https://consola.mouvlatam.com/api/wallets/balance',
headers={'Authorization': f'Bearer {os.environ["MOUV_API_KEY"]}'}
)
data = res.json()
print(f'Saldo BREB: {data["wallets"][0]["availableCents"]}')
{
"currency": "COP",
"wallets": [
{
"rail": "BREB",
"type": "FAST",
"availableCents": "5000000",
"pendingOutCents": "0",
"totalCents": "5000000",
"version": 12,
"maxTransferAmount": 4900000
},
{
"rail": "ACH",
"type": "ACH",
"availableCents": "138305296",
"pendingOutCents": "0",
"totalCents": "138305296",
"version": 47,
"maxTransferAmount": 137000000
}
],
"consolidated": {
"availableCents": "143305296",
"pendingOutCents": "0",
"totalCents": "143305296",
"currency": "COP"
}
}
Retorna el saldo de ambas wallets (BREB + ACH) y el consolidado.
Scope requerido:
READ
Headers
| Header | Valor |
|---|---|
Authorization | Bearer mvk_... |
Response 200
string
Siempre
"COP" (Mouv solo opera pesos colombianos en V1)array
Array de wallets disponibles para tu empresa
Show Schema de wallet
Show Schema de wallet
string
"BREB" o "ACH" — campo semántico público (recomendado)string
"FAST" o "ACH" — legacy/interno, mantener por backward compatstring
Saldo disponible en centavos (BigInt-safe string). Dividí por 100 para pesos.
string
Fondos reservados por transferencias
PENDING (centavos)string
availableCents + pendingOutCents (centavos)number
Optimistic-locking version — incrementa con cada movimiento
number
Máximo que podés enviar incluyendo fee + IVA (centavos enteros)
object
Ejemplo
curl -X GET https://consola.mouvlatam.com/api/wallets/balance \
-H "Authorization: Bearer mvk_a1b2c3d4..."
const res = await fetch('https://consola.mouvlatam.com/api/wallets/balance', {
headers: { 'Authorization': `Bearer ${process.env.MOUV_API_KEY}` },
});
const data = await res.json();
console.log('Saldo BREB:', data.wallets.find(w => w.rail === 'BREB').availableCents);
console.log('Saldo ACH:', data.wallets.find(w => w.rail === 'ACH').availableCents);
console.log('Total:', data.consolidated.availableCents);
import requests
res = requests.get(
'https://consola.mouvlatam.com/api/wallets/balance',
headers={'Authorization': f'Bearer {os.environ["MOUV_API_KEY"]}'}
)
data = res.json()
print(f'Saldo BREB: {data["wallets"][0]["availableCents"]}')
{
"currency": "COP",
"wallets": [
{
"rail": "BREB",
"type": "FAST",
"availableCents": "5000000",
"pendingOutCents": "0",
"totalCents": "5000000",
"version": 12,
"maxTransferAmount": 4900000
},
{
"rail": "ACH",
"type": "ACH",
"availableCents": "138305296",
"pendingOutCents": "0",
"totalCents": "138305296",
"version": 47,
"maxTransferAmount": 137000000
}
],
"consolidated": {
"availableCents": "143305296",
"pendingOutCents": "0",
"totalCents": "143305296",
"currency": "COP"
}
}
Caching
El response incluyeCache-Control: private, max-age=10. Cacheá 10s en tu cliente para reducir tráfico — la wallet no cambia más rápido que cada movimiento, y los movimientos invalidan tu cache vía signal aplicacional (response.version increment).