> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cucu.bo/llms.txt
> Use this file to discover all available pages before exploring further.

# CUCU Transferencias

> API para transferencias bancarias y cobros QR inmediatos en Bolivia

## 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                    |

<CardGroup cols={2}>
  <Card title="Modalidades de procesamiento" icon="code-branch" href="/payments/transferencias/modalidades">
    CUCU Pay (pasarela centralizada) vs CUCU Direct (cuenta a cuenta).
  </Card>

  <Card title="Autenticación" icon="key" href="/payments/transferencias/autenticacion">
    Bearer token por comercio emitido en el onboarding.
  </Card>

  <Card title="Crear transacción QR" icon="qrcode" href="/payments/transferencias/crear-transaccion-qr">
    POST /transfers/qr — genera el QR de cobro inmediato.
  </Card>

  <Card title="Webhooks" icon="bell" href="/payments/transferencias/webhooks">
    Notificaciones push cuando el estado cambia.
  </Card>
</CardGroup>