GENERAL: No pertenecen a un módulo específico o que son comunes a toda la API.
| Código | Mensaje | Categoría | Recomendación |
|---|---|---|---|
| ML000 | Operación completada con éxito. | GENERAL | |
| ML001 | Error: se ha producido un error, contacte con el administrador | GENERAL | Reintenta la operación. Si el error persiste, revisa los logs del sistema o contáctanos para una revisión técnica. |
| ML004 | Error: El parámetro ingresado es inválido o ya fue procesado anteriormente. | GENERAL | Verifica que el parámetro enviado cumpla con el formato esperado y no haya sido usado previamente. Evita enviar valores duplicados o fuera de especificación. |
| ML006 | Error: El recurso solicitado no ha sido encontrado | GENERAL | El recurso no se pudo encontrar debido al identificador proporcionado, verifica tus datos. |
AUTH: Errores relacionados con la autenticación y autorización de usuarios.
| Código | Mensaje | Categoría | Recomendación |
|---|---|---|---|
| ML101 | Error: validando las credenciales | AUTH | Verifica que el usuario y la contraseña ingresados sean correctos. |
| ML102 | Error: usuario desactivado | AUTH | Contacta con soporte para reactivar la cuenta. |
PM: Errores relacionados con la gestión de métodos de pago.
| Código | Mensaje | Categoría | Recomendación |
|---|---|---|---|
| ML201 | Error: hubo un error al validar la tarjeta de la empresa | PM | Verifica que los datos de la tarjeta corporativa estén completos y sean válidos (número, fecha, CVV, nombre del titular). |
| ML202 | Error: hubo un error al validar tarjeta del tercero. | PM | Asegúrate de que la tarjeta ingresada esté activa y no tenga restricciones bancarias o límites de uso. |
| ML203 | Error: hubo un error al validar la tarjeta | PM | Verifica que el número de tarjeta sea válido y cumpla con el formato esperado (longitud, Luhn, etc.). |
| ML204 | Error: la verificación del CVV falló | PM | Asegúrate de que el código de seguridad (CVV) ingresado sea correcto. |
| ML205 | Error: tarjeta expirada | PM | Revisa la fecha de expiración de la tarjeta. Usa una tarjeta que esté vigente. |
| ML206 | La tarjeta no tiene permisos para operar con la operación solicitada. | PM | Validar las restricciones impuestas por el emisor, la configuración del producto o las reglas del esquema para este tipo de transacción. Se recomienda verificar las condiciones de uso de la tarjeta con la entidad emisora. |
| ML207 | La tarjeta ya se encuentra asociada al cliente | PM | No es necesario registrar en método de pago, ya que, está asociado al usuario definido, se recomienda reutilizarlo |
Bloqueos y Restricciones (Forbidden - 403)**
Estos códigos de respuesta indican que la operación no puede continuar debido a un bloqueo temporal o permanente asociado a la compañía, el usuario, la tarjeta o el método de pago.
| Código | HTTP Status | Categoría | Mensaje (ES) | Mensaje (EN) |
|---|---|---|---|---|
| ML020 | 403 FORBIDDEN | GENERAL | Las operaciones con tarjeta se encuentran temporalmente bloqueadas para esta compañía. | Card operations are temporarily blocked for this company. |
| ML021 | 403 FORBIDDEN | GENERAL | Las operaciones con cuenta se encuentran temporalmente bloqueadas para esta compañía. | Account operations are temporarily blocked for this company. |
| ML022 | 403 FORBIDDEN | GENERAL | El usuario se encuentra bloqueado y no puede continuar con la operación. | The user is blocked and cannot continue with the operation. |
| ML023 | 403 FORBIDDEN | GENERAL | La tarjeta (BIN) se encuentra bloqueada para este tipo de operación. | The card (BIN) is blocked for this type of operation. |
| ML024 | 403 FORBIDDEN | GENERAL | El método de pago se encuentra bloqueado y no puede continuar con la operación. | The payment method is blocked and cannot continue with the operation. |
TRANSACTION: Errores que ocurren durante la creación, validación o procesamiento de transacciones financieras.
| Código | Mensaje | Categoría | Recomendación |
|---|---|---|---|
| ML300 | Transacción completada con éxito, | TRANSACTION | También puede ser el código ML000 |
| ML301 | Error: validando la transacción | TRANSACTION | Verifica que todos los campos requeridos de la transacción estén presentes y con formato válido (monto, moneda, identificadores, etc.). |
| ML302 | Error: validando las transacciones | TRANSACTION | Revisa el conjunto de transacciones enviadas. Asegúrate de que cada una tenga los datos completos y que no existan duplicados o inconsistencias. |
| ML303 | Error: validando el monto de la transacción | TRANSACTION | Asegúrate de que el monto esté presente, sea un número válido y cumpla con los límites permitidos para la operación. |
| ML304 | Error: no se encontró una transacción asociada a la referencia dada | TRANSACTION | Verifica que la referencia enviada sea correcta y exista en el sistema. Puede estar mal escrita o no haber sido registrada previamente. |
| ML305 | Error: la transacción no pudo ser procesada. Verifica los datos e intenta nuevamente | TRANSACTION | Revisa todos los datos enviados en la solicitud (monto, método de pago, destinatario, etc.). |
| ML306 | Error: Fondos insuficientes en la cuenta. | TRANSACTION | Valida el saldo disponible en la cuenta de origen. Asegúrate de tener los fondos necesarios antes de intentar nuevamente. |
| ML307 | Error: Problema con la información del destinatario. Por favor valide e intente nuevamente | TRANSACTION | Revisa todos los datos enviados en la solicitud (monto, método de pago, destinatario, etc.). |
| ML338 | La transacción no puede ser cancelada en su estado actual. | TRANSACTION | Si la transacción ya fue completada, rechazada o cancelada previamente, no será posible realizar la cancelación. |
TRANSACTION: Errores relacionados con el bloqueo de transacciones como resultado de validaciones, restricciones de configuración o límites operativos.
| Código | Mensaje | Descripción |
|---|---|---|
| MT101 | Comercio de origen bloqueado. | El comercio/sender de origen está bloqueado |
| MT102 | Comercio de origen inactivo. | El comercio/sender de origen está inactivo. |
| MT103 | Comercio de origen cerrado. | El comercio/sender de origen está cerrado. |
| MT104 | Producto de origen bloqueado. | El producto o método de pago del sender está bloqueado. |
| MT105 | Comercio de destino bloqueado. | El comercio/receptor de destino está bloqueado. |
| MT106 | Comercio de destino inactivo. | El comercio/receptor de destino está inactivo. |
| MT107 | Comercio de destino cerrado. | El comercio/receptor de destino está cerrado. |
| MT108 | Producto de destino bloqueado. | El producto o método de pago del receptor está bloqueado. |
| MT118 | Compañía bloqueada. | La compañía está bloqueada. |
| MT119 | Compañía inactiva. | La compañía está inactiva |
| MT120 | Compañía cerrada. | La compañía está cerrada. |
| MT125 | Se superó el límite de transacciones. | Se ha superado el número máximo de transacciones permitidas, ya sea por día, semana o mes. |
| MT126 | Se superó el límite de monto. | Se ha superado el monto máximo permitido, ya sea por día, semana, mes o por transacción. |
| MT127 | Reglas no creadas. | No existen reglas configuradas para la compañía o no se detectaron reglas de límites. |
| MT132 | Entradas del Bin emisor bloqueadas para la compañia. | El BIN emisor tiene bloqueadas las transacciones de entrada. |
| MT134 | El país no está habilitado para enviar dinero a la compañía. | País de origen no habilitado |
| MT135 | El país no está habilitado para recibir dinero de la compañía. | País de destino no habilitado |
| MT136 | Transacción bloqueada por rango de fechas restringido. | La transacción cae dentro de un rango de fechas restringido. |
| MT137 | Transacción bloqueada por horario restringido. | La transacción cae dentro de un horario restringido. |
| MT147 | Entradas y salidas del Bin emisor bloqueadas para la compañia. | El BIN emisor tiene bloqueadas tanto entradas como salidas. |
| MT148 | Entradas del Bin receptor bloqueadas para la compañia. | El BIN receptor tiene bloqueadas las transacciones de entrada. |
| MT149 | Salidas del Bin receptor bloqueadas para la compañia. | El BIN receptor tiene bloqueadas las transacciones de salida. |
| MT150 | Entradas y salidas del Bin receptor bloqueadas para la compañia. | El BIN receptor tiene bloqueadas tanto entradas como salidas. |
THIRD : Errores relacionados con la validación, registro o gestión de terceros dentro del sistema. Estos terceros pueden ser clientes o proveedores asociados a una compañía.
| Código | Mensaje | Categoría | Recomendación |
|---|---|---|---|
| ML401 | Error: validando el cliente | THIRD | Asegúrate de que los datos del cliente estén completos y correctos (nombre, documento, tipo, etc.). Verifica el formato y la existencia previa. |
| ML402 | Error: validando el cliente | THIRD | Revisa los campos enviados (nombres, documento, tipo de persona). Verifica que no falte información obligatoria o esté mal estructurada. |
| ML403 | Error: validando la cuenta bancaria del proveedor | THIRD | Verifica que el número de cuenta, banco y tipo de cuenta sean válidos y estén correctamente formateados. |
| ML404 | Error: proveedor desactivado | THIRD | El proveedor está registrado pero inactivo. Reactívalo desde el sistema de administración o registra uno nuevo. |
| ML405 | Error: cliente desactivado | THIRD | El cliente existe pero se encuentra inhabilitado. Valida si debe ser reactivado o sustituido por otro cliente. |
| ML406 | Error: validando el cliente, el documento ya existe | THIRD | Verifica si estás intentando duplicar un registro o si deberías actualizar el existente. |
| ML407 | Error: validando el proveedor, el documento ya existe | THIRD | Verifica si estás intentando duplicar un registro o si deberías actualizar el existente. |
| ML408 | Error: no se encontró un tercero con el ID registrado | THIRD | Asegúrate de que el ID enviado en la solicitud pertenezca a un tercero existente en el sistema. Verifica también que esté bien escrito. |
| ML409 | Error: ya existe un tercero con el documento ingresado | THIRD |
COMPANY:Errores relacionados con entidades tipo “compañía” o “cliente empresarial” dentro del ecosistema de la API.
| Código | Mensaje | Categoría | Recomendación |
|---|---|---|---|
| ML601 | Error: validando la cuenta bancaria de la compañía | COMPANY | Verifica que el número de cuenta, banco, tipo de cuenta y titular estén correctos. Asegúrate de que la cuenta pertenezca a la compañía y esté activa. |
| ML603 | Error: al encontrar la compañía | COMPANY | Verifica que el identificador de la compañía sea válido y que exista en el sistema. Puede haber sido eliminada, inactivada o no registrada. |
FILE: Errores relacionados con carga, validación o procesamiento de archivos enviados a través de la API.
| Código | Mensaje | Categoría | Recomendación |
|---|---|---|---|
| ML701 | Error: al subir archivo | FILE | Asegúrate de que el archivo cumpla con el formato permitido (tipo, tamaño, estructura). Revisa también la conexión y vuelve a intentar la carga. |
| ML702 | Error: al procesar el archivo | FILE | Asegúrate de que el archivo cumpla con el formato permitido (tipo, tamaño, estructura). Revisa también la conexión y vuelve a intentar la carga. |
THIRD_FINANCIAL:Errores relacionados con la validación de identidad (KYC) y la validación de cuentas bancarias.
| Código | Mensaje | Categoría | Recomendación |
|---|---|---|---|
| ML900 | Error: el token es inválido o ha expirado | THIRD_FINANCIAL | Vuelve a generar o solicitar un nuevo token de acceso. Asegúrate de que el token esté dentro de su período de validez. |
| ML901 | Error: tu sesión bancaria ha caducado. Vuelve a conectar tu banco | THIRD_FINANCIAL | Reconecta tu cuenta bancaria para renovar la sesión y asegurar la continuidad de la transacción. |
| ML902 | Error: no se encontró la conexión bancaria. Conéctala nuevamente | THIRD_FINANCIAL | Verifica que la cuenta bancaria esté correctamente conectada. Si es necesario, vuelve a conectar la cuenta. |
| ML903 | Error: has realizado muchas solicitudes. Intenta más tarde | THIRD_FINANCIAL | Asegúrate de no exceder el límite de solicitudes. Espera un momento y vuelve a intentarlo más tarde. |
| ML904 | Error: el banco no está disponible en este momento. Intenta más tarde | THIRD_FINANCIAL | El servicio del banco está temporalmente fuera de línea. Intenta realizar la solicitud nuevamente más tarde. |
| ML905 | Error: esta funcionalidad no está habilitada. Contacta con soporte | THIRD_FINANCIAL | La funcionalidad solicitada no está disponible. Contacta con soporte para obtener más detalles o habilitarla. |
| ML906 | Error: inesperado al conectar con el proveedor financiero | THIRD_FINANCIAL | Reintenta la operación. Si el problema persiste, contacta con el soporte del proveedor para obtener más detalles. |
| ML907 | Error: la solicitud enviada es inválida. Revisa los datos e intenta de nuevo | THIRD_FINANCIAL | Verifica que todos los campos enviados sean correctos y estén completos. Corrige los errores y vuelve a intentarlo. |
| ML908 | Error: tu cuenta fue desconectada por el banco. Debes volver a conectarla | THIRD_FINANCIAL | La conexión con el banco fue interrumpida. Reconecta tu cuenta para continuar con la operación. |
| ML909 | Error: no se pudo procesar la solicitud. Intenta más tarde | THIRD_FINANCIAL | La solicitud no pudo ser procesada en este momento. Espera un momento y vuelve a intentarlo. |
| ML910 | Error: el token de acceso bancario es inválido o ha expirado. Vuelve a conectar tu banco | THIRD_FINANCIAL | Regenera el token de acceso bancario o reconecta tu cuenta bancaria para obtener un nuevo token. |
| ML911 | Error: no se pudo validar tu identidad automáticamente | THIRD_FINANCIAL | Verifica los datos de identidad proporcionados. Si el problema persiste, contacta con soporte para resolverlo. |
| ML912 | Error: en los datos enviados | THIRD_FINANCIAL | Revisa los datos enviados, asegúrate de que sean correctos y vuelve a intentarlo |
| ML913 | Error: no se encontró una validación de identidad con el ID registrado | THIRD_FINANCIAL | Verifica que el ID de validación de identidad sea correcto. |
| ML914 | Error: cuenta bancaria no encontrada | THIRD_FINANCIAL | Verifica que la cuenta bancaria esté registrada y conectada correctamente. |