Genera pagos one click
Web
iOS
Android
Importante
¿Cómo funciona?
1. Inscripción
Configura tu front-end
Kushki.js
Opción 1 - CDN
script al final del <body> en tu página de pagos.Opción 2 - NPM
Configura el objeto Kushki
Recoge la información del usuario y envíala a tu back-end
Muestra las opciones de diferidos de acuerdo al BIN de la tarjeta de tu cliente (Opcional)
type, los meses disponibles y los meses de gracia (skip payments), tal como se muestra en el siguiente ejemplo de respuesta. Para ejecutar el cargo deberás usar solo months. {
type: "all",
months: ["2", "3", "4", "5", "6", "7"],
monthsOfGrace: []
}Importante
deferred cuando inicies el proceso de cobro con Kushki.Kushki.js Hosted Fields
Importa Kushki.js Hosted Fields en tu aplicación
Opción 1 - CDN
<script> dentro de la etiqueta <body>. Una vez importada, podrás acceder a los recursos descritos a continuación para crear un flujo de pago con Kushki.kushki.min.js (la cuál trae el código necesario para almacenar las credenciales de tu comercio) como la biblioteca card.min.js (módulo el cuál trae las funcionalidades necesarias para el flujo de pagos con tarjeta).Opción 2 - NPM
Opción 3 - YARN
Crea una instancia de KushkiOptions
KushkiOptions la cuál te permite declarar la clave pública del comercio así como poder seleccionar el ambiente (prueba o producción) mediante el método init().Inicializa el formulario en el front-end
Paso 1. Definir los contenedores para los campos de lado del servidor.
initCardToken(), es requerido que coloques los elementos necesarios para poder renderizar cada campo de lado del servidor.Paso 2. Crear una instancia de CardOptions
CardOptions con la información de la transacción tal como el monto, moneda, entre otros parámetros.isSubscription con el valor de true.Paso 3. Renderizar campos de lado del servidor con el método initCardToken()
CardOptions, es necesario mandar a llamar a la función initCardToken() para inicializar una instancia de ICard..
Solicita un token para seguir con el flujo de pago
requestToken() en la instancia de card inicializada previamente. Este método realiza las validaciones de 3DS, OTP, Sift Science automáticamente. Te recomendamos validar que todos los campos sean correctos; de lo contrario, arrojará una excepción.deferred será devuelto junto al token. Los campos disponibles dentro de deferred varían dependiendo el país. Consulta la referencia para más información sobre diferidos.Configura tu back-end
Importante
periodicity en custom ya que de otra manera cobrarás de manera recurrente a tu cliente. Para más información, consulta nuestras guías de cargos recurrentes.JavaScript
Python
PHP
2. Cobro
subscriptionId.Configura tu front-end
Kushki.js
Genera un token de cobro y envíalo a tu back-end
Kushki.js Hosted Fields
1.
requestDeviceToken() enviando el subscriptionId generado previamente.2.
1. requestDeviceToken()
requestDeviceToken() enviando el ID de suscripción obtenido previamente.requestDeviceToken() realizará las validaciones y desplegará el modal en caso de que sea requerido.2.Secure DeviceToken()
deviceToken, pero utiliza un campo alojado (hosted field) para validar el CVV de la tarjeta.Creación del formulario
Desplegar el campo del CVV
2.1. Llama al método initSecureDeviceToken().
initSecureDeviceToken(), que renderiza un campo alojado de CVV e inicializa una instancia de ICardSubscriptions.2.2. Llama al método requestDeviceToken().
deviceToken seguro, debes llamar al método requestDeviceToken() en la instancia de suscripción de tarjeta que fue inicializada previamente.Este método también valida si el campo de CVV es válido; de lo contrario, generará una excepción.
Configura tu back-end
subscriptionIdbajo la lógica que definas.deferred con el parámetro months, junto con la información del cobro, como en el siguiente ejemplo:JavaScript
Python
PHP
Importante
deferred solo debe enviarse en los casos en que la tarjeta tenga la posibilidad de hacer pagos diferidos, en todos los demás casos el objeto mencionado debe omitirse.Cancela una inscripción (Opcional)
JavaScript
Python
PHP
3. Prueba tu integración
5451951574925480457444121519033543490030000470154. Prepara tu certificación
orderDetails -> billingDetails) y envío (si tu modelo de negocio lo requiere: orderDetails -> shippingDetails), dentro del request para realizar el cargo. El ejemplo del Body del JSON para el charge, lo podrás encontrar en Referencia de la API.Modificado en 2026-10-14 19:39:33