Recibe transferencias bancarias
Web
iOS
Android
Permite que tus clientes aprovechen el saldo disponible en su cuenta bancaria para adquirir tus productos o servicios desde tu página web, a través de una transferencia. Para lograrlo, debes obtener los datos de tu cliente pagador, generar un número Clabe y proporcionar este junto a tu cliente, de forma que este se dirija al sitio de su banco y efectúe el pago.El flujo de pago que integrarás es el siguiente: 
La responsabilidad del front-end es recolectar los datos principales del usuario, tokenizar esa información a través de los servidores de Kushki y luego enviarla al back-end para iniciar el proceso de pago. Para ello cuentas con dos opciones: Kajita y Kushki.js. Kushki cuenta con formularios de pago listos para recopilar información de tarjeta de forma segura. Podrás usar cualquiera de nuestras versiones: Cajita: la primera versión del formulario de pagos. No es personalizable. Kajita: la segunda versión. Te permite personalizar tus formularios de pago desde tu Consola de administración e incluso tener varias versiones de Kajita. Con Kushki puedes crear tus Kajitas desde la Consola de administración. Haz clic aquí para aprender cómo hacerlo. Incluye el script de Kajita necesita un espacio dentro de tu página. Ingresa el siguiente código en el Para Kajita (v.2): Para Cajita (v.1) Recuerda configurar la acción del formulario Luego, agrega el tag Para la Kajita (v.2) Podrás obtener dicho script desde tu Consola de administración según lo explicado aquí. Para la v.1 (Cajita), añade el siguiente script y asegúrate de que el formulario se haya cargado: Esto creará un formulario predefinido en tu página para aceptar pagos. Puedes utilizar Kajita para ofrecer no solo pagos a través de transferencias, sino también con tarjeta o con efectivo. Usa Kushki.js si necesitas un mayor control sobre el "look & feel" o apariencia de tu formulario de pago. Usa el siguiente tag Instala el paquete desde npm. Luego impórtalo en tu código utilizando el siguiente código. Configura el objeto
Añade el siguiente código a tu aplicación Primero, añade el formulario a tu página de pagos con los campos requeridos. Puedes diseñarlo como desees. Por ejemplo: Si deseas que tus clientes reciban notificación de sus transacciones, asegúrate de capturar el email de tu cliente en el formulario de pago. Adicional a esto, recuerda habilitar la opción de envío notificaciones desde tu Consola. Luego, cuando el usuario envía el formulario, deberás solicitar el token y enviarlo a tu back-end. Revisa la referencia completa en nuestra referencia de Kushki.js La responsabilidad del back-end es recibir el token obtenido desde tu front-end e iniciar el proceso de pago con Kushki. Cuando el usuario envía el formulario, tu front-end transfiere un token al endpoint que hayas especificado. Con este token, deberás realizar una llamada a nuestro endpoint Init Transaction para obtener el código de la cuenta CLABE asociada al correo que tu cliente especificó en el paso 1 y la referencia de pago. Revisa nuestra Referencia de la API para mayor información. Como respuesta a esta llamada obtendrás la siguiente información: Deberás mostrar a tu cliente la Clabe ( La cuenta clabe no variará para tu cliente pagador, siempre y cuando se ingrese el mismo correo al solicitar el token. Si la transacción no se paga, quedará en estado Si el monto enviado al consumir el init difiere del monto pagado en el banco, la transferencia será declinada. En este caso, se le hará una devolución inmediata de lo pagado al cliente. La transacción quedará en estado Para enterarte del estado de la transferencia bancaria efectuada por tu cliente podrás utilizar cualquiera de estas opciones: El resultado final de estos datos de prueba depende de la configuración de tu comercio: requiere que el ambiente de pruebas (sandbox) esté activo en tu comercio y que el procesador asignado admita simular ciertos estados. Si no obtienes el resultado esperado, escribe a tu ejecutivo de Kushki o a soporte. Existen datos de prueba que puedes usar en ambiente UAT para asegurarte de que tu integración está lista. Transacción aprobada: envía Transacción declinada: envía Consulta el resultado con Toma en consideración las siguientes pautas para aprobar la certificación técnica (requerida para obtener credenciales productivas): El cálculo de los impuestos y el monto total, debe ser el correcto. Mostrar tus mensajes en pantalla de acuerdo con las respuestas de Kushki. Guardar y registrar todas las respuestas de Kushki (requeridas en caso de necesitar soporte). En caso de que recibas correctamente la notificación al Webhook, responde la solicitud con un El botón "Pagar" se desactiva después del primer clic. Si el resultado de la transacción es El logo de Kushki debe ser visible para el cliente. Puedes encontrar nuestro logo en varios formatos aquí. Asegúrate de enviar todas las variables requeridas, especificadas en la referencia de la API.
1. Configura tu Front-end
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 con el 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.Option 2 - NPM
Configura el objeto Kushki
Recolecta la información del usuario y envíala a tu back-end
Envía notificaciones a tus clientes
2. Configura tu back-end
JavaScript
Python
PHP
{
"bank": "Transfer Processor",
"referenceNumber": "1111111",
"referenceProcessor": "641641241726965121",
"ticketNumber": "1641241726965127",
"transactionReference": "fb247919-2c5e-4ef2-ab75-21fc38b5a7e4"
}referenceProcessor) para que pueda ingresar a su portal bancario y completar la transferencia. Asegúrate de guardar la demás información obtenida para futuras consultas.Importante ❗️⛔️
initializedTransaction por hasta 7 días. Cumplido este plazo, quedará como expiredTransaction. Contáctanos si deseas reducir este plazo a menos de 7 días (mínimo 1 día).initializedTransaction por hasta 7 días. Cumplido este plazo, quedará como expiredTransaction.3. Consulta el estado de la transferencia
4. Prueba tu integración
documentNumber: 123456789 al solicitar el token (cualquier número diferente a 999999990 también se aprueba).documentNumber: 999999990.GET /status/{token}. Encuentra más detalle en Datos de prueba.5. Prepara tu certificación
statusCode 200 e informa al cliente.Initialized, no se debe permitir una nueva transacción hasta que se apruebe o se rechace.Modificado en 2026-10-26 22:12:09