Empezar
Qué es KUTI
KUTI es la API de cobros en soles para negocios en Perú. Tú creas el cobro; el cliente paga con Yape, Plin u otra billetera, desde su banca buscando la institución KUTI, o con Yape afiliado (frecuente) sin abrir la app cada vez. Tu sistema se entera por un webhook firmado.
No operas tarjetas ni una cuenta bancaria del cliente. KUTI junta los rieles que sí usa el Perú cotidiano (QR interoperable y pago de servicios) detrás de un solo contrato: REST en https://api.kuti.pe/v1, Checkout.js, el plugin WooCommerce o agentes MCP.
La pieza que se mantiene
Da igual si cobras desde WooCommerce, un backend Node o un link por WhatsApp: el objeto es el mismo payment_intent. Cambia el canal; no cambia el cobro ni la forma de confirmarlo.Cómo paga el cliente
Tres formas de cobrar, combinables. Los límites los aplica KUTI, no tu código. Yape afiliado (el frecuente / recurrente) está en prueba; producción, próximamente.
| Método | Qué ve el cliente | Rango |
|---|---|---|
| QR interoperable | Yape, Plin y billeteras que lean el QR | hasta S/ 500 |
| Pago desde el banco | Busca la institución KUTI en su app y paga el código | desde S/ 50 |
| Yape afiliado | Aprueba una vez en Yape; los cobros siguientes se debitan solos (membresías, cuotas) | hasta S/ 2,500 |
Solo PEN. El detalle de montos, caducidad y qué pasa si cierra el checkout está en Métodos de pago.
- Métodos de pago — QR, banca, mínimos y máximos
- Medios de pago guardados — afiliar Yape una vez y cobrar después
- Suscripciones — cargo automático cada periodo sobre ese Yape
Qué conectas tú
Una integración cubre el cobro. Eliges cómo lo presentas y cómo te enteras de que pagó.
- API REST: creas el cobro, lees el estado, anulas. Base URL única; el entorno lo define la key (kuti_test_… o kuti_live_…).
- Checkout.js o pay.kuti.pe: el cliente ve QR y banca sin que la secret key salga de tu servidor.
- Plugin WooCommerce 1.0.2: el pedido se marca pagado cuando llega payment.succeeded.
- Webhooks firmados: la fuente de verdad para cerrar el pedido. El thank-you es un respaldo, no el disparador.
- Saldo y liquidación a tu CCI cuando el cobro está confirmado.
Prueba y producción
El host no cambia. En prueba no se mueve dinero; en live hace falta el sello KUTI del negocio. Puedes recorrer una tienda, una suscripción y un link en demo.kuti.pe con tu clave de prueba, viendo cada request.
- Prueba vs producción — cuándo usar cada key y el sello KUTI
- Simular pagos — cerrar un cobro de prueba sin Yape real
- Demo en vivo — pegar kuti_test_… y ver las llamadas
Por dónde seguir
- Autenticación — emitir la key y sus permisos
- Referencia de la API — cada endpoint: cuerpo, respuesta y cURL
- Webhooks — verificar la firma y marcar el pedido
- SDKs — Node, PHP y Python
- WooCommerce — instalar el plugin 1.0.2