Prueba vs producción
Misma API, datos aislados. Prueba con kuti_test_…; producción con kuti_live_… tras completar la verificación KUTI.
| Prueba | Producción | |
|---|---|---|
| API key | kuti_test_… | kuti_live_… |
| Dinero real | No | Sí |
| Clientes / cobros | Aislados | Aislados |
| Webhooks | Solo eventos de prueba | Solo eventos live |
| Requisito | Negocio creado | Sello KUTI habilitado |
Modo prueba
Integra y demuestra el flujo completo sin mover dinero. En el dashboard elige Modo prueba. En checkout verás el banner de modo prueba. El cliente busca la institución KUTI; puedes simular el pago desde el dashboard o con la API (POST /payment-intents/{id}/simulate).
Yape afiliado (YAPE) y las Suscripciones estarán disponibles en producción próximamente. Ya puedes integrarlos y probar el flujo completo en modo prueba.
Modo producción
Para emitir claves live y operar cobros reales el negocio debe tener el sello KUTI habilitado (verificación documental en Ajustes → Verificación KUTI). Sin ese sello, la API responde KYB_REQUIRED al crear claves live o al llamar endpoints en live.
No mezcles keys: un cobro creado con kuti_test_… nunca aparece con kuti_live_…. Registra un webhook por cada modo si necesitas ambos.
Publishable keys
Nunca expongas una API key en el frontend: el navegador usa el client_secret del cobro (KUTI.js).
Siguiente
- Demo en vivo — tienda, suscripción y link de pago en modo prueba
- Simular pagos en prueba — termina un cobro sin pagar
- Errores — códigos y body
- Crear cobro — con kuti_test_…
- Webhooks — payment.succeeded