- Cómo enviar a Bre-b
- Cómo debitar al usuario origen
- Cómo aceptar la transferencia
- Cómo acreditar al beneficiario
- Notificación estado final
- Como enviar marcas de tiempo
- Cómo reintentar créditos
- Lineamientos del flujo regulatorio
- Errores del MOL
- Como consultar una transferencia
- Gestión de errores servicios ACH En-línea
- Flujos de excepción
- Tablas de referencia
- Token de autenticación
- Contexto Integración
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
