1. Guías
Payflow API
Peru
  • Spain
  • Colombia
  • Peru
  • Guías
    • Guía de integración vía API
    • Guía de integración vía SFTP
  • Guías y definiciones
    • Empleados
      • Estados del empleado
      • Conceptos salariales
    • Pagos
      • Ciclo de vida de un pago
  • Explora nuestra API publica
    • Autenticación y Estado del Sistema
      • Verificación de Estado
      • Prueba de API Key
    • Empresa
      • Detalles de Empresa
    • Empleados
      • Empleado
      • Todos los Empleados
      • Todos los Empleados (V1.1)
      • Crea un Empleado
      • Crear Empleados en Lote
      • Actualizar un empleado por Personal ID
      • Actualizar un empleado por Payflow ID
      • Actualizar un empleado por payrollId
    • Licencias
      • Empleados con Licencia
      • Licencia de Empleado
      • Remover Licencia a Empleado
    • Pagos
      • Pagos de la Empresa
      • Pagos del Empleado
      • Pago individual por ID
      • Solicitar pago
      • Suscribirse a las actualizaciones de pago
      • Confirmar Pagos
      • Obtener monto disponible
  • Estructura de Notificación
    • Actualizaciones de pago
  • Lista de bancos soportados
    • Entidades bancarias admitidas
  • Schemas
    • Empresa
      • Respuesta de la Empresa
    • Empleado
      • PE | Solicitud para crear Empleado
      • PE | Solicitud de actualización de empleado
      • PE | Respuesta del empleado
      • Licencia de Empleado
    • Pagos
      • Respuesta del pago
      • Respuesta de pago Convoluted
      • Actualización de pago
    • Error
      • Generic Error Response
  1. Guías

Guía de integración vía SFTP

En esta guía se explica el proceso para construir la Integración Estándar vía SFTP con Payflow en Perú.

1. Contexto inicial: ¿Qué es Payflow?#

Payflow es una plataforma de bienestar financiero que tiene como principal servicio el salario bajo demanda.
Esto significa que las compañías que contratan la plataforma pueden permitir a sus empleados cobrar parte del salario que ya llevan devengado cuando ellos quieran o lo necesiten.
El objetivo de Payflow no es adelantar todo el salario, sino ofrecer liquidez responsable, esto quiere decir que Payflow solo adelantará la parte que el colaborador ya haya trabajado, bajo los límites establecidos por la empresa contratante.
No es una solución que adelante todo el salario del mes, ni es una solución de préstamos. Payflow permite que el empleado pueda obtener liquidez sobre lo trabajado, pero evitando que se quede sin ingresos a final de mes.

Ejemplo práctico:#

Un colaborador con un salario básico neto de S/3,000:
Devenga diariamente S/100 (3,000 / 30)
En el día 10 del mes ha completado 9 días de trabajo (el 10 no ha terminado) y por lo tanto ha devengado S/900 (100 * 9)
RRHH define que puede retirar el 60%
Entonces tendrá un disponible de: S/540
De esta forma:
El trabajador cubre necesidades puntuales
No se queda sin salario a fin de mes
No se genera una nómina negativa
Se mantiene un uso responsable del beneficio
💡 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.

2. Payflow: El Producto#

Payflow ofrece 2 componentes principales:

📱 Aplicación móvil para empleados:#

Disponible en App Store y Google Play Store:
App Store: https://apps.apple.com/es/app/payflow/id1503530690
Google Play: https://play.google.com/store/apps/details?id=es.payflow.app&hl=en
Permite al usuario:
Registrarse
Ver su salario disponible
Hacer transacciones (retiros de dinero)
Consultar historial
Otros: funcionalidades extra de la aplicación
Funciona como el trigger de las solicitudes de retiro de salario devengado.

🖥️ Panel web para administradores#

URL: https://admin.payflow.es/auth/login
Versión web utilizada por los administradores de Payflow en el día a día (generalmente RRHH) para gestionar aspectos relevantes como:
Revisar las Altas/Ediciones/Bajas de empleados ejecutadas por la integración
Configurar límites de uso
Ver transacciones
Monitorear uso
Detalle panel de control 🖥️
Página principal - Estadísticas de proyecto
image.webp
1.
Número de empleados registrados: total y por producto
2.
Total de dinero transaccionado
3.
Cantidad media de transacción
4.
Número total de transacciones
5.
Evolución mensual del total de transacciones
6.
Evolución mensual del total transaccionado

3. Introducción al SFTP de Payflow#

En empresas de un número considerable de colaboradores, suele suceder que la gestión de Payflow busca realizarse de manera desatendida, es decir, mediante una integración entre sistemas.
Con la integración:
Payflow se convierte en un espejo del software de nómina, siendo el software la fuente de verdad.
Esto reduce:
Errores humanos
Retrasos
Incidencias en producción
Carga operativa
El objetivo es mantener sincronizados dos flujos de información mediante el intercambio de ficheros en un servidor SFTP:
Empleados → mantener en Payflow a los empleados actualizados con base en el software de nómina.
Transacciones → recoger las transacciones de salario bajo demanda que realizan los empleados para descontarlas en la nómina.
Payflow pone a disposición del cliente un único servidor SFTP con dos carpetas:
CarpetaQuién escribePermisos del clienteContenido
employeesEl clienteDepósito, escritura, renombrado y borradoEl cliente deposita aquí el archivo de actualización de empleados.
transactionsPayflowLectura, escritura, renombrado y borradoPayflow deposita aquí, a diario, el archivo con las novedades de nómina a descontar. El cliente lo recoge.

3.1 Conexión#

EntornoURLPuertoAutenticación
Pruebas (staging)sftp.v2-staging.payflow-dev.net22Usuario + contraseña (generados desde el panel)
Producciónsftp.v2.payflow.es22Usuario + contraseña (generados desde el panel)
La autenticación puede hacerse mediante usuario y contraseña (generados desde el panel de Payflow) o mediante llave SSH.

4. Formatos soportados: Excel y CSV#

Los ficheros pueden intercambiarse en dos formatos, y se acuerda con Payflow cuál se usará durante la implementación:
FormatoCaracterí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.
CSVArchivo plano de una sola tabla, delimitado por comas (,).

5. Flujo de sincronización de empleados#

Alta / Baja / Modificación de empleados
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.
En este flujo, el cliente genera a diario un archivo con todos sus empleados desde el software de nómina y lo deposita en la carpeta 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.

5.1 Requisitos del archivo: foto completa#

Enviar la foto completa: todos los empleados en cada ejecución. El archivo es un snapshot de la nómina completa.
Una sola fila por empleado, reflejando su información y estado actuales. No se envía histórico:
Si cambió de empresa/subsidiaria, enviar solo la fila con la empresa actual.
Si su información cambió varias veces, enviar solo la fila con la información vigente.
Si estuvo de licencia y ahora está activo, enviar solo la información actual.
Inactivación definitiva: para dar de baja a un empleado, inclúyelo con estado 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.
Inactivación temporal: si el empleado no debe tener acceso a la app de forma temporal, su estado debe ser baja (ausencia temporal). Al reincorporarse, actualizar a activo.

5.2 Reglas generales del archivo#

Codificación: UTF-8 (imprescindible para tildes, ñ y caracteres especiales).
Sin cifrado ni contraseña: los ficheros no se pueden enviar encriptados ni protegidos por contraseña. Si lo están, no se procesan.
Salario: debe enviarse uno entre sueldoNeto o sueldoBruto. Si se envía sueldoBruto, Payflow calcula el sueldoNeto según reglas tributarias.
Nombres completos: enviar nombres y apellidos completos del empleado.

5.3 Campos del archivo de empleados#

Estos son los campos del archivo de empleados y sus reglas. Aplican tanto si se entrega en Excel (como columnas de la hoja) como en CSV (como campos de la cabecera). El nombre de cada campo debe coincidir exactamente, respetando mayúsculas y minúsculas, y se recomienda mantener el orden indicado.
CampoRequerido?DescripciónFormato / ValidaciónEjemplo
idInternoNoIdentificador interno del empleado en el sistema de nóminasAlfanumérico, único por empresa (máx. 100 caracteres)EMP001
NumeroDeDocumentoSíNúmero del documento de identidad (DNI, carné de extranjería o pasaporte)Texto. Conservar ceros a la izquierda09617332
TipoDeDocumentoSíTipo de documento de identidadDNI, C_EXTRANJERIA o PASAPORTEDNI
nombreSíNombres completos del empleadoTexto no vacíoJOSE FRANCISCO
apellidosSíApellidos completos del empleadoTexto no vacíoVILLAFUERTE FERNANDEZ
emailSí* si no se manda CelularCorreo electrónicoFormato de email válido. Único y no genéricojf.villafuerte@hotmail.com
CelularSí* si no se manda emailNúmero de celularÚnico y no genérico. Formato internacional con +51 (recomendado) o local+51910112180
CódigoInterbancarioSíCódigo de Cuenta Interbancario (CCI) para el abono20 dígitos. Texto, conservar ceros a la izquierda00300701304740904323
TipoDeCuentaSíTipo de cuenta bancariaahorro o corrienteahorro
EntidadBancariaSíEntidad financiera del empleadoTexto (ver entidades soportadas abajo)BBVA PERU
sueldoNetoOpcional* si se manda Sueldo BrutoSueldo neto mensualNumérico positivo, sin símbolo de moneda. Separador decimal: punto (.)2500
sueldoBrutoOpcional* si se manda Sueldo NetoSueldo bruto mensualNumérico positivo, sin símbolo de moneda. Separador decimal: punto (.)2500
fechaInicioContratoNoFecha de inicio de contratoDD/MM/YYYY o YYYY-MM-DD2021-03-25
fechaFinContratoOpcionalFecha de fin de contrato (vacío = indefinido)DD/MM/YYYY o YYYY-MM-DD2026-12-31
estadoSíEstado del empleadoactivo / inactivo / bajaactivo
RUCempresaSíRUC de la empresa/subsidiaria a la que pertenece el empleadoTexto, 11 dígitos20601313400
Disclaimers:
Solo enviar uno entre sueldoNeto y sueldoBruto.
Debe enviarse al menos uno entre email y Celular.
En el archivo CSV, la cabecera del CCI va sin tilde: CodigoInterbancario.

5.4 Notas de validación#

Tipo de Documento (TipoDeDocumento): tipos admitidos DNI (Documento Nacional de Identidad), C_EXTRANJERIA (Carné de Extranjería) y PASAPORTE (Pasaporte vigente del empleado).
El número va en el campo NumeroDeDocumento sea cual sea el tipo de documento, y debe tratarse como texto para no perder ceros a la izquierda (ej. 09617332, 005523507).
Es importante que sea el documento asociado a la cuenta bancaria del empleado, pues se hace una validación antes de realizar la transacción.
Email y celular: no pueden ser genéricos y deben ser únicos por empleado. Los emails y números de celular inválidos serán anulados.
CCI (CódigoInterbancario): Código de Cuenta Interbancario de 20 dígitos, almacenado como texto para conservar ceros a la izquierda.
RUC (RUCempresa): 11 dígitos. Debe ser válido y estar creado en el panel de control.
Salario: numérico positivo, sin símbolo de moneda; separador decimal punto (.); cadena vacía = nulo.
Detalle de los posibles estados de los empleados
Esta es la explicación de los posibles valores a enviar en el campo estado:
activo → Puede usar Payflow, es un empleado activo en la empresa
inactivo → No puede usar Payflow, ya no trabaja en la empresa
baja → No puede usar Payflow temporalmente, baja temporal definida por las reglas de negocio
Detalle de las reglas de negocio para definir estado "baja"
Las reglas de negocio que se pueden aplicar en el código para que el empleado sea enviado a Payflow con estado = "baja" y así cumplir con los estándares de integración de Payflow son:
1.
Antigüedad: Empleados que lleven menos de X meses en la empresa
2.
Vacaciones: Empleados que estén disfrutando vacaciones en el día de la sincronización.
3.
Maternidad/Paternidad: Empleados que estén con licencia de maternidad/paternidad en el día de la sincronización
4.
Incapacidad: Empleados que estén con incapacidad en el día de la sincronización
5.
Practicante: Empleados que sean practicantes
Detalle de entidades bancarias soportadas
En la fila de la izquierda está como se debe enviar el banco en el campo EntidadBancaria, en la fila de la derecha están las variaciones aceptadas en caso de no enviarla como en la fila izquierda.
Entidad Bancaria NormalizadaVariaciones Aceptadas
CENTRAL DE RESERVA DEL PERU-
CREDITO DEL PERU-
INTERNACIONAL DEL PERU (INTERBANK)INTERBANK
CITIBANK DEL PERU-
SCOTIABANK PERU-
BBVA PERUBBVA
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-

5.5 Formato Excel (.xlsx)#

Una sola hoja (Empleados) con la cabecera en la primera fila, una columna por campo y una fila por empleado:
idInternoNumeroDeDocumentoTipoDeDocumentonombreapellidosemailCelularCódigoInterbancarioTipoDeCuentaEntidadBancariasueldoNetosueldoBrutofechaInicioContratofechaFinContratoestadoRUCempresa
EMP00216005535DNIENIO MOISESLOPEZ GUERREROem.lopez@hotmail.com+5192416682600300701304740904323ahorroINTERNACIONAL DEL PERU (INTERBANK)15002025-03-01inactivo20601313400
EMP00610641637DNIYOLANDARAMIREZ YUPTONyy.ramirez@hotmail.com+5190225977200901920013115181314ahorroSCOTIABANK PERU18002025-12-29activo20601369401
EMP00746328617DNIOMARHERRERA CAMPOSoo.herrera@hotmail.com+5195925011100219119529980803054ahorroCREDITO DEL PERU19002022-08-03activo20781314502
EMP009005523507C_EXTRANJERIAKEVIN PAULSARDA JUAREZkp.sarda@hotmail.com+5192154459400219117277811904958ahorroCREDITO DEL PERU90002024-11-11activo20781314502
EMP010004649552C_EXTRANJERIALUCIA CLEMENTINASILVA VERAlc.silva@hotmail.com+5197826699700219411302634302191ahorroCREDITO DEL PERU20002022-12-19activo20601369401
Ejemplo:
ejemplo_employees_XLSX_SFTP_PE

5.6 Formato CSV#

Codificación UTF-8, delimitador coma (,). Cabecera + una fila por empleado, con los campos de §5.3 (el CCI va sin tilde en la cabecera: 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
Los campos opcionales sin valor se dejan vacíos entre delimitadores (ej. ,,).
Ejemplo:
ejemplo_employees_CSV_SFTP_PE

6. Flujo de sincronización de transacciones#

Sincronización de transacciones para ser descontadas de la nómina de los empleados
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.
En este flujo, Payflow genera a diario un archivo con las transacciones de los empleados y lo deposita en la carpeta 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.

6.1 Contenido y alcance del archivo#

Alcance: el archivo contiene las transacciones del mes en curso (desde el inicio del mes hasta el día de generación) y se regenera todos los días.
Moneda: soles (PEN), con el símbolo S/ como prefijo, sin espacio (ej. S/20). Los montos llegan como texto, por lo que hay que limpiarlos antes de cargarlos como número en nómina.
Los datos necesarios van a variar dependiendo del software de nómina y sus requerimientos para crear una novedad, pero usualmente se toman por lo menos:
Identificador de transacción, para identificar la transacción y evitar duplicados
DNI o CE y/o Id de empleado, para identificar al empleado al que se le hará el descuento
Importe adelantado a deducir, para poner en el concepto el monto a descontar

6.2 Formato Excel (.xlsx)#

Payflow genera este archivo con dos hojas. En ambas, la primera fila y la primera columna están reservadas (vacías) para uso futuro; la cabecera empieza en la celda B2.
Hoja Payflow - Resumen — total a deducir agregado por empleado:
ColumnaDescripciónEjemplo
RUC EmpresaRUC de la empresa20601369401
Nombre empresaRazón socialempresa 2
Id de empleadoidInterno del empleadoEMP006
DNI o CENúmero de documento del empleado10641637
NombreNombresYolanda
ApellidosApellidosRamirez Yupton
Importe total a deducir en solesSuma total a descontar de la nómina del empleadoS/20
Hoja Payflow - Detalles — una fila por transacción:
ColumnaDescripciónEjemplo
Identificador de transacciónIdentificador único alfanumérico (para conciliación)30fHUzqRv
FechaFecha de la transacción (DD/MM/YYYY)02/06/2026
RUC EmpresaRUC de la empresa20601369401
Nombre empresaRazón socialempresa 2
DNI o CENúmero de documento del empleado10641637
NombreNombresYolanda
ApellidosApellidosRamirez Yupton
Importe retirado S/Monto retirado por el empleadoS/20
Comisión aplicable S/Comisión cobrada por la transacciónS/0
Importe adelantado a deducir S/Monto a descontar de la nóminaS/20
Ejemplo:
ejemplo_transactions_XLSX_SFTP_PE

6.3 Formato CSV#

Codificación UTF-8, delimitador coma (,). Al ser un archivo plano, el CSV corresponde al detalle de transacciones (equivalente a la hoja 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
Diferencias de formato respecto al Excel:
DatoFormato en CSVEjemplo
FechaDD/M/YYYY (el mes va sin cero a la izquierda)02/6/2026
Columna adicionalDescripciónEjemplo
Id de empleadoidInterno del empleadoemp001
EstadoEstado de la transacciónprocesado
Ejemplo:
ejemplo_transactions_CSV_SFTP_PE

7. Integración (script diario)#

La integración consiste en un script/proceso automático que se ejecuta todos los días y que:
(a) deposita el archivo de empleados en employees
(b) recoge el archivo de transacciones de transactions.
El cliente es responsable de este transporte, que debe ejecutarse al menos una vez al día.

7.1 ¿Cuándo correrlo?#

Payflow deja disponible el archivo de transacciones a partir de la 01:00 (zona horaria del servidor de Payflow, Europa Occidental). Conviene programar la descarga después de esa hora:
PeriodoDisponible desdeEquivalente en hora de Perú (PET, UTC−5)
Horario de invierno01:00 UTC+00:00~20:00 del día anterior
Horario de verano01:00 UTC+01:00~19:00 del día anterior
En la práctica, el archivo del día ya está disponible la noche anterior en hora de Perú, antes del inicio de la jornada laboral.

7.2 Flujo del proceso diario#

1.
Conectar al SFTP de Payflow (producción):
host = sftp.v2.payflow.es · puerto = 22 · usuario/contraseña del panel
2.
Subida — archivo de empleados:
a. Generar la foto completa de empleados desde el sistema de nóminas
(todos los empleados · 1 fila por empleado · estado actual).
b. Validar los campos (documento, CCI, RUC, fechas, salario)
y la codificación UTF-8. No cifrar ni proteger con contraseña.
c. Depositar el archivo en la carpeta /employees.
3.
Descarga — archivo de transacciones:
a. Listar /transactions y localizar el archivo del día.
b. Descargarlo.
c. Procesar el detalle y aplicar los descuentos en nómina,
conciliando por "Identificador de transacción" / documento.
4.
Registrar el resultado (logs) y alertar ante errores o si el archivo
esperado no aparece.
Puede implementarse con cualquier cliente SFTP (una librería en Python, Node, Java, etc., o una utilidad de línea de comandos).

7.3 Recomendaciones para una integración robusta#

Foto completa siempre: envía el padrón completo en cada ejecución; así, si un archivo no se procesa, el siguiente snapshot corrige el estado automáticamente.
Ceros a la izquierda: trata NumeroDeDocumento, CódigoInterbancario y RUCempresa como texto, nunca como número.
UTF-8 de extremo a extremo para preservar tildes y ñ.
Nombres de campo exactos: cualquier variación en la cabecera (incluidas mayúsculas/minúsculas y tildes) puede romper el procesamiento.
Montos como texto: los importes del archivo de transacciones llegan con el prefijo S/ (ej. S/20); límpialos antes de cargarlos como número en nómina.
Fechas según el formato: en Excel llegan como DD/MM/YYYY y en CSV como DD/M/YYYY; ajusta el parseo al formato acordado.
Sin duplicados: usa el "Identificador de transacción" para no registrar dos veces la misma transacción en nómina.
Liquidaciones: si se paga una liquidación durante el periodo a un colaborador que se retira, considera y descuenta también sus transacciones de Payflow.
Monitoreo: levanta una alerta si el archivo de transacciones no aparece a la hora esperada.
Empieza en pruebas: valida un ciclo completo (subida de empleados + descarga de transacciones) en staging antes de pasar a producción.

8. Soporte#

Para dudas de implementación, credenciales o incidencias de procesamiento, contacta con tu Technical Account Manager de Payflow.
Modified at 2026-09-25 17:39:36
Previous
Guía de integración vía API
Next
Estados del empleado
Built with