1. Transferencia bancaria
Kushki Docs
Español
  • Español
  • English
  • Inicio
  • Inicio rápido
    • Últimas novedades
    • Datos de prueba
    • Preguntas frecuentes
    • Paso a producción
    • Política de cambios importantes del API
    • Códigos de error
  • Glosario de pagos
    • Glosario de pagos
  • Pagos únicos con tarjeta (Online)
    • Network Tokens
    • Marcas de tarjeta soportadas
    • Funcionalidades por modelo de negocio
    • Pagos en un paso
      • Acepta un pago con tarjeta
      • Cargo directo (sin token)
      • ¿Cómo funcionan los pagos con tarjeta?
      • Acepta pagos únicos con OTP
      • Códigos de error autenticación OTP
      • Códigos de error pagos únicos con tarjeta
    • Pagos en dos pasos
      • Recibe pagos con autorización y captura
      • ¿Cómo funcionan los pagos únicos con autorización y captura?
    • Devoluciones
      • Devoluciones, anulaciones y reembolsos
    • Autenticación 3DS
      • Integración 3DS API + librería kushki.js
      • Introducción a 3DS
      • Integración 100% API de 3DS
      • Integración 3DS con librería kushki.js
      • Códigos de error autenticación 3DS
    • Pagos con Apple Pay
      • Configuración de Apple Pay
      • Pruebas en Sandbox Apple Pay
  • Pagos recurrentes con tarjeta (Online)
    • Autentica tus suscripciones con 3DS
    • Suscripciones externas a Kushki
    • Acepta pagos one click con 3DS
    • Funcionalidades por modelo de negocio
    • Códigos de error en cargos recurrentes
    • Pagos calendarizados
      • Maneja tus cargos calendarizados
      • Crea un cargo calendarizado
      • ¿Cómo funcionan los cargos recurrentes con tarjeta?
    • Pagos OneClick
      • Recibe pagos OneClick con autorización y captura
      • Genera pagos one click
      • ¿Cómo funcionan los pagos OneClick con autorización y captura?
  • Pagos con tarjeta presente
    • Acepta pagos con tarjeta presente
    • Datos de prueba
    • Webhooks para tarjeta presente
    • Raw card-present API
      • Introducción a Raw card-present API
      • Script de ejemplo para cifrar información
      • Acepta pagos
      • Intercambio de claves criptográficas
      • Preguntas frecuentes
      • Códigos de error para transacciones con tarjeta presente
    • Kushki One
      • Primeros Pasos
      • Autenticación y Cifrado de Requests
      • Realiza cobros con Kushki One
      • Formato de montos en Kushki ONE
      • Impresión en terminal SmartPOS
      • Catálogo Unificado de Errores — Kushki ONE Connect
      • Servicios asíncronos y webhooks
    • Kushki One App de Pagos
      • Descripción general
      • Devoluciones y PreAuth & Capture
      • Pago Dividido en la terminal
      • Configuración del terminal
      • Procesa un cobro
      • Consulta tus transacciones
    • Transacciones
      • Transacciones
      • Anula un pago
  • Pagos con transferencias
    • Recibe transferencias bancarias
    • Códigos de error para transferencias
    • Consulta el estado de una transacción
    • Bancos y detalles de operación para pagos con transferencia bancaria
  • Pagos en efectivo
    • Acepta un pago en efectivo
    • ¿Cómo funcionan los pagos en efectivo?
    • Puntos de recaudo
    • Códigos de error para transacciones declinadas en efectivo
  • Métodos alternativos de pago (APM)
    • ¿Cómo funcionan los pagos con APM?
    • Acepta pagos con Bre-B
  • Dispersión de dinero
    • Recarga tu saldo para dispersiones
    • Transferencia bancaria
      • Dispersa a cuentas bancarias
      • Dispersa con Bre-B
      • Códigos de error para dispersiones por transferencia
      • ¿Cómo funciona la dispersión por transferencia bancaria?
    • Efectivo
      • Dispersa dinero en efectivo
      • Maneja tus dispersiones
      • ¿Cómo funciona la dispersión por efectivo?
  • Plugins
    • Shopify
      • Shopify
      • Operación del Plugin
    • Vtex
      • Guía de integración VTEX
  • Links de pago
    • Smartlinks
  • Formularios y botones de pago
    • Introducción
    • Kajita
      • Kajitas de pago
      • ¿Cómo funciona?
    • Botón de pago
      • Genera un botón de pago
      • ¿Cómo funciona el botón de pago?
  • Administración de sucursales
    • ¿Cómo realizar el onboarding de subcomercios vía API?
  • Notificaciones
    • Buenas prácticas
    • Consulta tus webhooks
    • Webhooks para pagos únicos
      • Webhook para pagos únicos con tarjeta
      • Webhook para pagos únicos con transferencia bancaria
      • Webhook para pagos únicos con efectivo
    • Webhooks para pagos recurrentes
      • Webhook para pagos recurrentes con tarjeta
    • Webhooks para smartlinks
      • Webhooks con Smartlinks
    • Webhooks para dispersiones
      • Webhook para dispersión de dinero con transferencia
      • Webhook para dispersión de dinero con efectivo
    • Webhooks para botón de pagos
      • Webhooks con Botón de pago
    • Webhooks para devoluciones
      • Webhook para devoluciones
      • Webhook para contracargos
HomeMexico 🇲🇽Ecuador 🇪🇨Chile 🇨🇱Colombia 🇨🇴
Peru 🇵🇪
HomeMexico 🇲🇽Ecuador 🇪🇨Chile 🇨🇱Colombia 🇨🇴
Peru 🇵🇪
Status
Soporte / Support
Español
  • Español
  • English
  1. Transferencia bancaria

Códigos de error para dispersiones por transferencia

Aprende sobre errores comunes en dispersiones de dinero por transferencia

title: Códigos de error para dispersiones por transferencia
slug: /payouts/transfer/error-codes#

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

Errores del banco receptor#

Retornados por el banco del destinatario al intentar acreditar los fondos.
Código de errorDescripción
052Número de cuenta inválido
067NIT inválido
070Tipo de cuenta inválido
080Cuenta destino inválida
088Cuenta no existe
091Cuenta con bloqueo transaccional
Modificado en 2026-10-14 19:40:52
Anterior
Dispersa con Bre-B
Siguiente
¿Cómo funciona la dispersión por transferencia bancaria?
Built with