- Cómo enviar cuenta a cuenta
- Cómo debitar al usuario origen
- Cómo aceptar la transferencia
- Cómo acreditar al beneficiario
- Notificación estado final
- Como consultar una transferencia
- Gestión de errores servicios ACH En-línea
- Flujos de excepción
- Tablas de referencia
- Token de autenticación
- PSE Abono en Línea
Como consultar una transferencia
Consultar una transferencia
En caso de requerirse, las Entidades Participantes pueden consultar el estado actual de una transacción.El id del path corresponde al identificador de la transacción asignado por la Entidad Participante Origen al momento de creación de la transacción.
Dominio: https://bank.apihub.crt.achcolombia.com.co GET v1/money-movement/transfers/{id} Campos de entrada (Headers)
| Campo | Tipo | Validación | Descripción | Obligatoriedad |
|---|---|---|---|---|
| movementType | Lista | Corresponde al tipo de transacción a consultar | Identificador del schema del flujo transaccional. | Si |
Request consulta de transferencia
curl --location – request GET 'https://url_ach/v1/money-movement/transfers/{id}' \
--header 'x-movementType: xxxxxx \
--header 'Authorization: Bearer gfdfgfgfhfgfgsdsdsd'
Campos de salida consulta de transferencia
| Campo | Tipo | Validación | Descripción | Obligatoriedad |
|---|---|---|---|---|
| data | objeto | N/A | N/A | SI |
| id | cadena | Min 1 Max 36 | Identificador único de la transacción | SI |
| status | cadena | N/A | Estado de la transacción | SI |
| creationDateTime | fecha | Formato fecha | Momento de la respuesta al participante | SI |
| movementType | lista | Valores validos para el campo | Identificador del schema del flujo transaccional. | SI |
| custom | objeto | objeto | N/A | COND. Si el "status:rejected o aborted" se envía el objeto con los campos |
| error | objeto | objeto | N/A | COND. Si el "status:rejected o aborted" se envía el objeto con los campos |
| code | cadena | Código de error del rechazo o fallo | Min 1 - Max 255 | COND. Si el "status:rejected o aborted" se envía el objeto con los campos |
| description | cadena | Descripción del rechazo o fallo | Min 1 - Max 255 | COND. Si el "status:rejected o aborted" se envía el objeto con los campos |
Response consulta estado: completed
{
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "completed",
"creationDateTime": "2026-08-21T10:15:30-05:00",
"movementType": "P2P-TRANSFER"
}
}
Response consulta estado: rejected - aborted
{
"data": {
"id": "20261013ACHENLINEA641410443566124",
"status": "aborted",
"creationDateTime": "2026-10-13T16:39:52.269",
"movementType": "B2P-TRANSFER",
"custom": {
"error": {
"code": "316",
"description": "bridge.transfer-information-invalid - La informacion de la transferencia no es valida"
}
}
}
}
Orderarticle 7
