💡 El objetivo es que el empleado tenga un porcentaje de su salario disponible, no el 100% del mismo.
⚠️ En este orden de ideas, para que una compañía que contrató la plataforma de Payflow pueda prestar correctamente el servicio de salario bajo demanda a sus empleados, es necesario que: 1.Mantenga actualizada de manera diaria la información básica necesaria a nivel empleados: altas, bajas y modificaciones 2.Consuma la información de pagos (también de manera diaria) para que la compañía pueda reportarla en su sistema de nómina y realizar los pagos.
| Carpeta | Quién escribe | Permisos del cliente | Contenido |
|---|---|---|---|
employees | El cliente | Depósito, escritura, renombrado y borrado | El cliente deposita aquí el archivo de actualización de empleados. |
transactions | Payflow | Lectura, escritura, renombrado y borrado | Payflow deposita aquí, a diario, el archivo con las novedades de nómina a descontar. El cliente lo recoge. |
| Entorno | URL | Puerto | Autenticación |
|---|---|---|---|
| Pruebas (staging) | sftp.v2-staging.payflow-dev.net | 22 | Usuario + contraseña (generados desde el panel) |
| Producción | sftp.v2.payflow.es | 22 | Usuario + contraseña (generados desde el panel) |
| Formato | Característica clave |
|---|---|
| Excel (.xlsx) | Admite varias hojas en un mismo archivo. • Solo aplica para el archivo de transacciones: una hoja de resumen y otra de detalle. |
| CSV | Archivo plano de una sola tabla, delimitado por comas (,). |
Para que un colaborador pueda usar la plataforma de Payflow, tiene que ser en primer lugar dado de alta: es decir, debe de ser creado como un potencial usuario por su empresa en su panel de control de Payflow.
El objetivo de este flujo es garantizar que solo los empleados correctos puedan usar Payflow y que sus datos estén actualizados.
Es importante recordar que Payflow es una plataforma provista por el empleador y el colaborador no puede modificar ningún dato allí. En caso de querer cambiar algo tiene que ir a su empleador y que este haga la modificación en el software de nómina; luego esta integración sincronizará los cambios en Payflow. Esto evita fraudes y garantiza la correcta prestación del servicio.
employees del SFTP. Payflow lo procesa y crea, actualiza o inactiva a los empleados en el panel de control según la información recibida.Evita errores comunes: Envía todos los datos obligatorios. No uses salario = 0 para inactivar, usa siempre el campo estado.No dejes de enviar empleados para inactivarlos, usa siempre el campo estado.Envía nombres y apellidos completos.
inactivo. No basta con dejar de enviarlo: si se deja de enviar, se mantiene el estado anterior. Tampoco se debe usar salario = 0 para inactivar; usar siempre el campo estado.Recomendación: incluir a todas las personas que salieron en los últimos 30 días con estado inactivo, para evitar inconsistencias si un fichero puntual no se procesa.
baja (ausencia temporal). Al reincorporarse, actualizar a activo.sueldoNeto o sueldoBruto. Si se envía sueldoBruto, Payflow calcula el sueldoNeto según reglas tributarias.| Campo | Requerido? | Descripción | Formato / Validación | Ejemplo |
|---|---|---|---|---|
| idInterno | No | Identificador interno del empleado en el sistema de nóminas | Alfanumérico, único por empresa (máx. 100 caracteres) | EMP001 |
| NumeroDeDocumento | Sí | Número del documento de identidad (DNI, carné de extranjería o pasaporte) | Texto. Conservar ceros a la izquierda | 09617332 |
| TipoDeDocumento | Sí | Tipo de documento de identidad | DNI, C_EXTRANJERIA o PASAPORTE | DNI |
| nombre | Sí | Nombres completos del empleado | Texto no vacío | JOSE FRANCISCO |
| apellidos | Sí | Apellidos completos del empleado | Texto no vacío | VILLAFUERTE FERNANDEZ |
| Sí* si no se manda Celular | Correo electrónico | Formato de email válido. Único y no genérico | jf.villafuerte@hotmail.com | |
| Celular | Sí* si no se manda email | Número de celular | Único y no genérico. Formato internacional con +51 (recomendado) o local | +51910112180 |
| CódigoInterbancario | Sí | Código de Cuenta Interbancario (CCI) para el abono | 20 dígitos. Texto, conservar ceros a la izquierda | 00300701304740904323 |
| TipoDeCuenta | Sí | Tipo de cuenta bancaria | ahorro o corriente | ahorro |
| EntidadBancaria | Sí | Entidad financiera del empleado | Texto (ver entidades soportadas abajo) | BBVA PERU |
| sueldoNeto | Opcional* si se manda Sueldo Bruto | Sueldo neto mensual | Numérico positivo, sin símbolo de moneda. Separador decimal: punto (.) | 2500 |
| sueldoBruto | Opcional* si se manda Sueldo Neto | Sueldo bruto mensual | Numérico positivo, sin símbolo de moneda. Separador decimal: punto (.) | 2500 |
| fechaInicioContrato | No | Fecha de inicio de contrato | DD/MM/YYYY o YYYY-MM-DD | 2021-03-25 |
| fechaFinContrato | Opcional | Fecha de fin de contrato (vacío = indefinido) | DD/MM/YYYY o YYYY-MM-DD | 2026-12-31 |
| estado | Sí | Estado del empleado | activo / inactivo / baja | activo |
| RUCempresa | Sí | RUC de la empresa/subsidiaria a la que pertenece el empleado | Texto, 11 dígitos | 20601313400 |
sueldoNeto y sueldoBruto.email y Celular.CodigoInterbancario.TipoDeDocumento): tipos admitidos DNI (Documento Nacional de Identidad), C_EXTRANJERIA (Carné de Extranjería) y PASAPORTE (Pasaporte vigente del empleado).NumeroDeDocumento sea cual sea el tipo de documento, y debe tratarse como texto para no perder ceros a la izquierda (ej. 09617332, 005523507).CódigoInterbancario): Código de Cuenta Interbancario de 20 dígitos, almacenado como texto para conservar ceros a la izquierda.RUCempresa): 11 dígitos. Debe ser válido y estar creado en el panel de control.estado:activo → Puede usar Payflow, es un empleado activo en la empresainactivo → No puede usar Payflow, ya no trabaja en la empresabaja → No puede usar Payflow temporalmente, baja temporal definida por las reglas de negocioestado = "baja" y así cumplir con los estándares de integración de Payflow son:EntidadBancaria, en la fila de la derecha están las variaciones aceptadas en caso de no enviarla como en la fila izquierda.| Entidad Bancaria Normalizada | Variaciones Aceptadas |
|---|---|
| CENTRAL DE RESERVA DEL PERU | - |
| CREDITO DEL PERU | - |
| INTERNACIONAL DEL PERU (INTERBANK) | INTERBANK |
| CITIBANK DEL PERU | - |
| SCOTIABANK PERU | - |
| BBVA PERU | BBVA |
| PICHINCHA | - |
| LA NACION | - |
| COMERCIO | - |
| FINANCIERO DEL PERU | - |
| INTERAMERICANO DE FINANZAS | - |
| CREDISCOTIA FINANCIERA | - |
| MIBANCO, LA MICRO EMPRESA | - |
| GNB PERU | - |
| FALABELLA | - |
| RIPLEY | - |
| SANTANDER PERU | - |
| CAJA METROPOLITANA DE LIMA | - |
| CAJA MUNICIPAL DE AHORRO Y CRÉDITO PIURA | - |
| CAJA MUNICIPAL DE AHORRO Y CRÉDITO TRUJILLO | - |
| CAJA MUNICIPAL DE AHORRO Y CRÉDITO AREQUIPA | - |
| CAJA MUNICIPAL DE AHORRO Y CRÉDITO SULLANA | - |
| CAJA MUNICIPAL DE AHORRO Y CRÉDITO CUZCO | - |
| CAJA MUNICIPAL DE AHORRO Y CRÉDITO HUANCAYO | - |
Empleados) con la cabecera en la primera fila, una columna por campo y una fila por empleado:| idInterno | NumeroDeDocumento | TipoDeDocumento | nombre | apellidos | Celular | CódigoInterbancario | TipoDeCuenta | EntidadBancaria | sueldoNeto | sueldoBruto | fechaInicioContrato | fechaFinContrato | estado | RUCempresa | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| EMP002 | 16005535 | DNI | ENIO MOISES | LOPEZ GUERRERO | em.lopez@hotmail.com | +51924166826 | 00300701304740904323 | ahorro | INTERNACIONAL DEL PERU (INTERBANK) | 1500 | 2025-03-01 | inactivo | 20601313400 | ||
| EMP006 | 10641637 | DNI | YOLANDA | RAMIREZ YUPTON | yy.ramirez@hotmail.com | +51902259772 | 00901920013115181314 | ahorro | SCOTIABANK PERU | 1800 | 2025-12-29 | activo | 20601369401 | ||
| EMP007 | 46328617 | DNI | OMAR | HERRERA CAMPOS | oo.herrera@hotmail.com | +51959250111 | 00219119529980803054 | ahorro | CREDITO DEL PERU | 1900 | 2022-08-03 | activo | 20781314502 | ||
| EMP009 | 005523507 | C_EXTRANJERIA | KEVIN PAUL | SARDA JUAREZ | kp.sarda@hotmail.com | +51921544594 | 00219117277811904958 | ahorro | CREDITO DEL PERU | 9000 | 2024-11-11 | activo | 20781314502 | ||
| EMP010 | 004649552 | C_EXTRANJERIA | LUCIA CLEMENTINA | SILVA VERA | lc.silva@hotmail.com | +51978266997 | 00219411302634302191 | ahorro | CREDITO DEL PERU | 2000 | 2022-12-19 | activo | 20601369401 |
ejemplo_employees_XLSX_SFTP_PE
CodigoInterbancario):idInterno,NumeroDeDocumento,TipoDeDocumento,nombre,apellidos,email,Celular,CodigoInterbancario,TipoDeCuenta,EntidadBancaria,sueldoNeto,sueldoBruto,fechaInicioContrato,fechaFinContrato,estado,RUCempresa
emp001,10029122,DNI,Sebastian Alejandro,Gomez Games,sa.gomez1999@hotmail.com,+51946668923,19110990615061,ahorro,CREDITO DEL PERU,,1500,2023-09-01,,activo,20601717401
emp002,002365943,C_EXTRANJERIA,Lourdes Mariana,Moron Peña,lm.moron1988@gmail.com,+51992961067,01124900020237234609,ahorro,BBVA PERU,,5000,2026-03-04,,activo,20808869408,,).ejemplo_employees_CSV_SFTP_PE
Para la preparación de la nómina de los colaboradores, es necesario que los pagos realizados en la plataforma de Payflow sean registrados en el software de nómina correctamente para su deducción de la nómina del periodo.
El objetivo de este flujo es garantizar que las transacciones realizadas en Payflow sean descontadas de la nómina de los empleados.
Hay que tener en cuenta que aunque la nómina se pague a final de mes o de la quincena, puede suceder que se paguen liquidaciones durante los periodos a colaboradores que se retiran. En estos casos se necesitará considerar y descontar las transacciones hechas en la plataforma de Payflow.
transactions del SFTP. El cliente lo descarga y registra los montos como novedad en su software de nómina.Evita errores comunes: Antes de construir este flujo, asegúrate de que existe un concepto en la nómina de tu empresa a donde deban llegar las transacciones de Payflow para ser descontadas (usualmente lo llaman "Anticipo Payflow"). Usa el "Identificador de transacción" para no registrar dos veces la misma transacción en nómina.
Payflow - Resumen — total a deducir agregado por empleado:| Columna | Descripción | Ejemplo |
|---|---|---|
| RUC Empresa | RUC de la empresa | 20601369401 |
| Nombre empresa | Razón social | empresa 2 |
| Id de empleado | idInterno del empleado | EMP006 |
| DNI o CE | Número de documento del empleado | 10641637 |
| Nombre | Nombres | Yolanda |
| Apellidos | Apellidos | Ramirez Yupton |
| Importe total a deducir en soles | Suma total a descontar de la nómina del empleado | S/20 |
Payflow - Detalles — una fila por transacción:| Columna | Descripción | Ejemplo |
|---|---|---|
| Identificador de transacción | Identificador único alfanumérico (para conciliación) | 30fHUzqRv |
| Fecha | Fecha de la transacción (DD/MM/YYYY) | 02/06/2026 |
| RUC Empresa | RUC de la empresa | 20601369401 |
| Nombre empresa | Razón social | empresa 2 |
| DNI o CE | Número de documento del empleado | 10641637 |
| Nombre | Nombres | Yolanda |
| Apellidos | Apellidos | Ramirez Yupton |
| Importe retirado S/ | Monto retirado por el empleado | S/20 |
| Comisión aplicable S/ | Comisión cobrada por la transacción | S/0 |
| Importe adelantado a deducir S/ | Monto a descontar de la nómina | S/20 |
ejemplo_transactions_XLSX_SFTP_PE
Payflow - Detalles), con dos columnas adicionales al final: Id de empleado y Estado. La primera columna está reservada (vacía) para uso futuro.,Identificador de transacción,Fecha,RUC Empresa,Nombre empresa,DNI o CE,Nombre,Apellidos,Importe retirado S/,Comisión aplicable S/,Importe adelantado a deducir S/,Id de empleado,Estado
,kyyyW2ZxD,02/6/2026,20601717401,Empresa 1,10029122,Sebastian Alejandro,Gomez Games,S/10,S/0,S/10,emp001,procesado
,xb7qEPyu5,02/6/2026,20808869408,Empresa 2,002365943,Lourdes Mariana,Moron Peña,S/5,S/0,S/5,emp002,procesado| Dato | Formato en CSV | Ejemplo |
|---|---|---|
| Fecha | DD/M/YYYY (el mes va sin cero a la izquierda) | 02/6/2026 |
| Columna adicional | Descripción | Ejemplo |
|---|---|---|
| Id de empleado | idInterno del empleado | emp001 |
| Estado | Estado de la transacción | procesado |
ejemplo_transactions_CSV_SFTP_PE
employeestransactions.| Periodo | Disponible desde | Equivalente en hora de Perú (PET, UTC−5) |
|---|---|---|
| Horario de invierno | 01:00 UTC+00:00 | ~20:00 del día anterior |
| Horario de verano | 01:00 UTC+01:00 | ~19:00 del día anterior |
NumeroDeDocumento, CódigoInterbancario y RUCempresa como texto, nunca como número.