Saltar al contenido principal

PayPal

Disponible

Esta integración está activa y lista para usar en Frihet.

Conecta tu cuenta PayPal Business a Frihet. Importa transacciones, consulta saldos y reconcilia cobros internacionales con tus facturas de forma automática. Soporta modo sandbox para pruebas.

¿Para qué sirve?​

Con PayPal integrado:

  • Importar transacciones — Trae automáticamente los cobros de PayPal a Frihet como facturas
  • Paginación completa — Importa todas las transacciones sin límite (paginación automática)
  • Historial inteligente — Primera importación: 1 año de historial. Después: solo transacciones nuevas desde la última sincronización
  • Reembolsos — Los refunds se importan con prefijo [Refund] y monto negativo para contabilidad clara
  • Consultar saldos — Ve tu saldo PayPal directamente desde el panel de Frihet
  • Reconciliar cobros — Asocia transacciones PayPal con facturas existentes
  • Multi-divisa — Maneja cobros en EUR, USD, GBP y otras divisas
  • Deduplicación — Las transacciones ya importadas no se duplican (prefijo PP-)
  • Modo sandbox — Prueba la integración sin afectar datos reales

Requisitos​

  • Cuenta PayPal Business — Las cuentas personales no tienen acceso a la API
  • Aplicación en PayPal Developer — Para obtener Client ID y Client Secret
  • Frihet Pro o superior

Conectar PayPal con Frihet​

Paso 1: Crear una aplicación en PayPal Developer​

  1. Ve a developer.paypal.com
  2. Inicia sesión con tu cuenta PayPal Business
  3. En el dashboard, ve a Apps & Credentials
  4. Selecciona el modo Live (o Sandbox para pruebas)
  5. Haz clic en Create App
  6. Ponle un nombre (ej: "Frihet ERP")
  7. Haz clic en Create App

Una vez creada, verás:

  • Client ID — Un identificador público (ej: AaBbCcDdEe...)
  • Client Secret — Una clave privada (haz clic en "Show" para verla)
Guarda el Secret

El Client Secret solo se muestra una vez. Cópialo y guárdalo en un lugar seguro antes de continuar.

Paso 2: Configurar en Frihet​

  1. Ve a Ajustes → Integraciones
  2. Busca PayPal
  3. Haz clic en Conectar
  4. Introduce tu Client ID y Client Secret
  5. Selecciona el modo:
    • Live — Para transacciones reales
    • Sandbox — Para pruebas con datos ficticios
  6. Haz clic en Verificar conexión
  7. Si es correcto, verás "Conectado"

Paso 3: Verificar conexión​

  1. Frihet obtiene automáticamente un token OAuth2 usando tus credenciales
  2. Si la verificación es exitosa, verás tu saldo PayPal en el panel
  3. Puedes hacer una importación de prueba con las últimas transacciones

Cómo funciona​

Frihet usa la API REST v2 de PayPal con autenticación OAuth2 (client credentials flow):

  1. Tú proporcionas Client ID y Client Secret
  2. Frihet solicita un token de acceso a PayPal automáticamente
  3. Con ese token, Frihet consulta transacciones y saldos
  4. Las credenciales se almacenan cifradas (AES-256-GCM) en Frihet
  5. El token se renueva automáticamente cuando expira

En ningún momento necesitas gestionar tokens manualmente.

Datos sincronizados​

DatoDirecciónFrecuencia
Transacciones recibidasPayPal → FrihetBajo demanda / periódica
Saldo de cuentaPayPal → FrihetEn cada consulta
Datos del pagadorPayPal → FrihetCon cada transacción
Divisa y tipo de cambioPayPal → FrihetCon cada transacción

Casos de uso​

Freelancer con clientes internacionales​

Cobras a clientes en USD y EUR a través de PayPal. Frihet importa cada pago, lo asocia con la factura correspondiente y convierte el importe a tu divisa base.

Tienda online con PayPal como método de pago​

Recibes pagos de clientes vía PayPal Checkout. Las transacciones se importan a Frihet y puedes reconciliarlas con los pedidos facturados.

Verificar saldo antes de pagar proveedores​

Consulta tu saldo PayPal desde el panel de Frihet sin salir de la aplicación. Decide si tienes fondos disponibles antes de emitir transferencias.

Modo Sandbox​

Para probar la integración sin afectar datos reales:

  1. En developer.paypal.com, crea una app en modo Sandbox
  2. Usa las credenciales Sandbox en Frihet (selecciona modo "Sandbox")
  3. PayPal proporciona cuentas de prueba con saldo ficticio
  4. Verifica que las transacciones se importan correctamente
  5. Cuando estés listo, cambia a modo Live con credenciales de producción

Solución de problemas​

"Error de autenticación"​

  • Verifica que el Client ID y Client Secret son correctos
  • Asegúrate de usar credenciales Live en modo Live y Sandbox en modo Sandbox
  • Comprueba que tu cuenta PayPal Business está activa y verificada

"No se importan transacciones"​

  • Verifica que hay transacciones en el periodo consultado (1 año en primera importación, desde última sincronización en siguientes)
  • En modo Sandbox, genera transacciones de prueba desde el dashboard de PayPal Developer
  • Comprueba que tu aplicación en PayPal tiene los permisos necesarios activados
  • Si el toast muestra "No new transactions to import", todas las transacciones ya están en Frihet

"Error de permisos en la API"​

  • Al crear la app en PayPal Developer, asegúrate de que incluya el scope de transacciones
  • Si cambiaste permisos, genera un nuevo Client Secret y actualízalo en Frihet

"Quiero cambiar de Sandbox a Live"​

  1. Ve a Ajustes → Integraciones → PayPal
  2. Haz clic en Desconectar
  3. Vuelve a conectar con las credenciales de producción (Live)

Próximos pasos​