Ir al contenido

Changelog

Qué cambió en la API. Lo más nuevo arriba. Versión actual: 1.0.0.

Aquí ves qué puedes usar hoy y qué rompe contratos. Seguimos semver: si algo deja de ser compatible, sube la versión mayor. Mientras tanto, todo vive en https://api.kuti.pe/v1.

Auth: Authorization: Bearer kuti_live_… (o kuti_test_…). Webhooks: firma con whsec_… / whsec_test_…. Esas keys y la Base URL no cambian en 1.x.

1.0.0 — 6 sep 2026

Primera versión pública. Puedes crear cobros, recibir el pago por webhook y liquidar a tu CCI.

Qué puedes llamar

  • POST/GET /payment-intents — crear cobro, listar, ver detalle, anular, enviar link por WhatsApp.
  • POST/GET /checkout/sessions — sesión de Checkout.js (modal o embebido) con tu marca.
  • CRUD /customers y /merchants — clientes y negocios.
  • GET /balance, /balance/transactions, /fee-preview — saldo, movimientos y comisión antes de cobrar.
  • GET/POST payouts y cuentas CCI — liquidaciones a tu banco y preferencias.
  • Webhooks: registrar URL, listar eventos/entregas, reintentar; verifica HMAC-SHA256 con el raw body.

Cómo paga el cliente

  • QR interoperable: Yape, Plin y billeteras bancarias.
  • Desde su banca: busca la institución KUTI (pago de servicios).

Clientes oficiales

  • SDKs Node, PHP y Python: auth, cobros, checkout y verifyWebhookSignature.
  • Plugin WooCommerce 1.0.0: abre Checkout.js y marca el pedido pagado al llegar payment.succeeded.

Para integrar más rápido

  • Guías + referencia en docs.kuti.pe.
  • Descarga collection.json (Postman / Insomnia / Bruno) o openapi.json.
  • llms.txt y llms-full.txt si usas un LLM en el IDE.