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
Cómo acreditar al beneficiario Anterior