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

# GET /transfers/qr/{transactionId} — Consultar estado

> Devuelve el estado actual de una transacción QR e incluye el detalle de todas las órdenes de pago asociadas.

Devuelve el estado actual de una transacción QR e incluye el detalle de todas las órdenes de pago asociadas.

## Headers

| Header          | Tipo   | Req | Descripción             |
| --------------- | ------ | --- | ----------------------- |
| `Authorization` | string | Sí  | `Bearer <tu_api_token>` |

## Path Params

| Parámetro       | Tipo   | Descripción                                                      |
| --------------- | ------ | ---------------------------------------------------------------- |
| `transactionId` | string | ID de la transacción devuelto al crearla. Ej: `QR2026061500001`. |

## Response

| Campo                    | Tipo   | Descripción                                                                    |
| ------------------------ | ------ | ------------------------------------------------------------------------------ |
| `transactionId`          | string | ID único de la transacción.                                                    |
| `status`                 | string | Estado actual: `PENDING`, `PAID`, `REJECTED`, `EXPIRED`, `CANCELLED`, `ERROR`. |
| `commerceCode`           | string | Slug del comercio en CUCU.                                                     |
| `orders`                 | array  | Lista de órdenes de pago asociadas al QR.                                      |
| `orders[].orderId`       | string | ID de la orden en CUCU.                                                        |
| `orders[].amount`        | string | Monto de la orden.                                                             |
| `orders[].paidAt`        | string | Timestamp del pago (ISO 8601).                                                 |
| `orders[].payerDocument` | string | CI/NIT del pagador.                                                            |
| `orders[].payerName`     | string | Nombre del pagador.                                                            |
| `orders[].payerBank`     | string | Banco del pagador.                                                             |
| `orders[].status`        | string | Estado de la orden: `PAID`, `REJECTED`.                                        |
| `metadata`               | object | Datos enviados al crear la transacción.                                        |

<Note>
  **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.
</Note>

<RequestExample>
  ```bash cURL theme={"system"}
  curl https://qrsimple.cucu.bo/api/v1/transfers/qr/QR2026061500001 \
    -H "Authorization: Bearer <tu_api_token>"
  ```

  ```javascript JavaScript theme={"system"}
  const response = await fetch(
    'https://qrsimple.cucu.bo/api/v1/transfers/qr/QR2026061500001',
    { headers: { 'Authorization': 'Bearer <tu_api_token>' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={"system"}
  import requests

  response = requests.get(
      'https://qrsimple.cucu.bo/api/v1/transfers/qr/QR2026061500001',
      headers={'Authorization': 'Bearer <tu_api_token>'}
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "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"
    }
  }
  ```

  ```json 404 Not Found theme={"system"}
  {
    "detail": "Transaction not found"
  }
  ```
</ResponseExample>