Códigos de error para dispersiones por transferencia

12 mayo 2026

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": "076",
"responseText": "Error al efectuar el pago."

Cuenta bancaria (ACH)

A continuación, los códigos que puedes recibir en dispersiones a cuenta bancaria:

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

Bre-B

Los errores de Bre-B se agrupan en tres categorías según el momento del flujo en que ocurren.

Errores de validación de la llave

Ocurren durante el paso de tokenización, antes de inicializar la transacción.

Código de error	Descripción
PT060	La llave de pago proporcionada no existe o no es válida
PT001	Cuerpo de la petición inválido
PT057	La moneda enviada es diferente a la definida por el procesador

Errores de procesamiento

Ocurren durante el proceso de transferencia, una vez iniciada la transacción.

Código de error	Descripción
041	Ocurrió un error en el sistema y tu pago no pudo ser procesado. Por favor, vuelve a intentarlo
045	Fondos insuficientes
068	Monto Inválido
071	Valor de traslado inválido
072	Banco no habilitado
073	Transacción no permitida
074	Banco o cuenta no inscrita
076	Error al efectuar el pago
077	Pendiente respuesta de otros bancos
002	Ha ocurrido un error inesperado

Errores del banco receptor

Retornados por el banco del destinatario al intentar acreditar los fondos.

Código de error	Descripción
052	Número de cuenta inválido
067	NIT inválido
070	Tipo de cuenta inválido
080	Cuenta destino inválida
088	Cuenta no existe
091	Cuenta con bloqueo transaccional