Ir al contenido

Métodos de pago

Cómo paga tu cliente: QR interoperable (Yape, Plin, billeteras) y pago de servicios buscando la institución KUTI en su banca.

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étodoCódigo APIQué ve el cliente
QR interoperableINTEROPERABLE_QREscanea el QR desde Yape, Plin u otra billetera
Pago de serviciosBANK_TRANSFERIngresa un código en su banca buscando la institución KUTI
En la banca y en Yape (pago de servicios) la institución/empresa a buscar es siempre KUTI. No muestres nombres de proveedores internos en tu UI.

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.

Ambos a la vez

payment_method_typesjson
{
  "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.