Cómo aceptar la transferencia

Validación de aceptación por el banco destino

Una vez confirmado el débito, ACH En Línea ejecuta controles antifraude sobre la transferencia y contacta a la Entidad Receptora para solicitar la aceptación del pago (prepare credit). Este paso permite a la Entidad Receptora validar la información de la cuenta destino y confirmar que el pago puede ser recibido correctamente.

Durante esta etapa, la Entidad Receptora debe realizar las siguientes validaciones:

1. Que la cuenta destino exista.
2. Que la cuenta esté activa y habilitada para recibir pagos.
3. Que los datos del beneficiario coincidan con los de la cuenta.
4. Que el monto de la transferencia no supere los límites definidos por la Entidad Receptora.

La notificación de este paso lo realiza la Entidad Participante Receptora a través de la respuesta al llamado orquestado por ACH En Línea para la preparación del crédito.

Aceptación de la transferencia – Paso detallado

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

    ach ->> +tb: Llama al prepare credit
    Note over tb,ach: /v1/credits
    tb -->> -ach: 200 OK
    tb ->> +tb: Valida que la cuenta exista
    tb ->> tb: Valida que la cuenta esté activa
    tb ->> tb: Valida que los datos del beneficiario coincidan con la cuenta
    tb ->> tb: Valida montos y reglas de negocio
    alt las validaciones no se cumplen
        tb ->> -ach: Envía rechazo
    end
    tb ->> +ach: Confirma prepare credit
    Note over ach,tb: /v1/money-movements/transfers/{id}/status
    ach ->> -tb: 200 OK

1. ACH En Línea llama al banco receptor para procesar la operación de preparación del crédito

ACH En Línea inicia el proceso mediante una solicitud POST al endpoint v1/credits del banco receptor, con la información completa de la transferencia.

Campos de entrada preparación del crédito

Request preparación del crédito

curl --location 'https://url_participante/v1/credits' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2Vy
SWQiOiJkZW1vLXVzdWFyaW8iLCJyb2xlIjoiYXBwLXRlc3QiLCJpYXQ iOjE3MDAwMDAwMDAsImV4cCI6MTcwMDA4NjQwMH0.abc123xyz987fakeSignatureOnlyForDemoPurposes' \
--data '{...}'

Data:

{
    "meta": {
        "id": "string",
        "status": "string"
    },
    "data": {
        "creditId": "string",
        "movementType": ["lista"],
        "amountInformation": {
            "amount": "decimal",
            "currency": ["lista"]
        },
        "source": {
            "personType": ["lista"],
            "document": {
                "number": "string",
                "type": ["lista"],
                "fullName": "string",
                "firstName": "string",
                "secondName": "string",
                "firstLastName": "string",
                "secondLastName": "string"
            },
            "spbviCode": ["lista"],
            "accountInformation": {
                "accountId": "string",
                "accountType": ["lista"],
                "financialInstitutionId": "entero"
            }
        },
        "target": {
            "personType": ["lista"],
            "document": {
                "number": "string",
                "type": ["lista"],
                "fullName": "string",
                "firstName": "string",
                "secondName": "string",
                "firstLastName": "string",
                "secondLastName": "string"
            },
            "targetSpbviCode": ["lista"],
            "alias": {
                "aliasType": ["lista"],
                "aliasValue": "string"
            },
            "accountInformation": {
                "accountId": "string",
                "accountType": ["lista"],
                "financialInstitutionId": "entero"
            },
            "qr": {
                "qrId": "string"
            }
        }
    }
}

2. Validaciones de reglas de negocio y demás controles (Paso 2 al 5)

La Entidad Receptora ejecuta las validaciones de reglas de negocio y demás controles sobre el beneficiario.

3. Procesar rechazo de la transferencia (Paso 7)

En caso de que aplique y las validaciones de la Entidad Participante hayan generado alguna novedad. La transferencia debe rechazarse, por ende, la Entidad debe enviar el respectivo rechazo via POST al endpoint v1/money-movements/transfers/{id}/status.

Campos de entrada rechazo

Campos de entrada rechazo (Headers)

Campos de entrada rechazo (Body)

Request rechazo

curl --location 'https://url_ach/v1/money-movements/transfers/{id}/status' \
--header 'x-hash: 695ffdf84f0dad0c19e3b8b09a4565246c156d747ffb26149e4c2dc5d3b66ca1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.
eyJ1c2VySWQiOiJkZW1vLXVzdWFyaW8iLCJyb2xlIjoiYXBwLXRlc3QiLCJpYXQ iOjE3MDAwMDAwMDAsImV4cCI6
MTcwMDA4NjQwMH0.abc123xyz987fakeSignatureOnlyForDemoPurposes' \
--data '{...}'

{
    "data": {
        "status": "REJECTED",
        "creationDateTime": "2026-05-15T14:30:00Z",
        "coreId": "string",
        "operation": "string"
    }
}

Campos de salida rechazo

Response rechazo

{
    "data": {
        "id": "string",
        "status": "REJECTED",
        "creationDateTime": "2026-05-15T14:30:00Z",
        "movementType": ["lista"]
    }
}

4. Confirma preparación del crédito (Paso 8)

La Entidad Receptora envía la confirmación de la preparación del crédito a ACH En Línea. Solicitud POST al endpoint v1/money-movements/transfers/{id}/status

Campos de entrada confirmación preparación crédito

Campos de entrada confirmación de la preparación del crédito (header)

Campos de entrada confirmación del crédito (body)

Request confirmación preparación del crédito

curl --location 'https://url_ach/v1/money-movements/transfers/{id}/status' \
--header 'x-hash: 695ffdf84f0dad0c19e3b8b09a4565246c156d747ffb26149e4c2dc5d3b66ca1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyS
WQiOiJkZW1vLXVzdWFyaW8iLCJyb2xlIjoiYXBwLXRlc3QiLCJpYXQ iOjE3MDAwMDAwMDAsImV4cCI6MTcwMDA4NjQwMH0.abc123xyz987fakeSignatureOnlyForDemoPurposes' \
--data '{...}'

{
    "data": {
        "status": "string",
        "creationDateTime": "2026-05-15T14:30:00Z",
        "coreId": "string",
        "operation": "string"
    }
}

Response confirmación preparación del crédito

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