Como consultar un QR - Transfiya Guide

Especificaciones para actualización de estado del QR

Las Entidades Participantes pueden consultar un QR.

Dominio: https://bank.apihub.crt.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

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:

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

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

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

⌘I