- Cómo enviar cuenta a cuenta
- Cómo debitar al usuario origen
- Cómo aceptar la transferencia
- Cómo acreditar al beneficiario
- Notificación estado final
- Como consultar una transferencia
- Gestión de errores servicios ACH En-línea
- Flujos de excepción
- Tablas de referencia
- Token de autenticación
- PSE Abono en Línea
Gestión de errores servicios ACH En-línea
Información sobre la gestión de errores retornados por los servicios de ACH En-línea
Los servicios expuestos por ACH En Línea podrán retornar los siguientes códigos de error, retornados con base en la siguiente estructura.
| Campo | Tipo | Validación - Descripción | Mapeo de datos | Obligatoriedad |
|---|---|---|---|---|
| meta | objeto | N/A | N/A | SI |
| requestId | cadena | UUID que identifica el mensaje | N/A | SI |
| timestamp | fecha | Marca de tiempo de envío del mensaje | N/A | SI |
| status | cadena | Estado de la transacción | Valor Fijo: "FAILED" | SI |
| statusCode | cadena | Código HTTP | De acuerdo con la tabla “Listado de errores” columna Código HTTP | SI |
| statusDesc | cadena | Descripción del código HTTP según el estándar. | De acuerdo con la tabla “Listado de errores” columna Detail | SI |
| errors | arreglo | N/A | N/A | SI |
| code | entero | Código ACH del error | De acuerdo con la tabla “Listado de errores” columna code | SI |
| detail | cadena | Descripción del error | Corresponde al detalle del errror retornado | SI |
Response ejemplo
{
"meta": {
"requestId": "72ccf270-8f0f-4824-b15c-2a9da633972c",
"timestamp": "2026-10-01T08:16:35.781",
"status": "FAILED",
"statusCode": "422",
"statusDesc": "Inconsistencia en datos de la transaccion."
},
"errors": [
{
"code": 1013,
"detail": "record.schema-invalid: Schema validator error: data.claims.0.source.handle must match pattern \"^(svgs|cacc|dbmo|dord|dbmi):\\d+@[a-zA-Z0-9_\\-+.]+$\""
}
]
}
Listado códigos de error
| Código HTTP | HTTP Description | Code | Detail |
|---|---|---|---|
| 400 | Bad Request — Solicitud mal formada. | 1013 | Datos obligatorios no encontrados |
| 400 | Bad Request — Solicitud mal formada. | 1013 | Hash inválido |
| 401 | Unauthorized — Requiere autenticación. | 1005 | Token Inválido |
| 401 | Unauthorized — Requiere autenticación. | 1005 | Token Vencido |
| 403 | Forbidden — El servidor rechaza la solicitud. | 1005 | Acceso Denegado |
| 408 | Request Timeout — Tiempo de espera agotado. | 1019 | El servidor no responde |
| 429 | Too Many Requests — Demasiadas solicitudes. | 1019 | Rate limit superado |
| 500 | Internal Server Error — Error interno del servidor. | 1005 | Fallas técnicas |
| 500 | Internal Server Error — Error interno del servidor. | 1013 | Inconsistencia en datos de la transacción. |
| 500 | Internal Server Error — Error interno del servidor. | 1005 | Fallas técnicas |
| 500 | Internal Server Error — Error interno del servidor. | 1013 | Inconsistencia en datos de la transacción. |
| 500 | Internal Server Error — Error interno del servidor. | 1019 | Falla de comunicación |
| 408 | Request Timeout — Tiempo de espera agotado. | 1019 | Falla de comunicación |
| 500 | Internal Server Error — Error interno del servidor. | 1005 | Fallas técnicas |
| 503 | Service Unavailable — Servicio no disponible temporalmente. | 1005 | Fallas técnicas |
| 422 | Unprocessable Content — No se puede procesar el contenido. | 1013 | Inconsistencia en datos de la transacción. |
| 409 | Conflict — Conflicto con el estado del recurso. | 1013 | Inconsistencia en datos de la transacción. |
| 422 | Unprocessable Content — No se puede procesar el contenido. | 1013 | Inconsistencia en datos de la transacción. |
| 404 | Not Found — Recurso no encontrado. | 1013 | Inconsistencia en datos de la transacción. |
Estructura del response que deben retornar las Entidades Participantes
A continuación, se detalla la esctructa que deben enviar las Entidades Participantes en respuesta a los llamados que efectua ACH En-línea
| Campo | Tipo | Validación - Descripción | Mapeo de datos | Obligatoriedad |
|---|---|---|---|---|
| meta | objeto | N/A | N/A | SI |
| requestId | cadena | UUID que identifica el mensaje | N/A | SI |
| timestamp | fecha | Marca de tiempo de envío del mensaje | N/A | SI |
| status | cadena | Estado de la transacción | Valor Fijo: "FAILED" | SI |
| statusCode | cadena | Código HTTP | De acuerdo con la tabla “Listado de errores” columna Código HTTP | SI |
| statusDesc | cadena | Descripción del código HTTP según el estándar. | De acuerdo con la tabla “Listado de errores” columna Detail | SI |
| errors | arreglo | N/A | N/A | SI |
| code | entero | Código ACH del error | De acuerdo con la tabla “Listado de errores” columna code | SI |
| detail | cadena | Descripción del error | Corresponde al detalle del errror retornado | SI |
Response ejemplo
{
"meta": {
"requestId": "72ccf270-8f0f-4824-b15c-2a9da633972c",
"timestamp": "2026-10-01T08:16:35.781",
"status": "FAILED",
"statusCode": "422",
"statusDesc": "Inconsistencia en datos de la transaccion."
},
"errors": [
{
"code": 1013,
"detail": "record.schema-invalid: Schema validator error: data.claims.0.source.handle must match pattern \"^(svgs|cacc|dbmo|dord|dbmi):\\d+@[a-zA-Z0-9_\\-+.]+$\""
}
]
}
Orderarticle 8
