Códigos de error para dispersiones por transferencia

28 agosto 2024

Aprende sobre errores comunes en dispersiones de dinero por transferencia

Al realizar una petición de dispersión de dinero por transferencia podrás consultar el estatus de la transacción por medio del endpoint de Get Status o a través de un webhook. En caso de haber un problema para completar la dispersión, recibirás un código de error así como un mensaje con la información del error. Los campos que recibirás en la respuesta serán los siguientes:

"responseCode": "086",
"responseText": "Solo permite abonos a cuenta AFC"

Procesamiento por Transfiya

A continuación te mostramos los códigos que podrías recibir al procesar por Transfiya.

Código de error	Descripción
000	Transacción aprobada
001	Error inesperado del servidor
002	El token proporcionado no tiene permiso para realizar la operación
003	Operación rechazada por Transfiya en AccessToken
004	Las etiquetas del objeto no existen o son inválidas
005	La transferencia o la fuente de la acción es inválida
006	Hubo un error con el procesador
007	Error sobre la configuración en alguna entidad
008	La transferencia o el destino de la acción es inválida
009	Símbolo o dirección no válidos
010	Monto inválido
011	Tipo de acción no compatible con la fuente y/o el destino proporcionados.
012	El hash de acción no es válido
013	Error de validación del esquema
014	Tiempo de espera expirado
015	El recurso no existe en el sistema
016	El recurso existe, tratando de crear un recurso duplicado
017	Una transferencia excede las reglas de negocio configuradas
018	Se intentó procesar una transferencia que ya ha sido procesada
019	Intentar firmar una acción que no está en el estado PENDIENTE
020	La transferencia está en un estado no válido para la solicitud en cuestión
021	Transferencia rechazada debido a la incorporación
022	Error predeterminado en el libro mayor que no está mapeado
023	La fecha límite definida por el encabezado x-minka-deadline se excede en la cadena de solicitudes
024	Utilizado para casos de dinero de búsqueda no resueltos
025	Demasiadas solicitudes enviadas dentro del plazo.
026	Par de teclas no válido mapeado de 141 direcciones-publickey-desajuste
027	Se usa cuando falta iou hash o no coincide con el hash recalculado
028	Se utiliza cuando la acción iou no es compatible
029	Se utiliza cuando se detecta una dirección de firmante no válida en la fuente o el objetivo de un iou
030	Se usa cuando no se encuentran claves públicas para verificar si la dirección coincide
031	Se usa cuando se encuentra una firma con un formato no válido
032	Se utiliza cuando una firma más requerida no está presente
033	Se usa cuando un Iou recibido tiene un hash duplicado a un Iou existente. Esto generalmente indica que un Iou fue enviado por error varias veces
034	Se usa cuando una Transacción recibida tiene un hash duplicado para una Transacción existente
035	El servicio no está disponible debido al mantenimiento
036	El servicio no está disponible
037	Tiempo de transferencia expirado
038	La fuente ha rechazado la transferencia
039	El objetivo ha rechazado la transferencia
040	Acceso a datos inválidos en el banco
041	La información de transferencia es inválida
042	El usuario abandonó la transacción en el banco
043	Cuenta de embargo
044	Cuenta inactiva
045	Cuenta cancelada
046	La cuenta no existe
047	La cuenta no esta habilitada
048	La cuenta no ha sido asignada
049	Cuenta liquidada
050	El usuario excede el límite transaccional autorizado por el banco
051	El banco no esta disponible
052	Fondos insuficientes
053	Los datos transaccionales no son consistentes
054	La entidad financiera no confirma el estado de la transacción
055	Transacción no incluida en el banco
056	La transferencia fue marcada como fraude
057	El usuario no tiene pagos TIN habilitados
058	El estado de la transacción cambió
059	Transacción declinada por fraude
060	El navegador utilizado por el usuario no es compatible con TIN
061	Usuario no muestra ninguna actividad en TIN (timeout)
062	El banco no acepta la inicialización de la transacción
063	Limite de la transacción excedido por el usuario
064	No se pudo conectar con la entidad financiera
065	Plazo de la transacción excedido
066	Ocurrió un error inesperado al llamar a la entidad financiera
067	Llamada a la api inválida desde el banco o el banco devolvió una respuesta inválida
068	No se pudo obtener una respuesta válida de un servicio de destino
069	El servidor no está preparado para manejar la petición. Las causas más comunes son que el servidor esté inactivo por mantenimiento o sobrecargado.

Procesamiento por otros procesadores

A continuación te mostramos los códigos que podrías recibir al procesar por otros procesadores.

Código de error	Descripción
052	Número de cuenta inválido
079	Cuenta Cancelada
078	Cuenta bloqueada
080	Cuenta destino inválida
081	Trans a la misma cuenta
045	Fondos insuficientes
068	Monto Inválido
082	Cuenta embargada
083	Cuenta saldada
68	Monto Inválido
084	Cuenta no vigente
085	Cuenta corriente no existe
086	Solo permite abonos a cuenta AFC
087	Cuenta bloqueada por fallecimiento
069	Producto Inválido
070	Tipo de cuenta inválido
067	NIT inválido
071	Valor de traslado inválido
072	Banco no habilitado
088	Cuenta no existe
073	Transacción no permitida
089	Cuenta oficial activa
69	Producto Inválido
074	Banco o cuenta no inscrita
075	Clase de cuenta inválida
076	Error al efectuar el pago
002	Ha ocurrido un error inesperado
090	Cuenta no habilitada
091	Cuenta con bloqueo transaccional
041	Ocurrió un error en el sistema y tu pago no pudo ser procesado. Por favor, vuelve a intentarlo
077	Pendiente respuesta de otros bancos