Como notificar la transferencia

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:

  • COMITED: si el procesamiento fue exitoso.
  • REJECT: si ocurrió un error, pero la transferencia fue correctamente revertida y todos los movimientos de saldo fueron deshechos.

Campos de entrada actualización de transferencia

Campo Tipo Validación Longitud Mapeo de datos
data objeto N/A N/A N/A
id cadena Identificador único de la transferencia Min 1 Max 36 transfers.data.handle
status cadena Estado final de la transferencia. Ver tabla "VALORES PARA LAS ACCIONES Y ESTADOS (status)" lista meta.status
creationDateTime fecha Fecha y hora de la notificación Ver tabla "REGLAS PARA LOS VALORES DE TIPO FECHA" N/A
movementType lista Identificador del schema del flujo transaccional lista transfers.data.schema

Request actualización de transferencia

curl --location --request PUT 'https://url_participante/v1/transfers/{id}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJkZW1vLXVzdWFyaW8iLCJyb2xlIjoiYXBwLXRlc3QiLCJpYXQiOjE3MDAwMDAwMDAsImV4cCI6MTcwMDA4NjQwMH0.abc123xyz987fakeSignatureOnlyForDemoPurposes' \
--data '{...}'

Data:

{
  "data": {
    "id": "string",
    "status": "string",
    "creationDateTime": "fecha",
    "movementType": ["lista"]
  }
}

Response actualización de transferencia

HTTP/1.1 200 OK
Content-Length: 0
Orderarticle 5
Cómo acreditar al beneficiario Anterior