GET /qr/{qrId} — Consultar estado - CUCU API

curl https://qrsimple.cucu.bo/api/v1/qr/<qrId> \
  -H "X-Api-Key: <tu_api_key>"

const response = await fetch(`https://qrsimple.cucu.bo/api/v1/qr/${qrId}`, {
  headers: { 'X-Api-Key': '<tu_api_key>' }
});
const estado = await response.json();

import requests

response = requests.get(
    f'https://qrsimple.cucu.bo/api/v1/qr/{qr_id}',
    headers={'X-Api-Key': '<tu_api_key>'}
)
print(response.json())

{
  "qrId": "<qrId>",
  "status": "PAID",
  "merchantCode": "cucu-mi-comercio",
  "orders": [
    {
      "orderId": "<orderId>",
      "amount": "150.00",
      "currency": "BOB",
      "paidAt": "2026-09-15T14:12:33Z",
      "payerName": "Juan Pérez",
      "payerDocument": "12345678",
      "payerBank": "BNB",
      "payerAccount": "100000000001",
      "status": "PAID"
    }
  ],
  "metadata": { "channel": "web" }
}

{
  "detail": "QR <qrId> no encontrado"
}

GET

/

api

/

v1

/

qr

/

{qrId}

curl https://qrsimple.cucu.bo/api/v1/qr/<qrId> \
  -H "X-Api-Key: <tu_api_key>"

const response = await fetch(`https://qrsimple.cucu.bo/api/v1/qr/${qrId}`, {
  headers: { 'X-Api-Key': '<tu_api_key>' }
});
const estado = await response.json();

import requests

response = requests.get(
    f'https://qrsimple.cucu.bo/api/v1/qr/{qr_id}',
    headers={'X-Api-Key': '<tu_api_key>'}
)
print(response.json())

{
  "qrId": "<qrId>",
  "status": "PAID",
  "merchantCode": "cucu-mi-comercio",
  "orders": [
    {
      "orderId": "<orderId>",
      "amount": "150.00",
      "currency": "BOB",
      "paidAt": "2026-09-15T14:12:33Z",
      "payerName": "Juan Pérez",
      "payerDocument": "12345678",
      "payerBank": "BNB",
      "payerAccount": "100000000001",
      "status": "PAID"
    }
  ],
  "metadata": { "channel": "web" }
}

{
  "detail": "QR <qrId> no encontrado"
}

Devuelve el estado actual de un QR y el detalle de los pagos recibidos.

Headers

Header	Tipo	Req	Descripción
`X-Api-Key`	string	Sí	Tu API key.

Path Params

Parámetro	Tipo	Descripción
`qrId`	string	El `qrId` devuelto al crear el QR.

Response

Campo	Tipo	Descripción
`qrId`	string	Identificador del QR.
`status`	string	`PENDING`, `PAID`, `REJECTED`, `EXPIRED`, `CANCELLED` o `ERROR`.
`merchantCode`	string	Código de tu comercio en CUCU.
`orders`	array	Pagos recibidos por este QR.
`orders[].orderId`	string	ID del pago.
`orders[].amount`	string	Monto pagado.
`orders[].currency`	string	`BOB`.
`orders[].paidAt`	string	Fecha y hora del pago (ISO 8601).
`orders[].payerName`	string	Nombre del pagador.
`orders[].payerDocument`	string	CI/NIT del pagador.
`orders[].payerBank`	string	Banco del pagador.
`orders[].payerAccount`	string	Cuenta del pagador.
`orders[].status`	string	`PAID` o `REJECTED`.
`metadata`	object	Los datos que enviaste al crear el QR.

Solo puedes consultar los QR de tu comercio. Un qrId de otro comercio responde 404, igual que uno inexistente.

curl https://qrsimple.cucu.bo/api/v1/qr/<qrId> \
  -H "X-Api-Key: <tu_api_key>"

const response = await fetch(`https://qrsimple.cucu.bo/api/v1/qr/${qrId}`, {
  headers: { 'X-Api-Key': '<tu_api_key>' }
});
const estado = await response.json();

import requests

response = requests.get(
    f'https://qrsimple.cucu.bo/api/v1/qr/{qr_id}',
    headers={'X-Api-Key': '<tu_api_key>'}
)
print(response.json())

{
  "qrId": "<qrId>",
  "status": "PAID",
  "merchantCode": "cucu-mi-comercio",
  "orders": [
    {
      "orderId": "<orderId>",
      "amount": "150.00",
      "currency": "BOB",
      "paidAt": "2026-09-15T14:12:33Z",
      "payerName": "Juan Pérez",
      "payerDocument": "12345678",
      "payerBank": "BNB",
      "payerAccount": "100000000001",
      "status": "PAID"
    }
  ],
  "metadata": { "channel": "web" }
}

{
  "detail": "QR <qrId> no encontrado"
}