Saltar al contenido principal
Migo Docs

Catálogo de errores

Todos los errores siguen el envelope universal con un objeto error: { code, name, description, message }. El code proviene del catálogo (MongoDB); el message es el detalle específico que agrega el servicio.

Catálogo de códigos (code)​

CódigoEscenario real
000Excepción no controlada (catch-all del handler). No se registra como error de negocio.
2000Transacción no encontrada o en estado inválido para la operación
2001Config de cliente o de banco no encontrada; transacción no encontrada (cancel/void)
2002Config de banco o cuenta no encontrada (en authorize/capture)
2003Monto inválido / validación de monto / processorAmount inválido / banco sin respuesta
2004Usuario bloqueado; OTP inválido (en autorización de transacción)
5000Error interno; el banco no soporta afiliación
5001Estado de afiliación inválido recibido del banco (webhook)
6000Error de cuenta; faltan parámetros (cuenta/OTP); validaciones de cuenta
6001Usuario no encontrado / parámetro userUID faltante
6002Crédito/saldo insuficiente (validación de usuario de crédito)
6003Cuenta no encontrada
6005Cuenta en mora / default
6010Faltan datos de usuario / afiliación / pre-calificado, o error al crear/actualizar
6011Formato de email inválido (afiliación)
6012Formato de teléfono primario inválido (afiliación)
6013Formato de teléfono secundario inválido (afiliación)
6014Fecha de nacimiento o de expiración del documento inválida
6015Género inválido (debe ser male o female)

Estrategia de reintento​

Cuándo reintentar

Ante 5000 o 000, reintenta con backoff exponencial (1s, 2s, 4s) hasta 3 veces. Los códigos 2xxx / 6xxx son de negocio y no deben reintentarse sin corregir el input.

Para el detalle por endpoint de qué códigos puede devolver cada operación, consulta la referencia interactiva de Créditos Core.