- 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
Cómo aceptar la transferencia
Validación de aceptación por el banco destino
Una vez confirmado el débito, ACH En Línea ejecuta controles antifraude sobre la transferencia y contacta a la Entidad Receptora para solicitar la aceptación del pago (prepare credit). Este paso permite a la Entidad Receptora validar la información de la cuenta destino y confirmar que el pago puede ser recibido correctamente.
Durante esta etapa, la Entidad Receptora debe realizar las siguientes validaciones:
- Que la cuenta destino exista.
- Que la cuenta esté activa y habilitada para recibir pagos.
- Que los datos del beneficiario coincidan con los de la cuenta.
- Que el monto de la transferencia no supere los límites definidos por la Entidad Receptora.
- Demás validaciones aplicables para el modelo Bre-b.
La notificación de este paso lo realiza la Entidad Participante Receptora a través de la respuesta al llamado orquestado por ACH En Línea para la preparación del crédito.
Aceptación de la transferencia – Paso a paso detallado
sequenceDiagram
autonumber
participant ach as ACH En Línea
participant tb as Entidad Receptora
ach ->> tb: Llama al prepare credit
status: pending
Note over tb,ach: POST /v1/credits
tb -->> ach: 200 OK
tb ->> tb: Validar que
la cuenta exista
tb ->> tb: Validar que
la cuenta esté activa
tb ->> tb: Validar que
los datos del benficiario
coincidan con la cuenta
tb ->> tb: Validar montos
y reglas de negocio
tb ->> tb: Validar otras
reglas de negocio
tb ->> ach: Confirma preparación del credit
status: prepared
note over tb,ach: POST /v1/money-movement/transfers/{id}/status
ach -->> +tb: 200 OK
1. ACH En Línea llama a la Entidad Receptora para procesar la operación de preparación del crédito
ACH En Línea inicia el proceso mediante una solicitud POST al endpoint v1/credits de la Entidad Receptora, con la información completa de la transferencia. Estado "pending"
Dominio: URL Base Entidad POST /v1/credits Campos de entrada preparación del crédito
| Campo | Tipo | Validación | Longitud | Obligatoriedad |
|---|---|---|---|---|
| meta | objeto | N/A | N/A | SI |
| id | cadena | Identificador único de la transacción. | Min 1 Max 36 | SI |
| status | cadena | Estado de la transacción. Ver Tablas de referencia: "Estados de las transacciones". | Min 1 Max 8 | SI |
| data | objeto | N/A | N/A | SI |
| creditId | cadena | Identificador del credit prepare, el banco debe guardar este valor. | Min 1 Max 36 | SI |
| movementType | lista | Identificador del schema del flujo transaccional. Ver Tablas de referencia: "Valores para el campo movementType". | Lista | SI |
| amountInformation | objeto | N/A | N/A | SI |
| amount | decimal | Valor de la transacción. 13 enteros, 2 decimales, siempre mayor que cero. El monto máximo por transacción corresponde a 250 MM. | (13,2) | SI |
| currency | lista | Valor por defecto "COP" | Lista | SI |
| source | objeto | N/A | N/A | SI |
| personType | lista | Tipo de persona que originda la transacción. Ver Tablas de referencia: "Valores para el campo personType". | lista | SI |
| document | objeto | N/A | N/A | SI |
| number | cadena | Número de identificación del ordenante del pago. Solo números, si el campo type es NIT. El valor no debe superar los 9 dígitos y sin caracteres especiales. | entero | SI |
| type | lista | Tipo de identificación del ordenante del pago. Ver Tablas de referencia: "Tipos de documento". | lista | SI |
| fullName | cadena | Nombre comercial, se usa para persona jurídica. | Min 1 Max 160 | COND Obligatorio si personType es LEGAL |
| firstName | cadena | Primer nombre | Min 1 Max 40 | Obligatorio si personType es NATURAL |
| secondName | cadena | Segundo nombre | Min 1 Max 40 | NO |
| firstLastName | cadena | Primer apellido | Min 1 Max 40 | Obligatorio si personType es NATURAL |
| secondLastName | cadena | Segundo apellido | Min 1 Max 40 | NO |
| accountInformation | objeto | N/A | N/A | SI |
| accountId | cadena | Número de cuenta del origen de la transacción. | Min 1 Max 34 | SI |
| accountType | lista | Tipo de cuenta del origen de la transacción. | lista | SI |
| financialInstitutionId | entero | Identificador de la entidad origen. Número NIT sin dígito de verificación y sin caracteres especiales. | Min 1 Max 9 | SI |
| target | objeto | N/A | N/A | SI |
| personType | lista | Tipo de persona beneficiaria de la transacción. Ver Tablas de referencia: "Valores para el campo personType". | lista | SI |
| document | Objeto | N/A | N/A | SI |
| number | cadena | Número de identificación del beneficiario del pago. Solo números, si el campo type es NIT. El valor no debe superar los 9 dígitos y sin caracteres especiales. | entero | SI |
| type | lista | Tipo de identificación del beneficiario del pago. Ver Tablas de referencia: "Tipos de documento". | lista | SI |
| fullName | cadena | Nombre comercial, se usa para persona jurídica. | Min 1 Max 160 | COND Obligatorio si personType es LEGAL |
| firstName | cadena | Primer nombre | Min 1 Max 40 | Obligatorio si personType es NATURAL |
| secondName | cadena | Segundo nombre | Min 1 Max 40 | NO |
| firstLastName | cadena | Primer apellido | Min 1 Max 40 | Obligatorio si personType es NATURAL |
| secondLastName | cadena | Segundo apellido | Min 1 Max 40 | NO |
| targetSpbviCode | lista | Código del SPBVI receptor | lista | SI |
| alias | objeto | N/A | N/A | SI |
| aliasType | lista | Tipo de llave | lista | SI |
| aliasValue | cadena | Valor de la llave | Min 1 Max 92 | SI |
| accountInformation | objeto | N/A | N/A | SI |
| accountId | cadena | Número de cuenta del beneficiario de la transacción. | Min 1 Max 34 | SI |
| accountType | lista | Tipo de cuenta del beneficiario de la transacción. | lista | SI |
| financialInstitutionId | entero | Identificador de la entidad destino. Número NIT sin dígito de verificación y sin caracteres especiales. | Min 1 Max 9 | SI |
| qr | objeto | N/A | N/A | COND. Se recibe si la transacción corresponde a la lectura de un QR Bre-B |
| qrId | cadena | Identificación del QR obtenido del proceso de lectura | Min 35 Max 35 | COND. Se recibe si la transacción corresponde a la lectura de un QR Bre-B |
Request preparación del crédito
curl --location 'https://url_participante/v1/credits' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJkZW1vLXVzdWFyaW8iLCJyb2xlIjoiYXBwLXRlc3QiLCJpYXQiOjE3MDAwMDAwMDAsImV4cCI6MTcwMDA4NjQwMH0.abc123xyz987fakeSignatureOnlyForDemoPurposes' \
--data '{...}' Data:
{
"meta": {
"id": "debf4f70-c30d-4f27-95e6-2f96b91c0001",
"status": "pending"
},
"data": {
"debitId": "9d2f9ed9-7fdb-4d3b-a7bf-8cd1a8e50001",
"movementType": "B2P-TRANSFER",
"amountInformation": {
"amount": 2500000.00,
"currency": "COP"
},
"source": {
"personType": "LEGAL",
"document": {
"number": "900123456",
"type": "NIT"
},
"fullName": "COMERCIALIZADORA ABC SAS",
"accountInformation": {
"accountId": "200012345678",
"accountType": "CCTE",
"financialInstitutionId": 900123456
}
},
"target": {
"personType": "NATURAL",
"document": {
"number": "1020304050",
"type": "CC"
},
"firstName": "CARLOS",
"firstLastName": "RAMIREZ",
"targetSpbviCode": "TFY",
"alias":{
"aliasType": "PHONE",
"aliasValue": "314567890"
},
"accountInformation": {
"accountId": "3001234567",
"accountType": "CAHO",
"financialInstitutionId": 860987654
}
"qr":{
"qrId": "CO.COM.ACH.TRXID6A1AB61E0E8ADAB4BB9"
}
}
}
} Response preparación del crédito
HTTP/1.1 200 OK
Content-Length: 0 2. Validaciones de reglas de negocio y demás controles
Después de recibir la solicitud de preparación del crédito, La Entidad Participante realiza todas las validaciones de reglas de negocio y controles para garantizar la integridad de la operación. Si alguna validación no se cumple, se rechaza la operación. Si todas se validan correctamente, se procede con la confirmación.
3. Procesar rechazo de la transferencia
Si alguna de las validaciones no se cumple, la Entidad Participante receptora rechaza la operación enviando una solicitud al endpoint v1/money-movement/transfers/{id}/status con el estado "failed".
Dominio: https://bank.apihub.crt.achcolombia.com.co POST v1/money-movement/transfers/{id}/status Campos de entrada rechazo
Campos de entrada error en la preparación del crédito (header)
| Campo | Tipo | Validación | Descripción | Obligatoriedad |
|---|---|---|---|---|
| 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 error en la preparación del crédito (body)
| Campo | Tipo | Validación | Longitud | Obligatoriedad |
|---|---|---|---|---|
| meta | Objeto | N/A | N/A | SI |
| requestId | cadena | UUID que identifica el mensaje. | Min 36 - Max 36 | SI |
| version | cadena | versión del protocolo de mensajería. valor fijo "1.0.0" | Min 1 Max 15 | SI |
| timestamp | fecha | Marca de tiempo de envío del mensaje | N/A | SI |
| data | objeto | N/A | N/A | SI |
| movementType | lista | Identificador del schema del flujo transaccional. Ver Tablas de referencia: "Valores para el campo movementType". | Lista | SI |
| status | cadena | Estado de la transacción. Ver Tablas de referencia: "Estados de las transacciones". | Lista | SI |
| creationDateTime | fecha | Momento en el que se confirma la preparación del débito o crédito | N/A | SI |
| creditId | cadena | Identificador del credit prepare, el banco debe enviar el valor que corresponde a la transferencia. Este valor fue entregado por ACH En-línea en el llamado al endpoint /v1/credits. | Min 1 Max 36 | COND Si la acción es un débito se debe informar este campo |
| coreId | cadena | Código de error ACH (Debe corresponder a los especificados en el capitulo "Flujos de excepción") | Min 1 Max 255 | SI |
| custom | objeto | N/A | N/A | COND Si el status = failed o aborted. Se debe informar este objeto con sus campos. |
| error | subobjeto | N/A | N/A | COND |
| code | cadena | Identificador del error en sistema core ACH En-línea. (Debe corresponder a los especificados en el capitulo "Flujos de excepción") | Min 1 Max 36 | COND |
| description | cadena | Descripción del error. (Debe corresponder a los especificados en el capitulo "Flujos de excepción") | Min 1 Max 255 | COND |
Request rechazo
curl --location 'https://url_ach/v1/money_movement/transfers/{id}/status' \
--header 'hash: 695ffdf84f0dad0c19e3b8b09a4565246c156d747ffb26149e4c2dc5d3b66ca1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJkZW1vLXVzdWFyaW8iLCJyb2xlIjoiYXBwLXRlc3QiLCJpYXQiOjE3MDAwMDAwMDAsImV4cCI6MTcwMDA4NjQwMH0.abc123xyz987fakeSignatureOnlyForDemoPurposes' \
--data '{
"meta": {
"requestId": "45cdaa41-b567-4057-9fb7-7240efdfb437",
"version": "1.0.0",
"timestamp": "2026-06-15T14:27:28.001"
},
"data": {
"movementType": "P2P-TRANSFER",
"status": "failed",
"creationDateTime": "2026-06-15T14:27:28.001",
"creditId": "deb_03rgXTmRB7aI7jomy",
"coreId": "B105"
},
"custom": {
"error": {
"code": "bridge.account-not-found",
"description": "Cuenta del usuario receptor no existe"
}
}
}' Response rechazo preparación crédito
HTTP/1.1 200 OK
Content-Length: 0 4. ACH En-línea solicita abortar crédito
ACH En-línea solicita a la Entidad Participnte receptora abortar la transferencia, consumiendo el servicio v1/credits/{idCredit}/abort con el estado "aborted".
Dominio: URL Base Entidad POST v1/credits/{idCredit}/abort Campos de entrada abort del crédito
| Campo | Tipo | Validación | Longitud | Obligatoriedad |
|---|---|---|---|---|
| meta | objeto | N/A | N/A | SI |
| id | cadena | Identificador único de la transacción | Min 1 Max 36 | SI |
| status | cadena | Estado de la transacción. Ver Tablas de referencia: "Estados de las transacciones". | Min 1 Max 8 | SI |
| custom | objeto | N/A | N/A | COND. Si el "status:aborted" se envía el objeto con los campos |
| error | objeto | N/A | N/A | COND. Si el "status:aborted" se envía el objeto con los campos |
| code | cadena | Código de error del rechazo o fallo | Min 1 Max 255 | COND. Si el "status:aborted" se envía el objeto con los campos |
| description | cadena | Descripción del rechazo o fallo | Min 1 Max 255 | COND. Si el "status:aborted" se envía el objeto con los campos |
| data | objeto | N/A | N/A | N/A |
| creditId | cadena | Identificador único del crédito | Min 1 Max 36 | SI |
| movementType | lista | Identificador del schema del flujo transaccional. Ver Tablas de referencia: "Valores para el campo movementType". | Lista | SI |
| amountInformation | objeto | N/A | N/A | SI |
| amount | decimal | Valor de la transacción. 13 enteros, 2 decimales, siempre mayor que cero. El monto máximo por transacción corresponde a 250 MM. | (13,2) | SI |
| currency | lista | Valor por defecto "COP" | Lista | SI |
| source | objeto | N/A | N/A | SI |
| personType | lista | Tipo de persona que originda la transacción. Ver Tablas de referencia: "Valores para el campo personType". | lista | SI |
| document | objeto | N/A | N/A | SI |
| number | cadena | Número de identificación del ordenante del pago. Solo números, si el campo type es NIT. El valor no debe superar los 9 dígitos y sin caracteres especiales. | entero | SI |
| type | lista | Tipo de identificación del ordenante del pago. Ver Tablas de referencia: "Tipos de documento". | lista | SI |
| fullName | cadena | Nombre comercial, se usa para persona jurídica | Min 1 Max 160 | COND Obligatorio si personType es LEGAL |
| firstName | cadena | Primer nombre | Min 1 Max 40 | Obligatorio si personType es NATURAL |
| secondName | cadena | Segundo nombre | Min 1 Max 40 | NO |
| firstLastName | cadena | Primer apellido | Min 1 Max 40 | Obligatorio si personType es NATURAL |
| secondLastName | cadena | segundo apellido | Min 1 Max 40 | NO |
| accountInformation | objeto | N/A | N/A | SI |
| accountId | cadena | Número de cuenta del origen de la transacción. | Min 1 Max 34 | SI |
| accountType | lista | Tipo de cuenta del origen de la transacción. | lista | SI |
| financialInstitutionId | entero | Identificador de la entidad origen. Número NIT sin dígito de verificación y sin caracteres especiales. | Min 1 Max 9 | SI |
| target | objeto | N/A | N/A | SI |
| personType | lista | Tipo de persona beneficiaria de la transacción. Ver Tablas de referencia: "Valores para el campo personType". | lista | SI |
| document | Objeto | N/A | N/A | SI |
| number | cadena | Número de identificación del beneficiario del pago. Solo números, si el campo type es NIT. El valor no debe superar los 9 dígitos y sin caracteres especiales. | entero | SI |
| type | lista | Tipo de identificación del beneficiario del pago. Ver Tablas de referencia: "Tipos de documento". | lista | SI |
| fullName | cadena | Nombre comercial, se usa para persona jurídica | Min 1 Max 160 | COND Obligatorio si personType es LEGAL |
| firstName | cadena | Primer nombre | Min 1 Max 40 | Obligatorio si personType es NATURAL |
| secondName | cadena | Segundo nombre | Min 1 Max 40 | NO |
| firstLastName | cadena | Primer apellido | Min 1 Max 40 | Obligatorio si personType es NATURAL |
| secondLastName | cadena | segundo apellido | Min 1 Max 40 | NO |
| targetSpbviCode | lista | Código del SPBVI receptor | lista | SI |
| alias | objeto | N/A | N/A | SI |
| aliasType | lista | Tipo de llave | lista | SI |
| aliasValue | cadena | Valor de la llave | Min 1 Max 92 | SI |
| accountInformation | objeto | N/A | N/A | SI |
| accountId | cadena | Número de cuenta del beneficiario de la transacción. | Min 1 Max 34 | SI |
| accountType | lista | Tipo de cuenta del beneficiario de la transacción. | lista | SI |
| financialInstitutionId | entero | Identificador de la entidad destino. Número NIT sin dígito de verificación y sin caracteres especiales. | Min 1 Max 9 | SI |
| qr | objeto | N/A | N/A | COND. Se recibe si la transacción corresponde a la lectura de un QR Bre-B |
| qrId | cadena | Identificación del QR obtenido del proceso de lectura | Min 35 Max 35 | COND. Se recibe si la transacción corresponde a la lectura de un QR Bre-B |
Request abort del credito
curl --location 'https://url_participante/v1/credits/{idCredit}/abort' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJkZW1vLXVzdWFyaW8iLCJyb2xlIjoiYXBwLXRlc3QiLCJpYXQiOjE3MDAwMDAwMDAsImV4cCI6MTcwMDA4NjQwMH0.abc123xyz987fakeSignatureOnlyForDemoPurposes' \
--data '{...}' Data:
{
"meta": {
"id": "debf4f70-c30d-4f27-95e6-2f96b91c0001",
"status": "aborted"
},
"data": {
"debitId": "9d2f9ed9-7fdb-4d3b-a7bf-8cd1a8e50001",
"movementType": "B2P-TRANSFER",
"amountInformation": {
"amount": 2500000.00,
"currency": "COP"
},
"source": {
"personType": "LEGAL",
"document": {
"number": "900123456",
"type": "NIT"
},
"fullName": "COMERCIALIZADORA ABC SAS",
"accountInformation": {
"accountId": "200012345678",
"accountType": "CCTE",
"financialInstitutionId": 900123456
}
},
"target": {
"personType": "NATURAL",
"document": {
"number": "1020304050",
"type": "CC"
},
"firstName": "CARLOS",
"firstLastName": "RAMIREZ",
"targetSpbviCode": "TFY",
"alias":{
"aliasType": "PHONE",
"aliasValue": "314567890"
},
"accountInformation": {
"accountId": "3001234567",
"accountType": "CAHO",
"financialInstitutionId": 860987654
}
"qr":{
"qrId": "CO.COM.ACH.TRXID6A1AB61E0E8ADAB4BB9"
}
}
}
} Response abort del crédito
HTTP/1.1 200 OK
Content-Length: 0 5. Entidad confirma abort del crédito
La Entidad Receptora envía la confirmación del abort del crédito a ACH En Línea enviando la confirmación al servicio expuesto por ACH En-líneav1/money-movement/transfers/{id}/status con el estado "aborted".
Dominio: https://bank.apihub.crt.achcolombia.com.co POST v1/money-movement/transfers/{id}/status Campos de entrada abort del crédito (header)
| Campo | Tipo | Validación | Descripción | Obligatoriedad |
|---|---|---|---|---|
| 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 abort del crédito (body)
| Campo | Tipo | Validación | Longitud | Obligatoriedad |
|---|---|---|---|---|
| meta | Objeto | N/A | N/A | SI |
| requestId | cadena | UUID que identifica el mensaje. | Min 36 - Max 36 | SI |
| version | cadena | versión del protocolo de mensajería. valor fijo "1.0.0" | Min 1 Max 15 | SI |
| timestamp | fecha | Marca de tiempo de envío del mensaje | N/A | SI |
| data | objeto | N/A | N/A | SI |
| movementType | lista | Identificador del schema del flujo transaccional. Ver Tablas de referencia: "Valores para el campo movementType". | Lista | SI |
| status | cadena | Estado de la transacción. Ver Tablas de referencia: "Estados de las transacciones". | Lista | SI |
| creationDateTime | fecha | Momento en el que se confirma la preparación del débito o crédito | N/A | SI |
| creditId | cadena | Identificador del credit prepare, el banco debe enviar el valor que corresponde a la transferencia. Este valor fue entregado por ACH En-línea en el llamado al endpoint /v1/credits. | Min 1 Max 36 | COND Si la acción es un débito se debe informar este campo |
| coreId | cadena | Código de error ACH (Debe corresponder a los especificados en el capitulo "Flujos de excepción") | Min 1 Max 255 | SI |
| custom | objeto | N/A | N/A | COND Si el status = failed o aborted. Se debe informar este objeto con sus campos. |
| error | subobjeto | N/A | N/A | COND |
| code | cadena | Identificador del error en sistema core ACH En-línea. (Debe corresponder a los especificados en el capitulo "Flujos de excepción") | Min 1 Max 36 | COND |
| description | cadena | Descripción del error. (Debe corresponder a los especificados en el capitulo "Flujos de excepción") | Min 1 Max 255 | COND |
Request confirmación abort del crédito
curl --location 'https://url_ach/v1/money_movement/transfers/{id}/status' \
--header 'hash: 695ffdf84f0dad0c19e3b8b09a4565246c156d747ffb26149e4c2dc5d3b66ca1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJkZW1vLXVzdWFyaW8iLCJyb2xlIjoiYXBwLXRlc3QiLCJpYXQiOjE3MDAwMDAwMDAsImV4cCI6MTcwMDA4NjQwMH0.abc123xyz987fakeSignatureOnlyForDemoPurposes' \
--data '{
"meta": {
"requestId": "45cdaa41-b567-4057-9fb7-7240efdfb437",
"version": "1.0.0",
"timestamp": "2026-06-15T14:27:28.001"
},
"data": {
"movementType": "P2P-BRER",
"status": "aborted",
"creationDateTime": "2026-06-15T14:27:28.001",
"creditId": "deb_03rgXTmRB7aI7jomy",
"coreId": "B105"
},
"custom": {
"error": {
"code": "bridge.account-not-found",
"description": "Cuenta del usuario receptor no existe"
}
}
}' Response confirmación abort del crédito
HTTP/1.1 200 OK
Content-Length: 0 6. Confirma preparación del crédito (Happy path)
La Entidad Receptora envía la confirmación de la preparación del crédito a ACH En Línea enviando la confirmación al servicio expuesto por ACH En-líneav1/money-movement/transfers/{id}/status con el estado "prepared".
Dominio: https://bank.apihub.crt.achcolombia.com.co POST v1/money-movement/transfers/{id}/status Campos de entrada confirmación preparación crédito
Campos de entrada confirmación preparación crédito (header)
| Campo | Tipo | Validación | Descripción | Obligatoriedad |
|---|---|---|---|---|
| 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 confirmación preparación del crédito (Body)
| Campo | Tipo | Validación | Longitud | Obligatoriedad |
|---|---|---|---|---|
| meta | Objeto | N/A | N/A | SI |
| requestId | cadena | UUID que identifica el mensaje. | Min 36 - Max 36 | SI |
| version | cadena | versión del protocolo de mensajería. valor fijo "1.0.0" | Min 1 Max 15 | SI |
| timestamp | fecha | Marca de tiempo de envío del mensaje | N/A | SI |
| data | objeto | N/A | N/A | SI |
| movementType | lista | Identificador del schema del flujo transaccional. Ver Tablas de referencia: "Valores para el campo movementType". | Lista | SI |
| status | cadena | Estado de la transacción. Ver Tablas de referencia: "Estados de las transacciones". | Lista | SI |
| creationDateTime | fecha | Momento en el que se confirma la preparación del débito o crédito | N/A | SI |
| creditId | cadena | Identificador del credit prepare, el banco debe enviar el valor que corresponde a la transferencias. Este valor fue entregado por ACH En-línea en el llamado al endpoint /v1/credits. | Min 1 Max 36 | COND Si la acción es un débito se debe informar este campo |
| coreId | cadena | Identificador interno del banco para la preparación del débito o crédito. | Min 1 Max 255 | SI |
Request confirmación de preparación del crédito
curl --location 'https://url_ach/v1/money-movement/transfers/{id}/status' \
--header 'x-hash: 695ffdf84f0dad0c19e3b8b09a4565246c156d747ffb26149e4c2dc5d3b66ca1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJkZW1vLXVzdWFyaW8iLCJyb2xlIjoiYXBwLXRlc3QiLCJpYXQiOjE3MDAwMDAwMDAsImV4cCI6MTcwMDA4NjQwMH0.abc123xyz987fakeSignatureOnlyForDemoPurposes' \
--data '{...}' {
"meta": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"version": "1.0.0",
"timestamp": "2026-08-20T14:30:00-05:00"
},
"data": {
"movementType": "P2P-TRANSFER",
"status": "prepared",
"creationDateTime": "2026-08-20T14:35:20-05:00",
"creditId": "dbt-3f8d8b9a-1234-4567-89ab-123456789abc",
"coreId": "CORE-987654321"
}
} Response confirmación preparación crédito
HTTP/1.1 200 OK
Content-Length: 0 