1. Inicio rápido
Kushki Docs
Español
  • Español
  • English
  • Inicio
  • Inicio rápido
    • Últimas novedades
    • Preguntas frecuentes
    • Paso a producción
    • Política de cambios importantes del API
    • Datos de prueba
    • 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
    • Guía de integración Comisiones a terceros
    • ¿Cómo funcionan las Comisiones a terceros?
    • 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
    • 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
      • ¿Cómo funcionan los cargos recurrentes con tarjeta?
      • Maneja tus cargos calendarizados
      • Crea un cargo recurrente
    • Pagos OneClick
      • Genera pagos one click
      • Recibe pagos OneClick con autorización y captura
      • ¿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
    • Cloud Terminal API
      • Acepta pagos
      • Anula una solicitud de pago
      • Consulta el estado de una petición de cobro
      • ¿Cómo imprimir un ticket personalizado?
    • App-to-app
      • Acepta pagos
    • Transacciones
      • Anula un pago
      • Transacciones
    • Terminal SDK
      • Acepta pagos
    • 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
    • Raw card-present API
      • Acepta pagos
      • Script de ejemplo para cifrar información
      • Intercambio de claves criptográficas
      • Preguntas frecuentes
      • Códigos de error para transacciones con tarjeta presente
    • Kushki One App de Pagos
      • Devoluciones y PreAuth & Capture
      • Procesa un cobro
      • Pago Dividido en la terminal
      • Consulta tus transacciones
      • Configuración del terminal
  • Pagos con transferencias
    • Bancos y detalles de operación para pagos con transferencia bancaria
    • Recibe transferencias bancarias
    • Consulta el estado de una transacción
  • Dispersión de dinero
    • Transferencia bancaria
      • Dispersa a cuentas bancarias
      • Códigos de error para dispersiones por transferencia
  • Plugins
    • Shopify
      • Operación del Plugin
    • 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 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 pagos recurrentes
      • Webhook para pagos recurrentes con tarjeta
    • 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-09-21 16:14:32
Anterior
Últimas novedades
Siguiente
Paso a producción
Built with