Saltar al contenido principal
Migo Docs

Usuarios y pre-calificados

El servicio cr-users gestiona la identidad del usuario de crédito. La creación es idempotente por número de documento: si ya existe un usuario con el mismo documento, se retorna el existente sin duplicar.

Crear usuario​

POST v2/credits/users/
Authorization: <token>
Content-Type: application/json
Body
{
"firstName": "Juan",
"lastName": "Pérez",
"document": { "type": "DPI", "number": "1234567890101", "expiration": "2030-01-01" },
"dateOfBirth": "1990-05-20",
"gender": "male",
"userAddress": {
"address": "Zona 10, Ciudad de Guatemala",
"department": "Guatemala",
"city": "Guatemala",
"country": "GT"
},
"middleName": "Carlos",
"secondSurname": "López",
"maritalStatus": "single",
"nationality": "GT",
"taxId": "1234567-8"
}

Requeridos: firstName, lastName, document.type, document.number, dateOfBirth (YYYY-MM-DD), gender (male | female), userAddress (con address, department, city). Opcionales: middleName, extraName, secondSurname, marriedName, maritalStatus, nationality, taxId, document.expiration, userAddress.country.

Respuesta exitosa
{
"success": true,
"data": {
"userId": "a1b2c3d4-...",
"documentType": "DPI",
"documentNumber": "1234567890101",
"status": "CREATED",
"createdAt": "2026-01-01T10:00:00.000Z"
}
}

Errores: 6010 (faltan datos), 6014 (fecha de nacimiento o expiración inválida), 6015 (género inválido).

Consultar usuario​

GET v2/credits/users/{userUID}
Authorization: <token>
Respuesta
{
"success": true,
"data": {
"userId": "a1b2c3d4-...",
"documentType": "DPI",
"documentNumber": "1234567890101",
"status": "ACTIVE",
"createdAt": "2026-01-01T10:00:00.000Z"
}
}

Errores: 6001 (parámetro userUID faltante o usuario no existe).

Pre-calificados​

Usuarios pre-aprobados antes de completar el onboarding bancario.

Crear pre-calificado​

POST v2/credits/users/pre-qualifieds
Authorization: <token>
Content-Type: application/json
Body
{
"code": "PQ-001",
"customer": "miComercio",
"bank": "bam",
"name": "Juan Pérez",
"phone": "50212345678"
}

Requeridos: code, customer, bank, name, phone.

Respuesta exitosa
{
"success": true,
"data": {
"id": "665f...",
"code": "PQ-001",
"phone": "50212345678",
"name": "Juan Pérez",
"customer": "miComercio",
"bank": "bam",
"status": "CREATED"
}
}

Errores: 6010 (faltan datos o error al crear/actualizar).

Consultar pre-calificado​

GET v2/credits/users/pre-qualifieds/{code}
Authorization: <token>

Devuelve un arreglo de pre-calificados que coinciden con el code. Errores: 6010 (no encontrados).

Siguiente paso: afiliar al usuario a una entidad financiera.