Flujos de excepción

Débito al originador: Flujo de excepción

Durante el proceso de preparación o confirmación del débito la Entidad Participante podría tener inconvenientes técnicos o errores por validación en reglas de negocio. Para este caso, se detalla el flujo de excepción y los servicios que interactuan

sequenceDiagram
autonumber
 participant tb as Entidad Origen
 participant ach as ACH En Línea
 
 tb ->> +ach: Creación de la tx
  Note over ach,tb: POST /v1/money-movement/transfers
  ach -->> +tb: 200 OK
  ach ->> +tb: Llama al prepare debit 
 status: prepare
    Note over tb,ach: POST /v1/debits
 tb -->> +ach: 200 OK
tb ->> +tb: Falla la preparación de fondos

tb ->>+ach: Confirma error o fallo en preparación del debit
status: failed
Note over tb,ach: POST /v1/money-movement/transfers/{id}/status
 ach -->> +tb: 200 OK

ach ->> -tb: Llama al abort del debit 
 status: abort
  Note over ach,tb: POST /v1/debits/{idDebit}/abort
tb -->>+ach: 200 OK

 tb ->>+ach: Confirma abort
 status: aborted
Note over tb,ach: POST /v1/money-movement/transfers/{id}/status
 ach -->> +tb: 200 OK

ach ->> -tb: Confirma estafo final 
 status: rejected
  Note over ach,tb: PUT v1/transfers/{id} 
  tb -->> +ach: 200 OK

Crédito al beneficiario: Flujo de excepción

Durante el proceso de preparación o confirmación del crédito la Entidad Participante podría tener inconvenientes técnicos o errores por validación en reglas de negocio. Para este caso, se detalla el flujo de excepción y los servicios que interactuan

sequenceDiagram
 autonumber
 participant ach as ACH En Línea
 participant tb as Entidad Receptora

 ach ->> tb: Llama al prepare credit 
 status: prepare
    note over ach,tb: POST /v1/credits
 tb -->> ach: 200 OK
 tb ->> tb: Falla la preparación del crédito


 tb ->>+ach: Confirma error o fallo en preparación del credit
 status: failed
Note over tb,ach: POST /v1/money-movement/transfers/{id}/status
 ach -->> +tb: 200 OK

ach ->>+tb: Llama al abort del credit 
 status: abort
    Note over ach,tb: POST /v1/credits/{idCredit}/abort
tb -->>+ach: 200


 tb ->> +ach: Confirma abort 
 Status: aborted
 Note over tb,ach: POST /v1/money-movement/transfers/{id}/status
ach -->> +tb: 200 OK

 ach ->> -tb: Confirma estado final
 status: rejected
  Note over ach,tb: PUT v1/transfers/{id} 
  tb -->> +ach: 200 OK
 

Las causales de rechazo que se describen a continuación, deben ser enviadas por la Entidad Participante dentro del proceso de excepción para la preparación de débito o del crédito. El código y descripción deberán ser enviados al servicio /v1/money-movement/transfers/{id}/status expuesto por ACH En-línea

Dominio: https://bank.apihub.crt.achcolombia.com.co

POST v1/money-movement/transfers/{id}/status

Campos de entrada

curl --location 'https://url_ach/v1/money_movement/transfers/{id}/status' \
--header 'hash: 695ffdf84f0dad0c19e3b8b09a4565246c156d747ffb26149e4c2dc5d3b66ca1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJkZW1vLXVzdWFyaW8iLCJyb2xlIjoiYXBwLXRlc3QiLCJpYXQiOjE3MDAwMDAwMDAsImV4cCI6MTcwMDA4NjQwMH0.abc123xyz987fakeSignatureOnlyForDemoPurposes' \
--data '{
    "meta": {
        "requestId": "45cdaa41-b567-4057-9fb7-7240efdfb437",
        "version": "1.0.0",
        "timestamp": "2026-06-15T14:27:28.001"
    },
    "data": {
        "movementType": "P2P-TRANSFER",
        "status": "failed",
        "creationDateTime": "2026-06-15T14:27:28.001",
        "debitId": "deb_03rgXTmRB7aI7jomy",
        "coreId": "13456278395678906789"
    },
    "custom": {
        "error": {
            "code": "bridge.account-not-found",
            "description": "1039: Cuenta no encontrada"
        }
    }
}'

HTTP/1.1 200 OK
Content-Length: 0