Especificaciones para actualización de estado del QR
Las Entidades Participantes pueden actualizar el estado del QR una vez haya sido usado y se requiera dar de baja.Dominio: https://bank.apihub.crt.achcolombia.com.co
PATCH /ach/bk/v1/money-movement/qr/{id}
Estados soportados
| Estado | Tipo de QR | Descripción |
|---|---|---|
| ACTIVE | Estático / Dinámico | Todo QR inicia en este estado. Indica que está disponible para pago. |
| INACTIVE | Solo Estático | Estado final. El QR ya no está disponible para recibir pagos. |
| CANCELED | Solo Dinámico | Estado final. El comercio lo canceló antes de cualquier transacción. |
| PAID | Solo Dinámico | Estado final. Se recibió la notificación de pago exitosa. El QR no puede volverse a usar. |
| EXPIRED | Solo Dinámico | Estado final. Se superó el tiempo de vigencia del QR. No puede utilizarse. |
Transiciones Permitidas — QR Estático
| Estado Actual | Evento / Causa | Estado Siguiente |
|---|---|---|
| ACTIVE | Solicitud de inhabilitación | INACTIVE |
Transiciones Permitidas — QR Dinámico
| Estado Actual | Evento / Causa | Estado Siguiente |
|---|---|---|
| ACTIVE | Comercio cancela | CANCELED |
| ACTIVE | Notificación exitosa de pago | PAID |
| ACTIVE | Expira vigencia | EXPIRED |
Máquina de Estados QR Estáticos
Campos de Entrada
| Campo | Tipo | Descripción | Formato | Obligatorio |
|---|---|---|---|---|
| meta | object | SI | ||
| requestId | uuid | Código generado por la entidad participante para identificar el paquete | a1b2c3d4-e5f6-7890-abcd-ef1234567890 | SI |
| timestamp | datetime | Fecha y hora de la solicitud de generación del código QR | 2025-12-23T18:16:35.099Z | SI |
| version | string | Versión del esquema, enviar el valor “1.0” | 1.0 | SI |
| data | object | SI | ||
| movementType | enum | Tipo de operación a realizar. [QR, QRVALIDATE, QRPARSER] | QR | SI |
| status | enum | Estado de código QR. [INACTIVE, CANCELED, PAID] | PAID | SI |
{
"meta": {
"requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"timestamp": "2026-01-16T01:48:22.252Z",
"version": "1.0"
},
"data": {
"movementType": "QR",
"status": "INACTIVE"
}
}
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 | 123e4567-e89b-12d3-a456-426614174000 |
| qrStatus | string | Estado actual del QR | ACTIVE |
| lastModifiedDateTime | datetime | Fecha y hora en la que se modificación el estado del QR | 2026-01-16T01:51:46.706Z |
| 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 |
{
"meta": {
"requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"timestamp": "2026-01-16T01:51:46.706Z",
"status": "SUCCESS",
"statusCode": "200",
"statusDesc": "string"
},
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"qrStatus": "INACTIVE",
"lastModifiedDateTime": "2026-01-16T01:51:46.706Z"
}
}
{
"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"
}
}