1. Tarjeta
Kushki Docs
Español
  • Español
  • English
  • Inicio
  • Inicio rápido
    • Preguntas frecuentes
    • Paso a producción
    • Política de cambios importantes del API
    • Códigos de error
    • Datos de prueba
    • Últimas novedades
  • 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
      • ¿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
      • Cargo directo (sin token)
      • Acepta un pago con tarjeta
    • Pagos en dos pasos
      • ¿Cómo funcionan los pagos únicos con autorización y captura?
      • Recibe pagos con autorización y captura
    • Devoluciones
      • Devoluciones, anulaciones y reembolsos
    • Autenticación 3DS
      • Integración 100% API de 3DS
      • Integración 3DS con librería kushki.js
      • Códigos de error autenticación 3DS
      • Integración 3DS API + librería kushki.js
      • Introducción a 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
    • Apple Pay en Suscripciones
    • Acepta pagos one click con 3DS
    • Funcionalidades por modelo de negocio
    • Códigos de error en cargos recurrentes
    • Suscripciones externas a Kushki
    • Pagos calendarizados
      • Crea un cargo recurrente
      • Maneja tus cargos calendarizados
      • ¿Cómo funcionan los cargos recurrentes con tarjeta?
    • Pagos OneClick
      • ¿Cómo funcionan los pagos OneClick con autorización y captura?
      • Genera pagos one click
      • Recibe pagos OneClick con autorización y captura
  • Pagos con tarjeta presente
    • Datos de prueba
    • Acepta pagos con tarjeta presente
    • Webhooks para tarjeta presente
    • Raw card-present API
      • Introducción a Raw card-present API
      • Script de ejemplo para cifrar información
      • Intercambio de claves criptográficas
      • Preguntas frecuentes
      • Códigos de error para transacciones con tarjeta presente
      • Acepta pagos
    • Transacciones
      • Anula un pago
      • Transacciones
    • Kushki One
      • Autenticación y Cifrado de Requests
      • Realiza cobros con Kushki One
      • Servicios asíncronos y webhooks
      • Formato de montos en Kushki ONE
      • Catálogo Unificado de Errores — Kushki ONE Connect
      • Primeros Pasos
      • Impresión en terminal SmartPOS
    • Kushki One App de Pagos
      • Descripción general
      • Devoluciones y PreAuth & Capture
      • Pago Dividido en la terminal
      • Configuración del terminal
      • Consulta tus transacciones
      • Procesa un cobro
  • Pagos con transferencias
    • Consulta el estado de una transacción
    • Experiencias de compra y detalles de operación para pagos con transferencia bancaria
    • Recibe transferencias bancarias
  • Pagos en efectivo
    • Puntos de recaudo
    • Códigos de error para transacciones declinadas en efectivo
    • Acepta un pago en efectivo
  • Métodos alternativos de pago (APM)
    • ¿Cómo funcionan los pagos con APM?
    • Acepta pagos con Yape
  • Dispersión de dinero
    • Transferencia bancaria
      • ¿Cómo funciona la dispersión por transferencia bancaria?
      • Códigos de error para dispersiones por transferencia
      • Dispersa a cuentas bancarias
    • Tarjeta
      • ¿Cómo funciona el envío de fondos a tarjetas?
      • Envía dinero a una tarjeta
      • Códigos de error
  • Plugins
    • Shopify
      • Operación del Plugin
      • Shopify
    • Vtex
      • Guía de integración VTEX
  • Links de pago
    • Smartlinks
  • Formularios y botones de pago
    • Kajita
      • Kajitas de pago
      • ¿Cómo funciona?
    • Botón de pago
      • ¿Cómo funciona el botón de pago?
      • Genera un 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 dispersiones
      • Webhook para dispersión de dinero con Transferencia
      • Webhook para dispersión con tarjeta
    • Webhooks para smartlinks
      • Webhooks con Smartlinks
    • 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. Tarjeta

Códigos de error

Esta página enumera los códigos de error y sus significados para el servicio Card Payouts. Estos errores pueden ocurrir durante la tokenización de tarjetas, el envío de fondos o la consulta de transacciones.
Producto en versión beta 🔐👩🏽‍💻
Estamos trabajando en nuestra versión beta. ¡Manténte atento a su lanzamiento oficial! También puedes contactar a tu gerente de cuenta para más información.

Manejo de Errores#

Cuando ocurre un error, la API responderá con un código y detalles adicionales. A continuación, se muestra un ejemplo de una respuesta de error:
{
    "code": "E030",
    "details": {
        "Origin": "AccountInfoMiddleware | getBinInfo",
        "Message": "InvokeLambda has failed"
    },
    "message": "Internal Server Error"
}

Tabla de Códigos de Error#

CódigoMensajeCódigo de Estado HTTP
E004ID de comercio no válido.400 Bad Request
E008Token incorrecto.400 Bad Request
E009El comercio no tiene fondos suficientes.400 Bad Request
E010El procesador no existe.400 Bad Request
E025Tarjeta inválida.400 Bad Request
E040El ID de comercio no corresponde a la credencial enviada.400 Bad Request
E044Marca de tarjeta no soportada.400 Bad Request
E049Token utilizado anteriormente.400 Bad Request
E057La moneda enviada es diferente a la definida por el procesador.400 Bad Request
E228Procesador inalcanzable.500 Internal Server Error
E701Ocurrió un error al enviar la petición HTTP.500 Internal Server Error
E702Ocurrió un error al enviar la transacción a la franquicia.500 Internal Server Error
E704Ocurrió un error al consultar la transacción con la franquicia.500 Internal Server Error
E705Ocurrió un error al consultar la transacción.500 Internal Server Error
E706Transacción no encontrada.404 Not Found
E707ID de transacción no válido.400 Bad Request
E708Ocurrió un error al consultar el servicio de validación de tarjeta.500 Internal Server Error
E709El token ingresado pertenece a otro comercio.400 Bad Request
E710El campo paymentType enviado no es válido.500 Internal Server Error
E711Ocurrió un error al guardar el token.500 Internal Server Error
E712El ID de la suscripción no es válido.400 Bad Request
E713El token de la suscripción ya ha sido eliminado previamente.400 Bad Request
E714Ocurrió un error al actualizar la suscripción.500 Internal Server Error
E715El comercio no posee configuración PCI.400 Bad Request
E030Fallo en la ejecución de InvokeLambda.500 Internal Server Error

Errores E027 y E70#

En caso de que recibas un error E027:
E027: {
    Code:       E027.String(),
    Message:    "Ocurrió un timeout al enviar la petición a la franquicia.",
    StatusCode: errors.RequestTimeout,
}
O un error E703:
E703: {
        Code:       E703.String(),
        Message:    "Estado de la transacción desconocida.",
        StatusCode: errors.InternalServerError,
}
Antes de realizar cualquier reintento, debes esperar al menos 1 minuto después de haber recibido el error y consultar el estado final de la transacción utilizando el método Get transaction status.
Modificado en 2026-10-21 19:53:37
Anterior
Envía dinero a una tarjeta
Siguiente
Plugins
Built with