> ## Documentation Index
> Fetch the complete documentation index at: https://transfiya.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Como consultar un QR

### Especificaciones para actualización de estado del QR

Las Entidades Participantes pueden consultar un QR.

```json theme={null}
Dominio: https://bank.apihub.crt.achcolombia.com.co
```

```json theme={null}
GET /ach/bk/v1/money-movement/qr/{id} 
```

NOTA: Enviar el ID del QR (el que se entregó en la generación del mismo) en el path

### Campos de Salida

| **Campo**            | **Tipo**   | **Descripción**                                                         | **Formato**                          |
| -------------------- | ---------- | ----------------------------------------------------------------------- | ------------------------------------ |
| **meta**             | **object** |                                                                         |                                      |
| requestId            | uuid       | Código generado por la entidad participante para identificar el paquete | a1b2c3d4-e5f6-7890-abcd-ef1234567890 |
| timestamp            | datetime   | Fecha y hora de la respuesta a la solicitud de generación del código QR | 2025-12-23T18:16:35.099Z             |
| status               | enum       | Estado de la respuesta. SUCCESS, ERROR                                  | SUCCESS                              |
| statusCode           | string     | Código HTTP de la respuesta                                             | 200                                  |
| statusDesc           | string     | Descripción del código HTTP                                             | OK                                   |
| **data**             | **object** |                                                                         |                                      |
| id                   | string     | Identificador único del QR en el sistema                                | a1b2c3d4-e5f6-7890-abcd-ef1234567890 |
| qrCode               | string     | Cadena de texto que contiene el código QR generado en formato EMVCO     | Cadena TLV                           |
| creationDateTime     | datetime   | Fecha y hora en la que se generó el QR                                  | 2025-12-23T18:16:35.099Z             |
| qrStatus             | string     | Estado actual del QR                                                    | PAGADO                               |
| duration             | integer    | Vigencia del QR. Tiempo durante el cual el QR es válido                 | 60                                   |
| expirationDateTime   | datetime   | Fecha y hora de expiración del QR (ISO 8601, UTC-0 con “Z”)             | 2025-12-23T18:16:35.099Z             |
| lastModifiedDateTime | datetime   | Fecha y hora en la que se modificó el estado del QR                     | 2025-12-23T18:16:35.099Z             |
| imageB64             | string     | Imagen del QR en Base 64                                                | Binario del QR en Base 64            |
| **error**            | **object** |                                                                         |                                      |
| code                 | integer    | Código de error generado (cero si no hay errores)                       | 1005                                 |
| message              | string     | Mensaje de error (vacío si no hay errores)                              | Fallas técnicas                      |

### Campos de Salida:

<CodeGroup>
  ```json Response Exitoso theme={null}
  {
    "meta": {
      "requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "timestamp": "2026-01-16T01:51:46.706Z",
      "status": "SUCCESS",
      "statusCode": "string",
      "statusDesc": "string"
    },
    "data": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "qrCode": "00020101021126320014CO.COM.ACH.LLA0510000169664749250014CO.COM.ACH.RED0103ACH5303170540410005802CO5913Julián Suarez6006Bogota610611405662110701008020080270016CO.COM.ACH.CANAL0103POS81250015CO.COM.ACH.CIVA01020382230014CO.COM.ACH.IVA0101083240015CO.COM.ACH.BASE0101084250015CO.COM.ACH.CINC01020385230014CO.COM.ACH.INC0101090590016CO.COM.ACH.TRXID0135CO.COM.ACH.RED34E81961EB12640F5B2D191860014CO.COM.ACH.SEC01648f66c1e3a2e6b0ee5358cd566f935eec8d30efb218f33aa17b316542fe2ab1b06304ACEA",
      "creationDateTime": "2026-01-16T01:51:46.706Z",
      "qrStatus": "ACTIVE",
      "duration": 60,
      "expirationDateTime": "2026-01-16T01:51:46.706Z",
      "imageB64": "iVBORw0KGgoAAAANSUhEUgAAAUQAAAFECAYAAABf6kfGAAAAAklEQVR4AewaftIAABl5SURBVO3BQW7A1pLAQFLw/a/MCbTq1QMEyU7+oKvsH6y11uJirbXW7WKttdbtYq211u1irbXW7WKttdbtYq211u1irbXW7WKttdbtYq211u1irbXW7WKttdbtYq211u1irbXW7WKttdbtYq211u2Hl1T+UsWk8kTFpDJVPKHyRMWk8kTFpDJVT"
    }
  }
  ```

  ```json Response Error 400 theme={null}
  {
    "meta": {
      "requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "timestamp": "2026-01-15T00:03:39.558Z",
      "status": "ERROR",
      "statusCode": "400",
      "statusDesc": "Bad Request"
    },
    "error": {
      "code": "1013",
      "message": "El contenido enviado no es válido o está mal cifrado"
    }
  }
  ```

  ```json Response Error 500 theme={null}
  {
    "meta": {
      "requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "timestamp": "2026-01-15T00:03:39.558Z",
      "status": "ERROR",
      "statusCode": "500",
      "statusDesc": "Internal Server Error"
    },
    "error": {
      "code": "1005",
      "message": "Fallas Técnicas"
    }
  }
  ```
</CodeGroup>