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

> Cobra por QR desde tu sistema, en el acto y en bolivianos

## Introducción

**Cobros QR** es la API con la que cobras desde tu propio sistema. Genera cobros en Bolivianos (BOB) que se pagan desde la app de cualquier banco, sin integrar directamente con la infraestructura financiera.

Dos modalidades según tu perfil comercial: **CUCU Pay** (pasarela estándar) y **CUCU Direct** (flujo de fondos directo a tu cuenta).

### Características técnicas

| Característica          | Detalle                                      |
| ----------------------- | -------------------------------------------- |
| Base URL                | `https://qrsimple.cucu.bo/api/v1`            |
| Moneda                  | BOB (Bolivianos)                             |
| Imagen del QR           | PNG · URL pública o Base64                   |
| Expiración configurable | Desde segundos hasta años, o fecha exacta    |
| Idempotencia            | Header `Idempotency-Key` con ventana de 24 h |
| Seguridad               | HTTPS + API key por comercio (`X-Api-Key`)   |

<CardGroup cols={2}>
  <Card title="Autenticación" icon="key" href="/payments/cobros-qr/autenticacion">
    Tu API key en el header X-Api-Key.
  </Card>

  <Card title="Crear QR" icon="qrcode" href="/payments/cobros-qr/crear-transaccion-qr">
    POST /qr — genera el QR de cobro.
  </Card>

  <Card title="Consultar estado" icon="magnifying-glass" href="/payments/cobros-qr/consultar-estado">
    GET /qr/{qrId} — estado y pagos recibidos.
  </Card>

  <Card title="Modalidades de procesamiento" icon="code-branch" href="/payments/cobros-qr/modalidades">
    CUCU Pay vs CUCU Direct.
  </Card>
</CardGroup>