- 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
Como enviar marcas de tiempo
El flujo regulatorio exige enviar marcas de tiempo dentro del procesamiento transaccional. ACH En Línea dispone el servicio POST: v1/money-movements/transfers/{id}/status para que las Entidades Participantes envíen las marcas de tiempo al momento requerido por la regulación.
Campos de entrada marcas de tiempo
| Campo | Tipo | Validación | Descripción | Obligatoriedad |
|---|---|---|---|---|
| Authorization | String | Min 1 – Máx 64 | Bearer token OAuth2. | Si |
| x-hash | String | Min 64 – Máx 64 | Cadena de comprobación de integridad de la trama. Serializar el objeto data y aplicar SHA256. | Si |
Campos de entrada actualizacion de marcas de tiempo (body)
| Campo | Tipo | Validación | Longitud | Obligatoriedad |
|---|---|---|---|---|
| data | objeto | N/A | N/A | SI |
| movementType | lista | Identificador del schema del flujo transaccional. Ver tabla “VALORES PARA LAS LOS MOVEMENT TYPE” | lista | SI |
| status | cadena | Estado en el que quedará la transacción. Ver tabla "VALORES PARA LAS ACCIONES Y ESTADOS (status)" | Lista | SI |
| creationDateTime | fecha | Marca de tiempo del evento de regulación | Ver tabla "REGLAS PARA LOS VALORES DE TIPO FECHA" | SI |
| debitId | string | Identificador del débito o crédito | Min 1 Max 36 | SI |
| coreId | cadena | Identificador interno del banco | Min 1 Max 255 | SI |
| useCaseInformation | objeto | Objeto para informar marcas de tiempo | N/A | COND. Obligatorio si se enviarán marcas de tiempo |
| timestamps | sub-objeto | Objeto para informar marcas de tiempo | N/A | COND. Obligatorio si se enviarán marcas de tiempo |
| received | fecha | Objeto para informar marcas de tiempo. Todos los campos de fecha deben tener este formato: - AAAA-MM-DDThh:mm:ss.sss Reglas para el dato: - Formato ISO 8601 hora local con milisegundos. - No lleva la Z - Expresado en hora Colombiana (UTC-5). | N/A | COND. Obligatorio si se enviarán marcas de tiempo |
| dispatched | fecha | Objeto para informar marcas de tiempo. Todos los campos de fecha deben tener este formato: - AAAA-MM-DDThh:mm:ss.sss Reglas para el dato: - Formato ISO 8601 hora local con milisegundos. - No lleva la Z - Expresado en hora Colombiana (UTC-5). | N/A | COND. Obligatorio si se enviarán marcas de tiempo |
Request actualización del transfer
curl --location 'https://url_ach/v1/money-movement/transfers/{id}/status' \
--header 'hash: 695ffdf84f0dad0c19e3b8b09a4565246c156d747ffb26149e4c2dc5d3b66ca1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJkZW1vLXVzdWFyaW8iLCJyb2xlIjoiYXBwLXRlc3QiLCJpYXQ iOjE3MDAwMDAwMDAsImV4cCI6MTcwMDA4NjQwMH0.abc123xyz987fakeSignatureOnlyForDemoPurposes' \
--data '{...}' Data:
{
"data": {
"movementType": "P2P-BREB",
"status": "prepared",
"creationDateTime": "2026-03-15T10:30:05.000",
"debitId": "DBT-20260315-0000000123",
"coreId": "CORE-12345",
"useCaseInformation": {
"timestamps": {
"received": "2026-03-15T10:29:58.000",
"dispatched": "2026-03-15T10:29:59.500"
}
}
}
Response registro marcas de tiempo
{
"meta": {
"requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"timestamp": "2026-03-15T10:30:05.000",
"status": "SUCCESS",
"statusCode": "200",
"statusDesc": "OK"
},
"data": {
"id": "20260315800037800TFY000000000001246",
"status": "prepared",
"creationDateTime": "2026-03-15T10:30:05.000",
"movementType": "P2P-BREB"
}
} El status que enviará en el cuerpo del mensaje no será tenido en cuenta como el estado de la transacción.
Orderarticle 7
