Nuestras librerías y SDKs del lado del cliente recogen los datos de pago de tu cliente y los convierten en un token — una referencia de un solo uso que envías a tu backend para crear el cargo. Los datos sensibles nunca pasan por tus servidores.Elige una librería y ten todos los medios de pago.
Card, Cash, Transfer, Subscriptions y Payouts se alcanzan desde el mismo SDK. Tú solo eliges dónde vive el formulario de pago: en tu página, en nuestros hosted fields o en un checkout listo para usar.
🔄 Cómo funciona el flujo#
Todas las librerías de Kushki siguen los mismos tres pasos, sin importar la plataforma:| Paso | Dónde corre | Qué pasa |
|---|
| 1. Recolectar | Cliente (navegador / app) | El cliente ingresa sus datos de pago en el SDK. |
| 2. Tokenizar | Cliente → Kushki | El SDK envía los datos a Kushki y devuelve un token. Tus servidores nunca ven la tarjeta. |
| 3. Cobrar | Tu backend → Kushki | Envías el token a tu backend, que llama a la API de Kushki para crear el cargo. |
Un token es de un solo uso y de vida corta. Genera uno nuevo para cada transacción.
🧭 ¿Qué librería debo usar?#
| Si necesitas… | Usa | Plataforma |
|---|
| Un formulario de pago web con tus propios estilos, sin manejar datos de tarjeta | Kushki.js Hosted Fields ✅ recomendado | Web |
| Un checkout que integras con casi nada de código | Cajita SDK | Web |
| Mantener una integración ya construida con la librería JS anterior | Kushki.js (legacy) | Web |
| Pagos nativos dentro de una app Android | Android SDK | Android |
| Pagos nativos dentro de una app iOS | iOS SDK | iOS |
¿Empiezas una integración web nueva? Usa Kushki.js Hosted Fields — es ~9× más liviano que Kushki.js, es modular y deja los datos sensibles de la tarjeta completamente fuera de tu DOM.
🌐 Librerías web#
⭐ Kushki.js Hosted Fields
Kushki.js Hosted Fields#
La generación actual de nuestra librería de JavaScript: más liviana, modular y segura. Los campos de entrada están alojados en los servidores de Kushki y se renderizan dentro de tu propio layout, así mantienes el control total del diseño sin manejar nunca datos sensibles de la tarjeta.Importa solo los módulos que realmente uses.| Módulo | Qué cubre |
|---|
Kushki | Inicialización de la librería, lista de bancos, configuración de comisiones. |
Card | Tokens de tarjeta, Apple Pay, tokens de dispositivo, animación de branding de marca. |
Card Payouts | Tokens de payout a una tarjeta. |
Antifraud | Validación 3DS e inicialización de Sift Science. |
📱 SDKs móviles#
Android SDK#
Recibe pagos de forma nativa en tu aplicación Android, con soporte integrado de 3DS y Sift Science y con animaciones de sensory branding de Visa / Mastercard.Cubre — tokens de tarjeta (con 3DS), información de bin, card async (Chile), Transfer In, Cash In, suscripciones de tarjeta, suscripciones async (Chile) y Cash Out (Colombia).
⚖️ Kushki.js vs. Kushki.js Hosted Fields#
| Característica | Kushki.js | Kushki.js Hosted Fields |
|---|
| Size | ~2.7 MB | ~307 KB |
| Modularity | No | Yes |
| Import via CDN | Yes | Yes |
| Import via NPM | Yes | Yes |
| Import via YARN | No | Yes |
| Handles sensitive card data in your DOM | Yes | No |
| 3DS / OTP validation | Separate method calls | Automatic inside requestToken() |
| Deferred payment options | requestDeferred() method | Returned by requestToken() |
🚀 Siguientes pasos#
1.
Elige tu librería en las tablas de arriba y sigue su guía de instalación.
2.
Genera un token en tu cliente con el método que corresponde a tu tipo de pago.
3.
Envía el token a tu backend y crea el cargo con la API de Kushki. 4.
Pasa a producción cuando tus pruebas pasen — revisa el checklist de pruebas a producción.
Revisa las Notas de versión para enterarte de métodos nuevos, medios de pago y disponibilidad por país. ¿Tienes una sugerencia sobre esta documentación? Contáctanos.