Ir al contenido

API de KUTI

Cobra en soles con QR interoperable, pago de servicios y checkout hospedado. Una sola base URL; el entorno lo define tu API key.

KUTI es la API de pagos para negocios en Perú. Tu backend crea un cobro; el cliente paga con Yape, Plin, billeteras bancarias o desde su banca buscando la institución KUTI. Tú confirmas el pago con webhooks.

Base URL única: https://api.kuti.pe/v1. Usa kuti_test_… para integrar sin dinero real; kuti_live_… para producción (requiere sello KUTI habilitado en el dashboard).

Arranque en 5 minutos

  • Crea tu cuenta en app.kuti.pe y un negocio.
  • Emite una secret key de prueba (kuti_test_…) en Desarrolladores → API keys.
  • Crea un cobro con POST /payment-intents (QR + pago de servicios).
  • Abre el checkout_url o embebe Checkout.js.
  • Escucha payment.succeeded en un webhook para marcar el pedido como pagado.
Primer cobro (cURL)bash
curl -s https://api.kuti.pe/v1/payment-intents \
  -H 'Authorization: Bearer kuti_test_…' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440001' \
  -d '{
    "amount": { "amount": "50.00", "currency": "PEN" },
    "payment_method_types": ["INTEROPERABLE_QR", "BANK_TRANSFER"],
    "description": "Pedido #1042",
    "external_reference": "order-1042"
  }'

La respuesta trae payment_method.qr (payload EMVCo para dibujar el QR), payment_method.payment_code (código para banca) y checkout_url (pay.kuti.pe/c/…).

Base URL

EntornoURLAPI key
Pruebahttps://api.kuti.pe/v1kuti_test_… / kuti_pub_test_…
Producciónhttps://api.kuti.pe/v1kuti_live_… / kuti_pub_live_…

Qué incluye v1

  • Cobros con QR interoperable y/o pago de servicios (institución KUTI)
  • Checkout hospedado (pay.kuti.pe) y Checkout.js embebido
  • Clientes, webhooks firmados, saldo y pagos a tu CCI
  • Modo prueba aislado del modo producción

Fechas

Todos los date-time van en UTC ISO-8601 con sufijo Z (created_at, expires_at, paid_at, …). Convierte a America/Lima en tu UI si lo necesitas.

Siguiente

  • Autenticación — secret vs publishable keys
  • Métodos de pago — QR y banca
  • Prueba vs producción — cuándo usar cada key
  • Checkout.js — modal o embed en tu sitio
  • Webhooks — confirmar el pago en tu servidor