Cómo consultar QR

Especificaciones para consultar QR

Las Entidades Participantes pueden consultar un QR a través del servicio de consulta.

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

Campos de entrada consulta de QR

Basta con enviar el Id del QR dentro del path de la petición.

Campos de salida consulta QR

Campo Tipo Descripción Formato
meta object Objeto de metadatos N/A
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 Objeto de datos N/A
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 Objeto de error N/A
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

Response consulta de QR

Response exitoso

{
  "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.RED0103ACH5303170540410005802CO5913Julian 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",
    "lastModifiedDateTime": "2026-01-16T01:51:46.706Z",
    "imageB64": "iVBORw0KGgoAAAANSUhEUgAAAUQAAAFECAYAAABf6kfGAAAAAklEQVR4AewaftIAABl5SURBVO3BQW7A1pLAQFLwaMCbTq1QMEyU7oKvsH6y11uJirbXW7WKttdbtYq211u1irbXW7WKttdbtYq211u1irbXW7WKttdbtYq211u1irbXW7WKttdbtYq211u1irbXW7WKttdbtYq211u2H/a/MCbTq1QMEyU7+oKvsH6y11uJirbXW7WKttdbtYq211u1irbXW7WKttdbtYq211u1irbXW7WKttdbtYq211u1irbXW7WKttdbtYq211u1irbXW7WKttdbtYq211u2Hl1T+UsWk8kTFpDJVPKHyRMWk8kTFpDJVT"
  }
}

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 QR Anterior