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

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.