El API de Online Payments de Kushki cubre todo el ciclo de vida del pago en Chile 🇨🇱: cobra a tus clientes con tarjeta, transferencia bancaria o efectivo; dispersa fondos a terceros; gestiona suscripciones recurrentes; crea páginas de pago alojadas; y consulta los registros de transacciones para conciliar y reportar.
El peso chileno no tiene decimales. Envía siempre los montos como números enteros (por ejemplo, 10000, no 10000.50). Los valores con decimales devuelven un 400 Bad Request.
Acepta pagos con tarjeta de crédito y débito: cargos únicos, Cuotas Comercio, Cuotas Emisor, flujos de preautorización, 3DS, network tokens y verificación de tarjeta con monto cero.
Card Async
Cobra pagos con tarjeta de forma asíncrona: tokeniza la tarjeta, inicializa el cargo y recibe el resultado final por webhook cuando termine el procesamiento.
Pagos One-Click y Programados
Guarda una tarjeta una sola vez y cóbrala cuando quieras o con una programación recurrente, sin volver a pedirle los datos de la tarjeta al cliente.
Transfer In
Acepta pagos por transferencia bancaria: redirige al cliente al portal de su banco y recibe una confirmación cuando la transferencia se complete.
Cash In
Acepta pagos en efectivo en puntos de recaudación físicos: Kushki genera un PIN que el cliente presenta para pagar.
Ejecuta cargos recurrentes programados sobre suscripciones de tarjeta asíncronas guardadas: creación del token, init de la suscripción, preautorización y flujos de captura.
Crea páginas de pago alojadas y comparte una URL con tus clientes, sin necesidad de integración en el frontend. Soporta tarjeta, transferencia y suscripciones.
Payment Button
Integra un botón de checkout alojado por Kushki directamente en tu sitio web o plataforma de e-commerce.
Consulta todo tu historial de transacciones: paginado y con filtros flexibles por fecha, método de pago, estado y tipo. Usa v2 para obtener el conjunto de datos más completo.
Liquidación
Obtén los registros de liquidación por rango de fechas o por ticket number: incluyen los montos de las transacciones, las comisiones de Kushki y el monto neto pagado al comercio.
Chargebacks
Busca y exporta registros de chargebacks: filtra por estado, fecha y tipo. La exportación es asíncrona y se notifica por webhook.
Transacciones de suscripción
Consulta el historial de transacciones de una suscripción específica: todos los cargos, estados y montos en un solo lugar.
La mayoría de las operaciones de pay-in siguen un flujo token → charge: primero los datos sensibles se tokenizan en tu backend y luego el token se usa para enviar el cargo. Tu servidor nunca necesita almacenar datos de tarjeta o de cuenta bancaria en crudo.
1. POST /card/v1/tokens → one-time token
2. POST /card/v1/charges → charge using the token
Transfer Out y Cash In siguen un patrón similar de token → init. Después Kushki confirma el pago con una notificación webhook o con un endpoint de estado que puedes consultar.
Todos los endpoints usan las llaves de tu comercio en las cabeceras de la solicitud. Usa la Private Key para todas las llamadas servidor a servidor; nunca la expongas en el código del frontend.
Algunas operaciones (por ejemplo, las consultas de BIN iniciadas desde el navegador) aceptan la Public Key:
