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.