Saltar al contenido principal
Migo Docs

Consulta de cuenta

El servicio cr-accounts expone los datos de la cuenta de crédito del usuario y el envío del OTP de cuenta.

Consultar datos de cuenta​

POST v2/credits/accounts/
Authorization: <token>
Content-Type: application/json
Body
{
"bank": "bam",
"trxUID": "txn-xyz",
"user": { "type": "document", "value": "1234567890101" }
}

Requerido: bank. Además se requiere al menos uno: trxUID o user.value.

Respuesta (AccountOutput)
{
"success": true,
"data": {
"account": "ACC-123456",
"name": "Juan Pérez",
"balance": 1500.0,
"currency": "GTQ",
"approvedAmount": 5000.0,
"usedAmount": 3500.0,
"bank": "Banco X",
"payment": { "amount": 250.0, "paymentDate": "2026-02-01" },
"buy": { "amount": 1000.0, "paymentDate": "2026-02-15" }
}
}

Errores: 6000 (falta trxUID/user.value, o validaciones de transacción/usuario), 6003 (cuenta no encontrada).

Enviar OTP de cuenta​

POST v2/credits/accounts/otp
Authorization: <token>
Content-Type: application/json
Body
{
"trxUID": "txn-xyz",
"account": "ACC-123456"
}

Requeridos: trxUID, account.

Respuesta
{ "success": true, "data": { "device": "****5678" } }

device es el teléfono enmascarado al que se envió el OTP. Errores: 6000.

Webhook de actualización de cuenta​

El banco notifica de forma asíncrona los cambios de la cuenta (amortización o mora). Este endpoint no pasa por el TOKEN Authorizer.

POST v2/credits/webhooks/banks/{bank}/accounts/updates
Content-Type: application/json
Body (banco → Migo)
{
"account": "ACC-123456",
"notificationType": "delinquencyUpdate",
"changes": {
"interest": 12.5,
"inDefault": true,
"daysOverdue": 35,
"debtAmortization": 0,
"transaction": "txn-xyz",
"transactionStatus": "delinquency",
"overdueAmount": 450.0,
"timestamp": "2026-02-20T10:00:00Z"
}
}

notificationType ∈ debtAmortization | delinquencyUpdate. Ver Webhooks y notificaciones para el resto de eventos.