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

# Referencia de campos

> Campos del request y de la respuesta al crear un QR.

## Referencia de campos

***

## Request — Crear QR

| Campo               | Tipo               | Requerido | Descripción                                                                                                                   |
| ------------------- | ------------------ | --------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `amount`            | `Decimal` (string) | Sí        | Monto con 2 decimales. `0` = QR de monto abierto: el pagador digita el importe.                                               |
| `gloss`             | `string`           | Sí        | Descripción visible del cobro. Entre 3 y 100 caracteres.                                                                      |
| `expiration`        | `string`           | Sí        | Vencimiento del QR. Ver [Guía de expiración flexible](/payments/cobros-qr/guia-expiracion).                                   |
| `currency`          | `string` (enum)    | No        | Solo `"BOB"`. Default: `"BOB"`.                                                                                               |
| `singleUse`         | `boolean`          | No        | Si `true`, el QR se invalida tras el primer pago. Default: `true`.                                                            |
| `serviceCode`       | `string`           | No        | Código de clasificación del servicio. Default: `"001"`. Máx. 10 caracteres.                                                   |
| `payerDocument`     | `string` \| `null` | No        | CI/NIT del pagador esperado. Si se especifica, restringe el QR a ese pagador. Máx. 20 caracteres.                             |
| `externalReference` | `string` \| `null` | No        | ID de tu orden o carrito. Vuelve en la respuesta y en la consulta de estado. Máx. 64 caracteres.                              |
| `distribution`      | `object` \| `null` | No        | Split de fondos `{"cuenta": monto}`. Solo en CUCU Direct multi-destino. Si es `null`, se usa la configuración de tu comercio. |
| `metadata`          | `object` \| `null` | No        | Datos libres de tu sistema. Vuelven en la consulta de estado.                                                                 |

***

## Response — QR creado

| Campo               | Tipo                | Descripción                                                                       |
| ------------------- | ------------------- | --------------------------------------------------------------------------------- |
| `qrId`              | `string`            | Identificador del QR. Úsalo para consultar el estado.                             |
| `qrImageUrl`        | `string` \| `null`  | URL pública de la imagen PNG. `null` si no está disponible (usa `qrImageBase64`). |
| `qrImageBase64`     | `string`            | Imagen PNG en Base64. Siempre presente.                                           |
| `expiresAt`         | `string` (ISO 8601) | Vencimiento efectivo en UTC.                                                      |
| `amount`            | `Decimal`           | Monto del cobro.                                                                  |
| `currency`          | `string`            | Moneda del cobro.                                                                 |
| `status`            | `string` (enum)     | `PENDING` al crear.                                                               |
| `merchantCode`      | `string`            | Código de tu comercio en CUCU.                                                    |
| `externalReference` | `string` \| `null`  | La referencia que enviaste.                                                       |