curl https://qrsimple.cucu.bo/api/v1/transfers/qr/QR2026061500001 \
-H "Authorization: Bearer <tu_api_token>"
const response = await fetch(
'https://qrsimple.cucu.bo/api/v1/transfers/qr/QR2026061500001',
{ headers: { 'Authorization': 'Bearer <tu_api_token>' } }
);
const data = await response.json();
import requests
response = requests.get(
'https://qrsimple.cucu.bo/api/v1/transfers/qr/QR2026061500001',
headers={'Authorization': 'Bearer <tu_api_token>'}
)
print(response.json())
{
"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"
}
}
{
"detail": "Transaction not found"
}
Endpoints
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.
GET
/
api
/
v1
/
transfers
/
qr
/
{transactionId}
curl https://qrsimple.cucu.bo/api/v1/transfers/qr/QR2026061500001 \
-H "Authorization: Bearer <tu_api_token>"
const response = await fetch(
'https://qrsimple.cucu.bo/api/v1/transfers/qr/QR2026061500001',
{ headers: { 'Authorization': 'Bearer <tu_api_token>' } }
);
const data = await response.json();
import requests
response = requests.get(
'https://qrsimple.cucu.bo/api/v1/transfers/qr/QR2026061500001',
headers={'Authorization': 'Bearer <tu_api_token>'}
)
print(response.json())
{
"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"
}
}
{
"detail": "Transaction not found"
}
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. |
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>"
const response = await fetch(
'https://qrsimple.cucu.bo/api/v1/transfers/qr/QR2026061500001',
{ headers: { 'Authorization': 'Bearer <tu_api_token>' } }
);
const data = await response.json();
import requests
response = requests.get(
'https://qrsimple.cucu.bo/api/v1/transfers/qr/QR2026061500001',
headers={'Authorization': 'Bearer <tu_api_token>'}
)
print(response.json())
{
"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"
}
}
{
"detail": "Transaction not found"
}
⌘I