Métodos de pago
Cómo paga tu cliente: QR interoperable (Yape, Plin, billeteras), pago de servicios buscando la institución KUTI en su banca, y Yape afiliado para cobrarle sin que intervenga.
Al crear un cobro eliges uno o ambos métodos. KUTI genera lo necesario para cada uno. El cliente paga con cualquiera; el cobro queda SUCCEEDED cuando se confirma el pago.
| Método | Código API | Qué ve el cliente |
|---|---|---|
| QR interoperable | INTEROPERABLE_QR | Escanea el QR desde Yape, Plin u otra billetera |
| Pago de servicios | BANK_TRANSFER | Ingresa un código en su banca buscando la institución KUTI |
| Yape afiliado | YAPE | Afilia su Yape una vez; los cobros siguientes se debitan solos (en producción, próximamente) |
QR interoperable
Respuesta en payment_method.qr: payload EMVCo. Con ese string dibujas el QR en tu UI (el API no entrega una imagen PNG).
- Montos típicos de billetera: hasta S/ 500 por operación.
- Sirve para Yape, Plin y billeteras de bancos.
- No es un código de “pago de servicios”: es un QR de cobro.
Pago de servicios (banca)
Respuesta en payment_method.payment_code.code. El cliente abre su banca o app → Pago de servicios → busca KUTI → ingresa el código → confirma el monto.
- Ideal para montos mayores (desde ~S/ 50 según tu plan de comisiones).
- También disponible el atajo “Yape servicios” en el checkout hospedado (abre Yape con el código ya cargado).
- Instrucciones al cliente: institución = KUTI.
Yape afiliado
Tu cliente aprueba una vez en su app de Yape que tu negocio le cobre, y su Yape queda guardado. Después le cobras sin que escanee ni apruebe: con una suscripción, con un toque desde el enlace o directo desde tu backend.
- Hasta S/ 2,500 por cobro.
- El cobro debe tener cliente.
- Disponible en producción próximamente.
- Medios de pago guardados — guía completa
Ambos a la vez
{
"payment_method_types": ["INTEROPERABLE_QR", "BANK_TRANSFER"]
}KUTI crea un cargo por método. El cliente elige cómo pagar; cuando uno se completa, el cobro pasa a SUCCEEDED.
Checkout hospedado
Si no quieres armar la UI, usa checkout_url (pay.kuti.pe/c/…) o Checkout.js. El checkout muestra pestañas Escanea el QR, Banca y Yape servicios.
Siguiente
- Crear cobro — QR y/o banca
- Checkout.js — modal o embed
- Webhooks — confirmar el pago