Introducción
API CUCU Transferencias es el rail de pagos QR inmediatos de CUCU. Permite a comercios y plataformas digitales generar cobros en Bolivianos (BOB) con liquidación en tiempo real, sin necesidad de integrar directamente con la infraestructura financiera subyacente. La API expone dos modalidades de procesamiento seleccionables según el perfil comercial del integrador: CUCU Pay para operación estándar tipo pasarela, y CUCU Direct para integraciones corporativas con flujo de fondos directo.Características técnicas clave
| Característica | Detalle |
|---|---|
| Moneda soportada | BOB (Bolivianos) |
| Formato de imagen QR | PNG / Base64 · URL CDN pública |
| Expiración configurable | Desde segundos hasta años o fecha exacta |
| Idempotencia | Header Idempotency-Key con ventana de 24 h |
| Registro de auditoría | Cada request queda auditado con timestamp y duración |
| Modelo de seguridad | HTTPS + Bearer token por comercio |
Modalidades de procesamiento
CUCU Pay (pasarela centralizada) vs CUCU Direct (cuenta a cuenta).
Autenticación
Bearer token por comercio emitido en el onboarding.
Crear transacción QR
POST /transfers/qr — genera el QR de cobro inmediato.
Webhooks
Notificaciones push cuando el estado cambia.