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
Cómo actualizar estado QR Anterior