1. Inicio rápido
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
    • Funcionalidades por modelo de negocio
    • Marcas de tarjeta soportadas
    • Pagos en un paso
      • Cargo directo (sin token)
      • Códigos de error autenticación OTP
      • ¿Cómo funcionan los pagos con tarjeta?
      • Acepta un pago con tarjeta
      • Acepta pagos únicos con 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?
    • Pagos con Webpay Plus
      • Reserva fondos con Webpay Plus
    • Pagos con Apple Pay
      • Pruebas en Sandbox Apple Pay
      • Configuración de Apple Pay
    • Devoluciones
      • Devoluciones, anulaciones y reembolsos
    • Autenticación 3DS
      • Introducción a 3DS
      • Integración 3DS API + librería kushki.js
      • Integración 3DS con librería kushki.js
      • Integración 100% API de 3DS
      • Códigos de error autenticación 3DS
  • Pagos recurrentes con tarjeta (Online)
    • Autentica tus suscripciones con 3DS
    • Apple Pay en Suscripciones
    • 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 recurrente
      • ¿Cómo funcionan los cargos recurrentes con tarjeta?
    • Pagos calendarizados con Webpay OneClick
      • Reserva fondos en recurrencias con Webpay OneClick
      • Recurrencias con Webpay OneClick
    • Pagos OneClick con Webpay OneClick
      • Pagos one click con Webpay OneClick
      • Reserva fondos en pagos one click con Webpay OneClick
    • Pagos OneClick
      • ¿Cómo funcionan los pagos OneClick con autorización y captura?
      • Recibe pagos OneClick con autorización y captura
      • Genera pagos one click
  • Pagos con tarjeta presente
    • Acepta pagos con tarjeta presente
    • Datos de prueba
    • Webhooks para tarjeta presente
    • 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
    • Transacciones
      • Anula un pago
      • Transacciones
    • Kushki One
      • 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
      • Procesa un cobro
      • Devoluciones y PreAuth & Capture
      • Pago Dividido en la terminal
      • Configuración del terminal
      • Consulta tus transacciones
  • Pagos con transferencias
    • Recibe transferencias bancarias
    • 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
    • Puntos de recaudo
    • Códigos de error para transacciones declinadas en efectivo
  • 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
  • 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
      • Webhook para pagos con Webpay Plus
    • Webhooks para pagos recurrentes
      • Webhook para pagos recurrentes con tarjeta
      • Webhook para pagos recurrentes con Webpay OneClick
    • Webhooks para dispersiones
      • Webhook para dispersión de dinero con transferencia
    • Webhooks para botón de pagos
      • Webhooks con Botón de pago
    • Webhooks para smartlinks
      • Webhooks con Smartlinks
    • 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. Inicio rápido

Preguntas frecuentes

Revisa respuestas rápidas a preguntas que comúnmente aparecen

¿Cómo puedo obtener una cuenta de prueba?#

Puedes solicitar una cuenta de prueba desde nuestra página web. Una vez aceptada tu solicitud, por medio de esta cuenta puedes acceder a la consola: un panel en línea desde el que podrás administrar tu integración con Kushki.

Tengo una integración para varios países, ¿Puedo usar la misma cuenta de prueba?#

Si estás desarrollando una integración para varios países, te recomendamos que solicites una cuenta para cada uno de ellos. De esta manera, podrás hacer pruebas con la configuración y la moneda local.

¿Kushki permite procesar tarjetas internacionales?#

Kushki permite procesar tarjetas internacionales en ciertos casos. Comunícate con tu ejecutivo comercial o visita nuestro Centro de Soporte para obtener más información sobre cómo hacerlo.

¿Puedo usar mi cuenta de prueba después de obtener mis credenciales de producción?#

Sí, puedes hacerlo. Tu cuenta de prueba no se desactivará una vez que reciba las credenciales de producción.

¿Qué debo hacer una vez finalice mi integración?#

Se requiere una certificación técnica. Pónte en contacto con nosotros para agendar una sesión de certificación en la cual realizaremos algunas pruebas para verificar que tu integración se comporta según lo esperado.

¿Qué es la tokenización?#

La tokenización es un proceso en el que Kushki transforma los datos sensibles del cliente en un código alfanumérico llamado token. Al utilizar este token, no es necesario gestionar directamente estos datos, por lo que puedes realizar una transacción de forma segura.

¿El token caduca?#

Sí, expira. Un token tiene una vida útil de 30 minutos y sólo puede ser usado una vez.

¿Tiene Kushki un formulario ya diseñado para que el cliente introduzca la información de pago?#

Sí, se llama Cajita. Si importas Cajita en tu frontend tendrás un formulario prediseñado. El formulario cambiará dependiendo del método de pago.

¿Puedo diseñar mi propio formulario de frontend?#

Sí, puedes hacerlo. Eres libre de diseñar tu propio formulario con los colores y logotipos de tu elección. Después de obtener los datos de tu cliente, sólo tienes que solicitar el token usando una de las bibliotecas de frontend de Kushki. Revisa nuestras guías web para mayores detalles.

¿Qué tengo que considerar si diseño mi propio formulario para pagos con tarjeta de crédito?#

A continuación una lista de las validaciones necesarias:
Se requiere el nombre del titular de la tarjeta.
El campo de la tarjeta de crédito sólo permite números.
El campo de la tarjeta de crédito permite un máximo de 16 dígitos (podría ser menos).
Se requiere el número de la tarjeta de crédito.
El campo CVV sólo permite números.
El campo CVV permite un máximo de 4 dígitos (podrían ser 3).
Se requiere CVV.
El CVV está enmascarado, por lo que no se puede leer, sustituyendo cada carácter por símbolos como asteriscos (*) o puntos (-).
La fecha de caducidad es una fecha válida (mes y año actual o futuro).
Se requiere una fecha de caducidad.
El botón de Pagara se desactiva después del primer clic.

Si uso Cajita, ¿tengo que llamar al token?#

No es necesario. Cajita ya tiene la lógica de tokenización implementada. Después de hacer clic en el botón de Pagar, Cajita te entregará el token.

¿Puede Kushki enviar la confirmación de pago a mi servicio?#

Sí, es posible. Te ofrecemos notificaciones a través de Webhooks. Revisa nuestras guías al respecto.

¿Cómo puedo configurar la URL de mi Webhook en Kushki?#

Por favor, ponte en contacto con nosotros y proporciona a nuestro equipo la URL de tu servicio junto con el Id público de tu comercio.

¿Cuáles son los requisitos para que mi Webhook reciba la notificación?#

Tu Webhook necesita ser capaz de recibir solicitudes POST. También es importante tener un certificado SSL. Si recibes la notificación correctamente, por favor envía un código de estado 200 como respuesta.

¿Qué pasa si mi Webhook se cae temporalmente?#

Si recibimos una respuesta incorrecta cuando tratemos de notificar a tu servicio, intentaremos de nuevo cada 5 minutos durante las 5 horas posteriores al reporte inicial.
Modificado en 2026-10-21 16:28:14
Anterior
Inicio rápido
Siguiente
Paso a producción
Built with