Skip to main content

​
Especificaciones para actualización de estado del QR

Las Entidades Participantes pueden consultar un QR. 
Dominio: https://bank.apihub.achcolombia.com.co

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

CampoTipoDescripciónFormato
metaobject
requestIduuidCódigo generado por la entidad participante para identificar el paquetea1b2c3d4-e5f6-7890-abcd-ef1234567890
timestampdatetimeFecha y hora de la respuesta a la solicitud de generación del código QR2025-12-23T18:16:35.099Z
statusenumEstado de la respuesta. SUCCESS, ERRORSUCCESS
statusCodestringCódigo HTTP de la respuesta200
statusDescstringDescripción del código HTTPOK
dataobject
idstringIdentificador único del QR en el sistemaa1b2c3d4-e5f6-7890-abcd-ef1234567890
qrCodestringCadena de texto que contiene el código QR generado en formato EMVCOCadena TLV
creationDateTimedatetimeFecha y hora en la que se generó el QR2025-12-23T18:16:35.099Z
qrStatusstringEstado actual del QRPAGADO
durationintegerVigencia del QR. Tiempo durante el cual el QR es válido60
expirationDateTimedatetimeFecha y hora de expiración del QR (ISO 8601, UTC-0 con “Z”)2025-12-23T18:16:35.099Z
lastModifiedDateTimedatetimeFecha y hora en la que se modificó el estado del QR2025-12-23T18:16:35.099Z
imageB64stringImagen del QR en Base 64Binario del QR en Base 64
errorobject
codeintegerCódigo de error generado (cero si no hay errores)1005
messagestringMensaje de error (vacío si no hay errores)Fallas técnicas

​
Campos de Salida:

{
  "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"
  }
}