Pular para o conteúdo principal

Stripe

Disponível

Esta integração está ativa e pronta para uso em todos os planos Pro.

Conecte Stripe ao Frihet para automatizar cobranças de assinaturas e sincronizar pagamentos automaticamente.

Para que serve?​

Com Stripe integrado:

  • Assinaturas recorrentes — Cobrança automática a cada mês
  • Faturas automáticas — Frihet cria faturas quando há um pagamento
  • Reconciliação automática — Os pagamentos são marcados como recebidos instantaneamente
  • Relatórios sincronizados — Seus números no Frihet refletem a realidade do Stripe

Requisitos​

  • Conta Stripe ativa — Crie uma em stripe.com
  • Permissões de administrador — Em sua conta Stripe
  • Frihet Pro ou superior — Stripe não está disponível no plano Free

Conectar Stripe​

Passo 1: Abra as integrações​

  1. Vá para Ajustes → Integrações
  2. Procure por Stripe
  3. Clique em Conectar

Passo 2: Autenticação​

  1. Você será redirecionado para o Stripe
  2. Faça login com sua conta Stripe
  3. Autorize o Frihet a acessar sua conta
  4. O Frihet redireciona automaticamente

Passo 3: Confirme a conexão​

Uma vez autorizado:

✅ Stripe conectado
ID de cuenta: acct_XXXXXXXXX
Último sincronizado: Hace 2 minutos

Como funciona​

Assinaturas​

Se você tem clientes no Stripe com assinaturas:

  1. O Frihet sincroniza automaticamente cada cliente e seu plano
  2. A cada mês o Stripe cobra o cliente
  3. Ao cobrar, o Frihet cria automaticamente uma fatura
  4. A fatura aparece em sua lista com status "Paga"

Exemplo:

  • Cliente: Empresa SL
  • Plano Stripe: €299/mês
  • 1 fev 2025: Stripe cobra €299
  • Frihet cria fatura de €299 automaticamente
  • Status: Paga ✅

Pagamentos pontuais​

Se você usa Stripe para cobranças pontuais:

  1. Crie a fatura no Frihet
  2. Gere o link de pagamento com Stripe (do Stripe Connect - veja a próxima seção)
  3. Cliente paga
  4. O Frihet marca a fatura como paga automaticamente

Faturamento online​

Com Stripe você pode:

  • Enviar faturas diretamente do Stripe
  • Clientes pagam com cartão, Apple Pay, Google Pay
  • Tudo sincronizado no Frihet

Dados que são sincronizados​

Do Stripe para o Frihet​

DadoSincronização
ClientesA cada 15 minutos
Assinaturas ativasA cada 15 minutos
PagamentosEm tempo real
ReembolsosEm tempo real
FaturasA cada 15 minutos

Do Frihet para o Stripe​

DadoSincronização
Dados do clienteManual (ao criar)
Metadados da faturaManual (ao vincular)

Nota: A sincronização é principalmente do Stripe → Frihet. Não edite clientes no Frihet que existam no Stripe, para evitar conflitos.

Gestão de assinaturas​

Ver assinaturas no Frihet​

  1. Vá para Clientes
  2. Abra um cliente que tenha uma assinatura no Stripe
  3. Na aba Histórico, você verá:
    • Assinatura ativa
    • Próxima cobrança
    • Histórico de pagamentos

Cancelar assinatura​

Se um cliente cancelar sua assinatura no Stripe:

  1. O Frihet detecta a alteração automaticamente
  2. Marca a assinatura como "Cancelada"
  3. Não gera mais faturas

Alterar plano de assinatura​

Se um cliente aumenta ou diminui de plano:

  1. Ele faz isso em seu portal de clientes Stripe (ou você faz manualmente)
  2. O Frihet atualiza a próxima cobrança
  3. A fatura refletirá o novo valor

Reconciliação de pagamentos​

Frihet compara automaticamente:

  • Faturas não pagas no Frihet vs Pagamentos no Stripe
  • Se houver um pagamento que o Frihet desconhece, ele o marca como "Pagamento pendente de registro"
  • Você pode confirmar o pagamento com um clique

Como ver faturas para reconciliar:

  1. Vá para Faturamento → Faturas
  2. Filtre por "Requer reconciliação"
  3. Confirme pagamentos com um clique
  4. Automaticamente a fatura muda para "Paga"

Declarações de impostos​

Com Stripe sincronizado:

  • Seu resumo fiscal inclui pagamentos do Stripe
  • O assistente IA pode consultar: "Quanto eu cobrei no Stripe este mês?"
  • Relatórios de receita refletem a realidade

Segurança​

  • Conexão OAuth — Não compartilhamos a senha do Stripe
  • API restrita — Apenas acesso de leitura de pagamentos, sem acesso a dinheiro
  • Desconexão instantânea — Revogue o acesso em Ajustes quando quiser
  • Criptografia — Tokens armazenados criptografados no Frihet

Desconectar Stripe​

  1. Vá para Ajustes → Integrações
  2. Procure por Stripe
  3. Clique em Desconectar
  4. Confirme a ação

Após desconectar:

  • As assinaturas ativas no Stripe continuam funcionando (mas o Frihet não as vê)
  • Não há novas faturas automáticas
  • Você pode reconectar a qualquer momento

Solução de problemas​

"Não vejo minhas assinaturas no Frihet"​

  • Verifique se o Stripe está conectado (você deve ver "✅ Conectado" em Integrações)
  • Espere 15 minutos para a primeira sincronização
  • As assinaturas devem estar com status "ativo" no Stripe

"Uma fatura não foi marcada como paga"​

  • A reconciliação automática funciona apenas se o valor coincidir exatamente
  • Se houver descontos ou ajustes, pode não ser detectado
  • Marque manualmente na fatura: "Confirmar pagamento" → insira o valor

"Erro ao conectar Stripe"​

  • Verifique se você tem acesso de administrador no Stripe
  • Sua conta Stripe não tem restrições (contate o Stripe se for o caso)
  • Tente desconectar e reconectar
  • Se persistir, contate o suporte
Automações avançadas

Para automações avançadas com Stripe, consulte os webhooks do Frihet que notificam eventos como invoice.created ou invoice.paid em tempo real. Você pode combiná-los com a API REST para construir fluxos personalizados.

Próximos passos​

Próximo: Stripe Connect - Links de pagamento em suas faturas