Cómo enviar cuenta a cuenta

Guia sobre transferencias cuenta a cuenta

El flujo base de ACH En Línea permite procesar transferencias reguladas y no reguladas a través de esquemas dinámicos referenciados en el campo MovementType. El sistema al detectar el valor para el flujo no regulado habilita las capacidades requeridas para el procesamiento de la transaccional no regulada (sin aplicar los topes de Bre-B y sin liquidación en el MOL).

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-TRANSFER, P2B-TRANSFER, B2B-TRANSFER y B2P-TRANSFER.

 

Ejemplo de una transferencia no 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.

Aceptación en el flujo no regulado

La aceptación de una transferencia no depende de una acción explícita por parte del usuario final. 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.

Modelo de liquidación

Para el flujo no regulado, ACH En Línea implementa su propio mecanismo de liquidación y compensación a través de Prefondeo y reintegro de recursos soportados a través del movimiento de dinero en las cuentas CUD de las Entidades Participantes y ACH Colombia.