Recibe pagos con autorización y captura
Web
iOS
Android
Aviso Importante sobre Transacciones con BBVA Perú
Importante
Flujo
1. Obtén el token de pago único
Kajita
Crea y personaliza tus Kajitas
Configura Kajita
kushki-checkout.js en tu página de pago añadiéndolo al <head> de tu archivo HTML. Siempre carga kushki-checkout directamente desde cdn.kushkipagos.com. No incluyas el script en un bundle o paquete ni hostees una copia de él.Añade Kajita a tu sitio
<body>de tu sitio donde quieras que se despliegue el formulario de pago.action de acuerdo al endpoint correspondiente en tu back-end, para obtener el token.script.Kushki.js
Configura 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
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.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. Para que el usuario pueda seleccionar los meses sin intereses a diferir la compra, se deberá colocar una etiqueta div con el id de deferred_id (<div id="deferred_id"></div>) y se deberá definir dentro de la instancia CardOptions en el objeto fields dicho id. Los campos disponibles dentro de deferred varían dependiendo el país. Consulta la referencia para más información sobre diferidos.2. Realiza la autorización
token, deberás realizar una llamada a nuestro endpoint de autorización para iniciar la autorización de fondos.JavaScript
Python
PHP
3. Kushki verifica autorización
Una vez obtenida la respuesta de Kushki, guarda el
ticketNumber ya que será el identificador para realizar luego la reautorización, captura o anulación.4. Reautoriza el cargo (opcional)
JavaScript
Python
PHP
Ten en cuenta
5. Captura o libera los fondos
5.1. Realiza la captura (opcional)
Importante
ticketNumber obtenido en la autorización.JavaScript
Python
PHP
5.2 Anula la autorización (Opcional)
ticketNumber obtenido en la autorización.JavaScript
Python
PHP
Prueba tu integración
5451951574925480457444121519033543490030000470154547004841271012Prepara tu certificación
productDetails), así como también los datos de contacto de tu cliente-pagador (contactDetails), junto con los datos de facturación ( "orderDetails"."billingDetails") y envío (si tú modelo de negocio lo requiere: "orderDetails"."shippingDetails"), dentro del request para realizar el cargo.email, del objeto contactDetails es requerido.Modificado en 2026-10-21 19:53:40