Cómo enviar a Bre-b

Origen y destino de la transferencia

Las transferencias reguladas se definen como transferencias de cuenta a cuenta. Estas transacciones no deberían diferenciarse de las transferencias actuales entre cuentas en ACH En Línea.

Nota: La resolución de llaves debe realizarse antes de crear una transferencia.

Concepto Transfers

ACH En Línea utiliza el concepto de “transfers” para iniciar pagos en el sistema agnósticos al caso de uso o tipo de transferencia.

Identificador de flujo

Cuando se inicia un transfer se activa uno de los flujos de pago orquestados por la plataforma.

El flujo es definido por el campo movementType dentro del Transfers, que para el caso de transferencias reguladas debe ser alguno de estos valores: P2P-BREB, P2B-BREB, B2B-BREB y B2P-BREB.

Ejemplo de una transferencia regulada

 

Campos de entrada creación de transferencia

Campos de entrada (Headers)

Campos de entrada (Body)

Request creación de transferencia

curl --location 'https://url_ach/v1/money_movements/transfers' \
--header 'x-hash: 695ffdf84f0dad0c19e3b8b09a4565246c156d747ffb26149e4c2dc5d3b66ca1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXX' \
--data '{...}'

Data:

{
    "meta": {
        "requestId": "cadena",
        "version": "cadena",
        "timestamp": "fecha"
    },
    "data": {
        "id": "cadena",
        "movementType": ["lista"],
        "amountInformation": {
            "amount": "decimal",
            "currency": ["lista"]
        },
        "source": {
            "personType": ["lista"],
            "document": {
                "number": "cadena",
                "type": ["lista"],
                "fullName": "cadena",
                "firstName": "cadena",
                "secondName": "cadena",
                "firstLastName": "cadena",
                "secondLastName": "cadena"
            },
            "accountInformation": {
                "accountId": "cadena",
                "accountType": ["lista"],
                "financialInstitutionId": "entero"
            }
        },
        "target": {
            "personType": ["lista"],
            "document": {
                "number": "cadena",
                "type": ["lista"],
                "fullName": "cadena",
                "firstName": "cadena",
                "secondName": "cadena",
                "firstLastName": "cadena",
                "secondLastName": "cadena"
            },
            "spbviCode": ["lista"],
            "alias": {
                "aliasType": ["lista"],
                "aliasValue": "cadena"
            },
            "qr": {
                "qrId": "cadena",
                "accountInformation": {
                    "accountId": "cadena",
                    "accountType": ["lista"],
                    "financialInstitutionId": "entero"
                }
            }
        },
        "purposeInformation": {
            "transactionPurpose": ["lista"]
        },
        "useCaseInformation": {
            "channel": ["lista"]
        },
        "timestamps": {
            "received": "fecha",
            "dispatched": "fecha"
        },
        "deviceFingerprint": {
            "deviceHash": "cadena",
            "ipAddress": "cadena",
            "ipLocation": "cadena",
            "ipCountryCode": "cadena",
            "deviceIpRegion": "cadena",
            "deviceIsp": "cadena",
            "deviceModel": "cadena",
            "latitude": "cadena",
            "longitude": "cadena",
            "deviceScreenHeight": "cadena",
            "deviceScreenWidth": "cadena",
            "deviceLanguage": "cadena",
            "deviceCookiesEnabled": "cadena",
            "deviceUserAgent": "cadena",
            "deviceBrowser": "cadena",
            "deviceBrowserVersion": "cadena",
            "deviceOs": "cadena"
        }
    }
}

Campos de salida creación de transferencia

Response creación de transferencia

{
    "meta": {
        "requestId": "string",
        "version": "string",
        "timestamp": "2026-02-23T15:20:50Z"
    },
    "data": {
        "id": "string",
        "movementType": "string",
        "status": "string",
        "creationDateTime": "2026-02-23T15:20:50Z"
    }
}

Campo id:identificación única asignada por la Entidad Participante origen de la transacción “YYYYMMDD#########TFY000000000000005”

• YYYYMMDD: fecha (8 caracteres), en horario local y que corresponde a la fecha del momento en que el SPBVI originador recibe la confirmación de la orden de pago y/o transferencia de fondo inmediata por parte del Participante Originador.
• NIT: (9 caracteres - #########) NIT del Participante Originador (sin dígito de verificación) o código asignado por el BR.
• Sigla del SPBVI Originador TFY: Corresponde a la abreviación del Sistema de Pago de Bajo Valor Inmediato Originador.
• Secuencia (15 dígitos): Número ascendente que debe ser único para cada fecha en formato “YYYYMMDD”. Si el valor tiene menos de 15 dígitos, se debe completar con ceros a la izquierda como en el ejemplo.

Aceptación en el flujo regulado

En el modelo regulado, la aceptación de una transferencia no depende de una acción explícita por parte del usuario final, como podría suceder en flujos tradicionales. Sin embargo, sí requiere de una validación formal por parte de la entidad financiera que actúa como banco receptor.

Este paso de aceptación es obligatorio antes de continuar con el procesamiento y consiste en que la entidad receptora verifique que la cuenta destino:

• Existe y está activa.
• Está habilitada para recibir pagos.
• Cumple con los requisitos establecidos por la regulación, como los límites de monto o tipo de moneda.

Una vez realizada esta validación, el banco destinatario confirma la aceptación utilizando el mecanismo estándar ya existente en ACH En Línea para flujos asincrónicos. Esta aceptación por parte de la entidad equivale a una aprobación regulatoria que habilita a continuar con la operación de crédito y la posterior liquidación a través del MOL.

Modelo de liquidación

Una vez que MOL entre en funcionamiento, cada transferencia deberá enviarse a MOL para su procesamiento y se pausará el procesamiento interno hasta recibir una llamada de continuación desde MOL.