El archivo Asobancaria es un reporte estandarizado de transacciones financieras utilizado en Colombia para la conciliación de pagos. OnePay genera este archivo periódicamente con el detalle de todos los movimientos procesados.Documentation Index
Fetch the complete documentation index at: https://docs.onepay.la/llms.txt
Use this file to discover all available pages before exploring further.
¿Cómo obtener el archivo?
El archivo de conciliación está disponible a través de un servidor SFTP al que puedes conectarte con las credenciales que te provee el equipo de soporte.Para activar el acceso al servidor SFTP y recibir tus credenciales, comunícate con el equipo de soporte de OnePay.
Pasos para acceder
Solicita acceso al equipo de soporte
Escribe a soporte indicando tu nombre de empresa y el entorno (producción o sandbox).
El equipo te enviará: host SFTP, usuario, contraseña y ruta del directorio.
Conéctate al servidor SFTP
Usa cualquier cliente SFTP (FileZilla, WinSCP, o línea de comandos) con las credenciales recibidas.
Descarga el archivo
Los archivos se generan con frecuencia diaria y se nombran con la fecha de corte.
Ejemplo:
ONEPAY_20250120.txtFormato del archivo
El archivo sigue el estándar Asobancaria con campos de ancho fijo separados por pipes (|).
| Columna | Campo | Descripción |
|---|---|---|
| 1 | fecha | Fecha de la transacción (YYYYMMDD) |
| 2 | hora | Hora de la transacción (HHMMSS) |
| 3 | referencia | ID interno de la transacción en OnePay |
| 4 | referencia_externa | Tu identificador externo (external_id) |
| 5 | tipo | Tipo de movimiento (DEBITO, CREDITO) |
| 6 | monto | Monto en centavos |
| 7 | moneda | Código de moneda (COP) |
| 8 | estado | Estado de la transacción (APROBADO, RECHAZADO) |
| 9 | descripcion | Descripción del movimiento |
Ejemplo de línea
Estados posibles
| Estado | Descripción |
|---|---|
APROBADO | Transacción procesada exitosamente |
RECHAZADO | Transacción rechazada por el banco |
PENDIENTE | En proceso de liquidación |
DEVUELTO | Reversión o devolución aplicada |
Preguntas frecuentes
¿Con qué frecuencia se genera el archivo?
¿Con qué frecuencia se genera el archivo?
El archivo se actualiza una vez al día, con corte a las 11:59 PM hora Colombia.
¿Cuántos días de histórico están disponibles?
¿Cuántos días de histórico están disponibles?
El servidor SFTP conserva los últimos 90 días de archivos.
¿Puedo automatizar la descarga?
¿Puedo automatizar la descarga?
Sí. Puedes programar un script con un cliente SFTP (p. ej.
sftp o lftp) para descargar automáticamente el archivo cada día.