Cómo consultar QR
Especificaciones para consultar QR
Las Entidades Participantes pueden consultar un QR a través del servicio de consulta.
Dominio: https://bank.apihub.crt.achcolombia.com.co
GET v1/money-movements/instruments/{id} o idQr={tag90}
El id a consultar en el path podrá ser el entregado en la generación del QR o el idQR(Tag90).
Campos de entrada para consulta de QR - Header
| Campo | Tipo | Validación | Descripción | Obligatoriedad |
|---|---|---|---|---|
| Authorization | cadena | Min 1 – Máx 64 | Bearer token OAuth2. | Sí |
| x-movementType | lista | lista | Valores validos: QR-STATIC, QR-DYNAMIC. | Sí |
| X-Client-Id | cadena | Min 1 – Máx 64 | Client Id del Participante | Sí |
| idempotencyKey | cadena | Min 1 – Máx 64 | Identificador unico generado por la Entidad consumidora | Sí |
Campos de entrada consulta de QR
Basta con enviar el id o idQR(tag90) dentro del path de la petición.
Campos de salida consulta QR
| Campo | Tipo | Descripción | Formato |
|---|---|---|---|
| meta | objeto | Objeto de metadatos | N/A |
| requestId | uuid | Código generado por la entidad participante para identificar el paquete | a1b2c3d4-e5f6-7890-abcd-ef1234567890 |
| timestamp | fecha | Fecha y hora de la respuesta a la solicitud de generación del código QR | 2025-12-23T18:16:35.099Z |
| status | cadena | Estado de la respuesta. SUCCESS, FAILED | cadena |
| statusCode | cadena | Código HTTP de la respuesta | cadena |
| statusDesc | cadena | Descripción del código HTTP | cadena |
| data | cadena | Objeto de datos | cadena |
| id | cadena | Identificador único del QR en el sistema | a1b2c3d4-e5f6-7890-abcd-ef1234567890 |
| qrCode | cadena | Cadena de texto que contiene el código QR generado en formato EMVCO | Cadena TLV |
| creationDateTime | fecha | Fecha y hora en la que se generó el QR | 2025-12-23T18:16:35.099Z |
| qrStatus | cadena | Estado actual del QR | cadena |
| duration | entero | Vigencia del QR. Tiempo durante el cual el QR es válido | 60 |
| expirationDateTime | fecha | Fecha y hora de expiración del QR | 2025-12-23T18:16:35.099Z |
| lastModifiedDateTime | fecha | Fecha y hora en la que se modificó el estado del QR | 2025-12-23T18:16:35.099Z |
| imageB64 | cadena | Imagen del QR en Base 64 | Binario del QR en Base 64 |
| error | objeto | Objeto de error | N/A |
| code | cadena | Código de error generado (cero si no hay errores) | 1005 |
| message | cadena | Mensaje de error (vacío si no hay errores) | Fallas técnicas |
Response consulta de QR
Response exitoso
{
"meta": {
"requestId": "7c3e1f90-a2b4-4c6d-9e8f-1234567890ab",
"timestamp": "2026-10-13T13:45:02.376Z",
"status": "SUCCESS",
"statusCode": "200",
"statusDesc": "Consulta procesada correctamente"
},
"data": {
"id": "8f2a4b10-cd56-11f1-90ab-0a8201b70000",
"qrCode": "00020101021226320014CO.COM.ACH.LLA...",
"creationDateTime": "2026-09-29T00:10:50.236Z",
"qrStatus": "PAID",
"duration": 3600,
"expirationDateTime": "2026-09-29T01:10:50.236Z",
"lastModificationDate": "2026-09-29T00:10:50.236Z",
"imageB64": "iVBORw0KGgoAAAANSUhEUgAAASwAAAEsCAYAAAB5..."
}
}
Response error 4XX
{
"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"
}
}
Response error 5XX
{
"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"
}
}
Orderarticle 6
