Pular para o conteúdo principal

PayPal

Disponível

Esta integração está ativa e pronta para uso no Frihet.

Conecte sua conta PayPal Business ao Frihet. Importe transações, consulte saldos e reconcilie recebimentos internacionais com suas faturas de forma automática. Suporta modo sandbox para testes.

Para que serve?​

Com o PayPal integrado:

  • Importar transações — Traz automaticamente os recebimentos do PayPal para o Frihet como faturas
  • Paginação completa — Importa todas as transações sem limite (paginação automática)
  • Histórico inteligente — Primeira importação: 1 ano de histórico. Depois: apenas transações novas desde a última sincronização
  • Reembolsos — Os refunds são importados com o prefixo [Refund] e valor negativo para contabilidade clara
  • Consultar saldos — Visualize seu saldo PayPal diretamente no painel do Frihet
  • Reconciliar recebimentos — Associa transações PayPal com faturas existentes
  • Multi-moeda — Gerencia recebimentos em EUR, USD, GBP e outras moedas
  • Deduplicação — As transações já importadas não são duplicadas (prefixo PP-)
  • Modo sandbox — Teste a integração sem afetar dados reais

Requisitos​

  • Conta PayPal Business — As contas pessoais não têm acesso à API
  • Aplicação no PayPal Developer — Para obter o Client ID e Client Secret
  • Frihet Pro ou superior

Conectar PayPal ao Frihet​

Passo 1: Criar uma aplicação no PayPal Developer​

  1. Acesse developer.paypal.com
  2. Faça login com sua conta PayPal Business
  3. No dashboard, vá para Apps & Credentials
  4. Selecione o modo Live (ou Sandbox para testes)
  5. Clique em Create App
  6. Dê um nome (ex: "Frihet ERP")
  7. Clique em Create App

Após criada, você verá:

  • Client ID — Um identificador público (ex: AaBbCcDdEe...)
  • Client Secret — Uma chave privada (clique em "Show" para visualizá-la)
Guarde o Secret

O Client Secret é exibido apenas uma vez. Copie-o e guarde-o em um local seguro antes de continuar.

Passo 2: Configurar no Frihet​

  1. Acesse Ajustes → Integrações
  2. Procure por PayPal
  3. Clique em Conectar
  4. Insira seu Client ID e Client Secret
  5. Selecione o modo:
    • Live — Para transações reais
    • Sandbox — Para testes com dados fictícios
  6. Clique em Verificar conexão
  7. Se estiver correto, você verá "Conectado"

Passo 3: Verificar conexão​

  1. O Frihet obtém automaticamente um token OAuth2 usando suas credenciais
  2. Se a verificação for bem-sucedida, você verá seu saldo PayPal no painel
  3. Você pode fazer uma importação de teste com as últimas transações

Como funciona​

O Frihet usa a API REST v2 do PayPal com autenticação OAuth2 (client credentials flow):

  1. Você fornece o Client ID e Client Secret
  2. O Frihet solicita um token de acesso ao PayPal automaticamente
  3. Com esse token, o Frihet consulta transações e saldos
  4. As credenciais são armazenadas criptografadas (AES-256-GCM) no Frihet
  5. O token é renovado automaticamente quando expira

Em nenhum momento você precisa gerenciar tokens manualmente.

Dados sincronizados​

DadoDireçãoFrequência
Transações recebidasPayPal → FrihetSob demanda / periódica
Saldo da contaPayPal → FrihetEm cada consulta
Dados do pagadorPayPal → FrihetCom cada transação
Moeda e taxa de câmbioPayPal → FrihetCom cada transação

Casos de uso​

Freelancer com clientes internacionais​

Você cobra clientes em USD e EUR através do PayPal. O Frihet importa cada pagamento, o associa à fatura correspondente e converte o valor para sua moeda base.

Loja online com PayPal como método de pagamento​

Você recebe pagamentos de clientes via PayPal Checkout. As transações são importadas para o Frihet e você pode reconciliá-las com os pedidos faturados.

Verificar saldo antes de pagar fornecedores​

Consulte seu saldo PayPal no painel do Frihet sem sair da aplicação. Decida se você tem fundos disponíveis antes de emitir transferências.

Modo Sandbox​

Para testar a integração sem afetar dados reais:

  1. Em developer.paypal.com, crie uma aplicação no modo Sandbox
  2. Use as credenciais Sandbox no Frihet (selecione o modo "Sandbox")
  3. O PayPal fornece contas de teste com saldo fictício
  4. Verifique se as transações são importadas corretamente
  5. Quando estiver pronto, mude para o modo Live com credenciais de produção

Solução de problemas​

"Erro de autenticação"​

  • Verifique se o Client ID e Client Secret estão corretos
  • Certifique-se de usar credenciais Live no modo Live e Sandbox no modo Sandbox
  • Verifique se sua conta PayPal Business está ativa e verificada

"Nenhuma transação é importada"​

  • Verifique se há transações no período consultado (1 ano na primeira importação, desde a última sincronização nas seguintes)
  • No modo Sandbox, gere transações de teste no dashboard do PayPal Developer
  • Verifique se sua aplicação no PayPal tem as permissões necessárias ativadas
  • Se a notificação mostrar "No new transactions to import", todas as transações já estão no Frihet

"Erro de permissões na API"​

  • Ao criar a aplicação no PayPal Developer, certifique-se de que inclua o scope de transações
  • Se você alterou as permissões, gere um novo Client Secret e atualize-o no Frihet

"Quero mudar de Sandbox para Live"​

  1. Acesse Ajustes → Integrações → PayPal
  2. Clique em Desconectar
  3. Conecte novamente com as credenciais de produção (Live)

Próximos passos​