Cobros
Crear, listar, anular. QR y pago desde el banco.
KUTI API
Conecta tu sistema
El sistema que ya usas crea el cobro. El cliente paga con Yape, Plin o su banco. Tu sistema se entera solo. Documentación pública en docs.kuti.pe, desde el primer día.
docs.kuti.pe
Introducción
API de KUTI
Conecta cobros con tu aplicación. Una sola dirección. El entorno lo define el tipo de clave.
Sin fricción: docs públicas desde el primer día. No hay URL de prueba aparte. kuti_test_… y kuti_live_… en la misma base.
| Entorno | URL |
|---|---|
| Test y live | https://api.kuti.pe/v1 |
- · Crear cobros con QR, link y código de servicios
- · Clientes, saldo y pagos a tu cuenta
- · Avisos firmados cuando el cobro se confirma
Sin fricciones
Docs públicas. Key de prueba. Listo.
No hay portal cerrado ni ambiente de prueba aparte. Lees, pruebas y conectas.
Sacas una clave de prueba
En el panel, en Developers. Con la clave de prueba no se mueve dinero real.
Creas el cobro desde tu sistema
Tu software pide el cobro a KUTI. Te devolvemos el link, el QR y el código de banca.
Te enteras cuando pagan
Cuando el cliente paga, KUTI avisa a tu sistema. Firmado. Sin estar preguntando a cada rato.
Para tu equipo técnico
Una llamada y tienes el cobro
Misma dirección para prueba y producción. La clave define el entorno. La respuesta trae el link de pago, el QR y el código de banca.
- Guía completa en docs.kuti.pe: cobros, SDKs, plugin WooCommerce, clientes, avisos y saldo.
- Fechas en UTC. En tu app las pasas a hora de Lima.
- Clave secreta solo en tu servidor. La pública, solo para abrir el pago en el navegador.
POST /v1/payment-intents
201curl -X POST https://api.kuti.pe/v1/payment-intents \
-H "Authorization: Bearer kuti_test_…" \
-H "Content-Type: application/json" \
-d '{
"amount": { "amount": "100.00", "currency": "PEN" },
"payment_method_types": ["INTEROPERABLE_QR", "BANK_TRANSFER"],
"description": "Pensión",
"customer": {
"type": "INDIVIDUAL",
"given_name": "María",
"family_name": "López",
"email": "maria@example.com",
"document": { "type": "DNI", "number": "45678912" }
}
}'Respuesta
{ id: "pi_01J8…", status: "PENDING", checkout_url: "pay.kuti.pe/c/…", customer: { id: "cus_01J8…" } }
Qué cubre
Tu sistema habla con KUTI. No con cada banco.
Clientes
Persona o empresa. Documento, correo, teléfono.
Avisos
Cuando el cobro cambia de estado. Firmados y con reintentos.
Saldo y liquidaciones
Consulta saldo, movimientos y pagos a tu cuenta.
SDKs
Node, PHP y Python. Cobros, checkout y webhooks firmados.
WooCommerce
Plugin 1.0.0: ZIP en docs.kuti.pe/woocommerce.
app.kuti.pe/developers/api-keys
API keys
Secret en el servidor. Publishable solo para el checkout.
Secret · Test
kuti_test_…
Secret · Live
kuti_live_…
Publishable · Test
kuti_pub_test_…
En el panel
Claves y avisos donde desarrollas
En app.kuti.pe → Developers: creas claves, registras a dónde te avisamos y ves los eventos. Lo de prueba no se mezcla con producción.
Dudas
Preguntas sobre la API
Docs, claves de prueba, clave pública y zona horaria.
Escribir por WhatsAppLee la docs y conecta
Sin portal cerrado. docs.kuti.pe está abierta. Creas cuenta, sacas una key de prueba y pruebas.