Skip to main content
GET
/
api
/
v1
/
transfers
/
qr
/
{transactionId}
curl https://qrsimple.cucu.bo/api/v1/transfers/qr/QR2026061500001 \
  -H "Authorization: Bearer <tu_api_token>"

{
  "transactionId": "QR2026061500001",
  "status": "PAID",
  "commerceCode": "mi-comercio",
  "orders": [
    {
      "orderId": "ORD-BCK-00001",
      "amount": "150.00",
      "currency": "BOB",
      "paidAt": "2026-06-15T14:12:33Z",
      "payerDocument": "12345678",
      "payerName": "Juan Pérez",
      "payerAccount": "100000000001",
      "payerBank": "BNB",
      "status": "PAID"
    }
  ],
  "metadata": {
    "orderId": "ORD-2026-00871",
    "channel": "web"
  }
}
Devuelve el estado actual de una transacción QR e incluye el detalle de todas las órdenes de pago asociadas.

​
Headers

HeaderTipoReqDescripción
AuthorizationstringSíBearer <tu_api_token>

​
Path Params

ParámetroTipoDescripción
transactionIdstringID de la transacción devuelto al crearla. Ej: QR2026061500001.

​
Response

CampoTipoDescripción
transactionIdstringID único de la transacción.
statusstringEstado actual: PENDING, PAID, REJECTED, EXPIRED, CANCELLED, ERROR.
commerceCodestringSlug del comercio en CUCU.
ordersarrayLista de órdenes de pago asociadas al QR.
orders[].orderIdstringID de la orden en CUCU.
orders[].amountstringMonto de la orden.
orders[].paidAtstringTimestamp del pago (ISO 8601).
orders[].payerDocumentstringCI/NIT del pagador.
orders[].payerNamestringNombre del pagador.
orders[].payerBankstringBanco del pagador.
orders[].statusstringEstado de la orden: PAID, REJECTED.
metadataobjectDatos enviados al crear la transacción.
Aislamiento multi-comercio: un comercio solo puede consultar sus propias transacciones. Acceder a un transactionId de otro comercio devuelve 404 Not Found (no 403) para no confirmar la existencia del recurso.
curl https://qrsimple.cucu.bo/api/v1/transfers/qr/QR2026061500001 \
  -H "Authorization: Bearer <tu_api_token>"

{
  "transactionId": "QR2026061500001",
  "status": "PAID",
  "commerceCode": "mi-comercio",
  "orders": [
    {
      "orderId": "ORD-BCK-00001",
      "amount": "150.00",
      "currency": "BOB",
      "paidAt": "2026-06-15T14:12:33Z",
      "payerDocument": "12345678",
      "payerName": "Juan Pérez",
      "payerAccount": "100000000001",
      "payerBank": "BNB",
      "status": "PAID"
    }
  ],
  "metadata": {
    "orderId": "ORD-2026-00871",
    "channel": "web"
  }
}