Skip to main content

​
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>"
    }
}
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:
CategoriaDescripcion
118 - ResourceValidationErrorLos errores de validación de campos
121 - ResourceNotFoundErrorLos errores relacionados con referencias inválidas, por ejemplo, ID de participante inválido
123 - DomainRuleViolationErrorTodas las reglas de negocio, por ejemplo, el tiempo después del cual se puede volver a utilizar una clave cancelada
136 - ApiErrorTodos los errores técnicos, por ejemplo, problemas relacionados con una configuración inválida
100 - ForbiddenErrorLos errores de seguridad
Mapeo de Errores MOL
MOL Error**Transfiya Error code ****Transfiya Error Message **
800MOL ERROR: General MOL error
U101801MOL ERROR U101: Tenant ID not found
U103802MOL ERROR U103: Tenant undefined validation
U106803MOL ERROR U106: Transaction not found
U112804MOL ERROR U112: Amount exceeds the maximum allowed
U119805MOL ERROR U119: Session error
U120806MOL ERROR U120: Inbound channel signed out
U122807MOL ERROR U122: Target participant not active
U125808MOL ERROR U125: Source participant not configured in the system
U126809MOL ERROR U126: Target participant not configured in the system
U173810MOL ERROR U173: Spbvi timeout error.
U194811MOL ERROR U194: Insufficient funds
U212812MOL ERROR U212: Message sent by an inappropiate channel
U250813MOL ERROR U250: The key type must be one of those registered in the global dictionary
U801814MOL ERROR U801: The participant cannot be determined
U804815MOL ERROR U804: Keys not found or inactive
U805816MOL ERROR U805: Keys suspended by customer
U806817MOL ERROR U806: Key already registered by the same financial entity but different account number
U807818MOL ERROR U807: Key registered by another financial entity
U808819MOL ERROR U808: Key already registered with same account number
U809820MOL ERROR U809: You do not have sufficient privileges to perform this operation.
U811821MOL ERROR U811: Key suspended by participant
U908822MOL ERROR U908: Invalid transaction. One or both participants are locked
B001823MOL ERROR B001: Source bank timeout
B002824MOL ERROR B002: Target bank timeout
B101825MOL ERROR B101: Target account validation error
B102826MOL ERROR B102: Source account validation error
B103827MOL ERROR B103: Target id error
B104828MOL ERROR B104: Target payment method error
B105829MOL ERROR B105: Target account not found
B106830MOL ERROR B106: Fraud detection control
B107831MOL ERROR B107: Exceeds maximum low amount deposits
B108832MOL ERROR B108: Exceeds spbvi maximum amount
B109833MOL ERROR B109: Exceeds target bank maximum amount
B301834MOL ERROR B301: Source spbvi timeout
B302835MOL ERROR B302: Target spbvi timeout
⌘I