- 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
Notificación estado final
Notificación del estado final
En este paso final, ACH En Línea hace consumo del servicio v1/transfers/{id} expuesto por las Entidades. El id corresponde al enviado por la Entidad durante la creación de la transacción o en su defecto, al generado por ACH En Línea.
La transferencia podrá tener los siguientes estados finales:
- completed: si el procesamiento fue exitoso.
- rejected - aborted: si ocurrió un error, pero la transferencia fue correctamente revertida y todos los movimientos de saldo fueron deshechos.
Dominio: URL Base entidad PUT /v1/transfers/{id} Campos de entrada notificación estado final
| Campo | Tipo | Validación | Descripción | Obligatoriedad |
|---|---|---|---|---|
| data | objeto | N/A | N/A | SI |
| id | cadena | Identificador único de la transacción | Min 1 Max 36 | SI |
| status | cadena | Estado de la transacción. Ver Tablas de referencia: "Estados de las transacciones". | Para estados finales, los valores serán: completed rejected | SI |
| creationDateTime | fecha | Momento de la respuesta al participante | N/A | SI |
| movementType | lista | Identificador del schema del flujo transaccional. Ver Tablas de referencia: "Valores para el campo movementType". | Lista | 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 |
Request notificación estado final: completed
{
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "completed",
"creationDateTime": "2026-08-21T10:15:30-05:00",
"movementType": "P2P-TRANSFER"
}
}
Request notificación estado final: 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"
}
}
}
}
Response notificación estado final
HTTP/1.1 200 OK
Content-Length: 0 Orderarticle 6
