Contexto Integración

Contexto de integración a ACH En-línea

Las Entidades Participantes deberán implementar las capacidades tecnológicas y operativas descritas a continuación, con el fin de garantizar una integración adecuada y el correcto procesamiento transaccional a través de ACH En Línea. Es importante tener en cuenta que únicamente puede mantenerse activa una integración sobre una sola versión de ACH En Línea. En ningún caso se permite la coexistencia de integraciones activas en múltiples versiones del servicio de forma simultánea.

Responsabilidades Técnicas de las Entidades Participantes

  • Consumir los servicios y APIs de ACH En-línea de acuerdo con las especificaciones técnicas.
  • Implementar la integración mediante el consumo de APIs, recomendándose el uso de una capa de integración o desacoplamiento que permita aislar los sistemas internos de la Entidad Participante de los servicios expuestos por ACH Colombia
  • Generar los mecanismos de integridad requeridos para la construcción y validación de los mensajes, de acuerdo con las especificaciones técnicas definidas por ACH Colombia.
  • Implementar los servicios a través de una única URL.
  • Exponer las APIs requeridas para el procesamiento de transferencias y operaciones asociadas, incluyendo servicios de débito, crédito, consulta de estado, notificaciones y demás capacidades definidas en las especificaciones técnicas vigentes.
  • Implementar certificados SSL/TLS:Emitidos por entidades certificadoras autorizadas por la ONAC, certificados independientes por ambiente (certificación y producción) y TLS 1.2 o superior.
  • Implementar los mecanismos de autenticación y autorización requeridos: Basic Auth
  • Entregar en la mensajería la información que permita identificar las características del dispositivo desde el cual el usuario realiza la transferencia, implementando las especificaciones de Fingerprint entregadas por ACH COLOMBIA o utilizando un componente propio de perfilamiento de dispositivo. Esta información será utilizada para el análisis de prevención de fraude y podrá ser capturada o no en el dispositivo origen.

Especificaciones técnicas del Certificado Digital para los servicios expuesto por las Entidades

  • Algoritmo de firma: RSA ≥ 2048 bits, ECDSA ≥ 224 bits, DSA ≥ 112 bits (o algoritmos equivalentes o superiores en nivel de seguridad).
  • Algoritmo hash de la firma: SHA-256 o superior.
  • Algoritmo de cifrado de clave pública: RSA ≥ 2048 bits, ECDSA u otros algoritmos equivalentes o superiores.
  • Algoritmo de identificación: SHA2 o superior.
  • Vigencia del certificado: Fecha de inicio y fecha fin de acuerdo con las vigencias que demande la industria.
  • Usos permitidos de la clave (Key Usage): Firma digital, cifrado de clave, autenticación del cliente, correo seguro (certificado de representación legal), no repudio, cifrado de datos, acuerdo de clave (certificado de pertenencia a la empresa).
  • Este certificado únicamente se manejará con el uso del E-Token (Certificado de representación legal).

** Campos opcionales y dependerán de la CA emisora del certificado.

Servicios expuestos por ACH En-línea:

Método Servicio Descripción
POST https://bank.apihub.crt.achcolombia.com.co/ach/bk/apihub-bank/oauth2/token URL Autenticación
POST https://bank.apihub.crt.achcolombia.com.co/ach/bk/v1/money-movement/transfers Creación de transferencias
GET https://bank.apihub.crt.achcolombia.com.co/ach/bk/v1/money-movement/transfers/{id} Consulta de transferencia
POST https://bank.apihub.crt.achcolombia.com.co/ach/bk/v1/money-movement/transfers/{id}/status Confirmar (preparación o commit)

Servicios expuestos por las Entidades:

Método Servicio Descripción
POST https://URL Base Entidad/oauth/token URL Autenticación
POST https://URL Base Entidad/v1/debits Preparación débito
POST https://URL Base Entidad/v1/debits/{idDebit}/commit Procesar débito
POST https://URL Base Entidad/v1/debits/{idDebit}/abort Abortar débito
POST https://URL Base Entidad/v1/credits Preparación crédito
POST https://URL Base Entidad/v1/credits/{idCredit}/commit Procesar crédito
POST https://URL Base Entidad/v1/credits/{idCredit}/abort Abortar crédito
PUT https://URL Base Entidad/v1/transfers/{id} Notificación estado final
Orderarticle 1
Token de autenticación Anterior