Errores de MOL

Resumen

Transfiya implementa un sistema de gestión de errores fundamentado en el estándar HTTP, proporcionando una estructura clara y coherente para el manejo de excepciones.Aunque los sistemas externos emplean códigos de error particulares, Transfiya ha desarrollado un mecanismo de mapeo que convierte automáticamente estos códigos a su propia arquitectura estandarizada de errores HTTP. Esta avanzada capacidad de normalización optimiza significativamente el proceso de integración para los participantes del ecosistema, minimizando o incluso eliminando por completo la necesidad de desarrollar lógicas personalizadas para el tratamiento de errores específicos. Los errores de MOL y DICE se incluyen aquí solo con fines de referencia. El participante no necesita mapear errores de DICE directamente. Mensajes de error Transfiya Cuando se produce un error durante una transferencia o en el sistema de MOL, la plataforma responde con códigos de estado HTTP específicos y un objeto de error estructurado que proporciona información detallada sobre la incidencia. El sistema implementa una clasificación estratégica de códigos de error organizados en rangos específicos, facilitando una categorización clara, identificación rápida y resolución eficiente de incidencias. La estructura de errores está distribuida estratégicamente según el tipo de participante afectado:

1xx - Errores de sistema TransfiYa
3xx - Errores de participantes

El sistema Transfiya implementa un protocolo de respuesta estandarizado. Todas las solicitudes procesadas exitosamente hacia la plataforma retornan invariablemente un código de estado HTTP200. Cuando ocurre algún error durante el procesamiento, el sistema devuelve un objeto de error estructurado que contiene un código numérico específico y una descripción clara del problema, facilitando su identificación y resolución.

{
    "error": {
        "code": <error_code>,
        "message": "<error_message>"
    }
}

{
   "error": {
        "code": 307,
        "message": "Inactive account"
  }
}

En el caso de respuestas exitosas, un objeto de error con código 0 se añade a la respuesta original.

Estrategia de mapeo integral TransfiYa implementa validaciones exhaustivas de todos los campos y esquemas según los requisitos regulatorios, lo que mitiga significativamente la posibilidad de que ocurran errores del MOL. No obstante, documentamos estos mapeos de errores como medida preventiva para garantizar una respuesta adecuada ante situaciones excepcionales o imprevistas que pudieran presentarse. La estrategia general de mapeo es la siguiente:

Categoria	Descripcion
`118 - ResourceValidationError`	Los errores de validación de campos
`121 - ResourceNotFoundError`	Los errores relacionados con referencias inválidas, por ejemplo, ID de participante inválido
`123 - DomainRuleViolationError`	Todas las reglas de negocio, por ejemplo, el tiempo después del cual se puede volver a utilizar una clave cancelada
`136 - ApiError`	Todos los errores técnicos, por ejemplo, problemas relacionados con una configuración inválida
`100 - ForbiddenError`	Los errores de seguridad

Mapeo de Errores MOL

Mapeo de Errores MOL

MOL Error	Transfiya Error code	Transfiya Error Message
	800	MOL ERROR: General MOL error
U101	801	MOL ERROR U101: Tenant ID not found
U103	802	MOL ERROR U103: Tenant undefined validation
U106	803	MOL ERROR U106: Transaction not found
U111	846	Monto mínimo de una OP/TFI es 1
U112	804	MOL ERROR U112: Amount exceeds the maximum allowed
U119	805	MOL ERROR U119: Session error
U120	806	MOL ERROR U120: Inbound channel signed out
U122	807	MOL ERROR U122: Target participant not active
U125	808	MOL ERROR U125: Source participant not configured in the system
U126	809	MOL ERROR U126: Target participant not configured in the system
U173	810	MOL ERROR U173: Spbvi timeout error.
U193	800	MOL Error U193: The balance in the Participant’s liquidity account in the MOL is less than or equal to the allowed value.
U194	811	MOL ERROR U194: Insufficient funds
U204	847	Posición de liquidez no encontrada
U212	812	MOL ERROR U212: Message sent by an inappropiate channel
U250	813	MOL ERROR U250: The key type must be one of those registered in the global dictionary
U272	800	MOL ERROR U272: Error due to rules for source or target
U801	814	MOL ERROR U801: The participant cannot be determined
U804	815	MOL ERROR U804: Keys not found or inactive
U805	816	MOL ERROR U805: Keys suspended by customer
U806	817	MOL ERROR U806: Key already registered by the same financial entity but different account number
U807	818	MOL ERROR U807: Key registered by another financial entity
U808	819	MOL ERROR U808: Key already registered with same account number
U809	820	MOL ERROR U809: You do not have sufficient privileges to perform this operation.
U811	821	MOL ERROR U811: Key suspended by participant
U908	822	MOL ERROR U908: Invalid transaction. One or both participants are locked
B001	823	MOL ERROR B001: Source bank timeout
B002	824	MOL ERROR B002: Target bank timeout
B003	838	Time-Out declarado por el Participante Receptor
B004	839	Error técnico en el SPBVI Originador
B005	840	Error técnico en el SPBVI Receptor
B006	841	Error técnico en el Participante Receptor
B009	836	MOL ERROR B009: Payment order arrived out of time at receiving SPBVI
B101	825	MOL ERROR B101: Invalid target customer’s account number
B102	826	MOL ERROR B102: Target account validation error
B103	827	MOL ERROR B103: Target id error
B104	828	MOL ERROR B104: Target payment method error
B105	829	MOL ERROR B105: Target account not found
B106	830	MOL ERROR B106: Fraud detection control
B107	831	MOL ERROR B107: Exceeds maximum low amount deposits
B108	832	MOL ERROR B108: Exceeds spbvi maximum amount
B110	842	Falló autorización en el Participante Receptor
B111	843	Información del SPBVI Originador incompleta
B109	833	MOL ERROR B109: Exceeds target bank maximum amount
B112	837	MOL ERROR B112: Required information missing at receiving SPBVI
B114	845	Código QR no válido
B113	844	Código QR ya fue usado
B301	834	MOL ERROR B301: Source spbvi timeout
B302	835	MOL ERROR B302: Target spbvi timeout

Como empezar

Guias de uso

Acerca de

APIs Banco

APIs Transfiya

Archivos de Soporte

Resumen

​Resumen

​​

Resumen