El API de Online Payments de Kushki cubre todo el ciclo de vida del pago en Perú 🇵🇪: 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 conciliación y reportes.
Monedas soportadas#
| Moneda | Código |
|---|
| Sol peruano | PEN |
| Dólar estadounidense | USD |
Tipos de documento#
| Valor | Descripción |
|---|
DNI | Documento Nacional de Identidad 🇵🇪 |
CE | Carné de Extranjería 🇵🇪 |
PAS | Pasaporte 🇵🇪 |
RUC | Registro Único de Contribuyentes 🇵🇪 |
Cobra pagos (Pay-in)#
Pagos con tarjeta
Acepta pagos con tarjeta de crédito y débito: cargos únicos, diferidos, flujos de preautorización, 3DS, network tokens y verificación de tarjeta con monto cero.
Pagos One-Click y Programados
Guarda una tarjeta una sola vez y cóbrala on demand o de forma recurrente programada, sin volver a pedirle los datos al cliente.
Transfer In
Acepta pagos por transferencia bancaria: redirige al cliente al portal de su banco y recibe la confirmación cuando la transferencia se complete.
Cash In
Acepta pagos en efectivo en puntos de recaudo físicos (por ejemplo, Payvalida): Kushki genera un PIN que el cliente presenta para pagar.
Dispersa fondos (Pay-out)#
Transfer Out
Envía fondos directamente a la cuenta bancaria del destinatario: dispersiones, pagos a proveedores y reembolsos por transferencia bancaria ACH.
Card Out
Envía fondos directamente a una tarjeta Visa o Mastercard: pagos únicos o dispersiones recurrentes por suscripción. Soporta comercios PCI y no PCI mediante hosted fields.Card Out está actualmente en beta. Contacta a tu ejecutivo de cuenta para habilitarlo en tu comercio.
Herramientas de pago#
Smartlinks V2
Crea páginas de pago alojadas y comparte un URL con tus clientes, sin integración de frontend. Soporta tarjeta, transferencia, efectivo y suscripciones.
Payment Button
Embebe un botón de checkout alojado por Kushki directamente en tu sitio web o plataforma de e-commerce.
Gestión del comercio#
Payment Credentials
Crea, rota, activa y elimina pares de llaves de API de tu cuenta de comercio de forma programática.
Reportes y conciliación#
Analytics
Consulta todo tu historial de transacciones: paginado y con filtros flexibles para conciliación y monitoreo. Usa v2 para transacciones presenciales y no presenciales en un solo endpoint.
Liquidación
Obtén los registros de liquidación por rango de fechas o por ticket number, incluidos los montos de la transacción, las comisiones de Kushki y el monto neto pagado al comercio.
Chargebacks
Busca y exporta registros de chargebacks: filtra por estado, fecha, tipo y nivel de riesgo. Exporta de forma asincrónica mediante notificación 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.
Estado y monitoreo#
Estado del gateway
Consulta en tiempo real el estado operativo del gateway de pagos de Kushki y de las redes de procesamiento.
Estado de la plataforma
Monitorea la disponibilidad de los servicios centrales de la plataforma de Kushki.
Patrón común de solicitud#
La mayoría de las operaciones de pay-in siguen un flujo token → cargo: primero se tokenizan los datos sensibles en tu backend y luego se usa el token para enviar el cargo. Tu servidor nunca necesita almacenar datos crudos de la tarjeta ni de la cuenta bancaria.POST /card/v1/tokens → token de un solo uso
POST /card/v1/charges → cargo usando el tokenTransfer Out y Cash In siguen un patrón similar de token → init. Card Out usa el mismo enfoque: primero genera un token de payout (por API o con hosted fields) y luego llama a Push Funds. Kushki confirma el pago por webhook o por un endpoint de estado que puedes consultar.
Autenticación#
Todos los endpoints usan las llaves de tu comercio en las cabeceras de la solicitud. Usa la Private Key para llamadas server-to-server; nunca la expongas en el código del frontend.Usando el API#
https://api.kushkipagos.com/
Cuando una tarjeta requiere validación OTP en el ambiente de sandbox, usa 555 tanto para transacciones en PEN como en USD.
