GoCardless
Esta integração está ativa e pronta para usar no Frihet.
Conecte o GoCardless ao Frihet para gerenciar cobranças por débito direto SEPA. Consulte mandatos, pagamentos e clientes diretamente do seu ERP. Ideal para assinaturas e cobranças recorrentes com taxas baixas.
Para que serve?
Com o GoCardless integrado:
- Importar pagamentos — Importe cobranças do GoCardless como faturas no Frihet com um clique
- Deduplicação automática — Os pagamentos já importados não são duplicados (prefixo
GC-) - Ver pagamentos — Consulte todas as suas cobranças por débito direto a partir do Frihet
- Gerenciar clientes — Acesse as informações de clientes com mandatos ativos
- Consultar mandatos — Veja o status de cada mandato SEPA (ativo, pendente, cancelado)
- Reconciliar cobranças — Associe pagamentos do GoCardless com faturas no Frihet
- Modo sandbox — Teste a integração com dados fictícios
Requisitos
- Conta GoCardless ativa — gocardless.com
- Token de Acesso da API — É gerado a partir do dashboard
- Frihet Pro ou superior
Conectar GoCardless com Frihet
Passo 1: Obter seu Token de Acesso
- Vá para manage.gocardless.com (ou manage-sandbox.gocardless.com para testes)
- Faça login em sua conta
- Vá para Developers no menu lateral
- Clique em Create → Access Token
- Selecione o escopo Read-only (suficiente para consultar dados) ou Read-write se precisar gerenciar cobranças
- Dê um nome (ex: "Frihet ERP")
- Copie o token gerado
O Token de Acesso é exibido apenas uma vez ao criá-lo. Copie-o antes de fechar a janela.
Passo 2: Configurar no Frihet
- Vá para Configurações → Integrações
- Procure por GoCardless
- Clique em Conectar
- Cole seu Token de Acesso
- Selecione o ambiente:
- Live — Para dados reais
- Sandbox — Para testes
- Clique em Verificar conexão
Passo 3: Verificar conexão
Se a conexão estiver correta, o Frihet exibirá:
- Nome da sua organização no GoCardless
- Número de mandatos ativos
- Número de clientes registrados
Como funciona
O Frihet conecta-se à API v2 do GoCardless (versão 2015-07-06) usando autenticação Bearer:
- Você fornece seu Token de Acesso
- O Frihet envia o token no cabeçalho
Authorization: Bearer <token>de cada requisição - Os dados de pagamentos, clientes e mandatos são consultados sob demanda
- O token é armazenado criptografado (AES-256-GCM) no Frihet
- Toda a comunicação é realizada via HTTPS
Dados sincronizados
| Dado | Direção | Frequência |
|---|---|---|
| Pagamentos (cobranças) | GoCardless → Frihet | Sob demanda |
| Clientes | GoCardless → Frihet | Sob demanda |
| Mandatos SEPA | GoCardless → Frihet | Sob demanda |
| Status de pagamentos | GoCardless → Frihet | Sob demanda |
Casos de uso
Consultoria com mensalidades
Você cobra uma mensalidade de seus clientes por débito direto. No Frihet, você pode ver quais pagamentos foram cobrados com sucesso, quais estão pendentes e quais falharam, sem sair do seu ERP.
SaaS com assinaturas SEPA
Seus clientes europeus preferem pagar por débito direto em vez de cartão. O GoCardless gerencia as cobranças recorrentes e o Frihet exibe o status de cada pagamento juntamente com as faturas emitidas.
Verificar mandatos antes de faturar
Antes de emitir uma fatura recorrente, consulte no Frihet se o mandato do cliente ainda está ativo. Evite faturar clientes cujo mandato tenha expirado ou sido cancelado.
Importar pagamentos para o Frihet
Você pode importar os pagamentos do GoCardless como faturas no Frihet:
- Vá para Configurações → Integrações → GoCardless
- Na aba Dados, clique em Importar pagamentos
- O Frihet baixará todos os pagamentos e criará faturas para cada um
- Os pagamentos já importados anteriormente são ignorados automaticamente (deduplicação por
GC-{id}) - Ao finalizar, você verá o número exato de pagamentos importados
Os pagamentos importados incluem: valor, moeda, data, referência e status.
Modo Sandbox
O GoCardless oferece um ambiente sandbox completamente separado:
- Cadastre-se em manage-sandbox.gocardless.com
- Crie um Token de Acesso no ambiente sandbox
- Configure o Frihet em modo "Sandbox"
- Crie mandatos e pagamentos de teste a partir do dashboard sandbox
- Verifique se os dados aparecem corretamente no Frihet
Status de pagamento no GoCardless
| Status GoCardless | Significado |
|---|---|
pending_submission | Pagamento criado, pendente de envio ao banco |
submitted | Enviado ao banco, em processamento |
confirmed | Cobrança realizada com sucesso |
paid_out | Fundos transferidos para sua conta |
failed | A cobrança falhou (fundos insuficientes, mandato cancelado, etc.) |
cancelled | Cancelado antes de ser processado |
Resolução de problemas
"Erro de autenticação"
- Verifique se o Token de Acesso está correto e não expirou
- Certifique-se de usar um token Live em modo Live e Sandbox em modo Sandbox
- Se você regenerou o token no GoCardless, atualize-o no Frihet
"Não vejo meus pagamentos"
- Verifique se você tem pagamentos registrados em sua conta GoCardless
- Verifique se o token tem permissões de leitura
- No sandbox, crie pagamentos de teste primeiro
"Erro de versão da API"
- O Frihet usa a versão da API 2015-07-06 do GoCardless, que é estável e compatível
- Se o GoCardless notificar mudanças na API, atualizaremos a integração
"Quero desconectar"
- Vá para Configurações → Integrações → GoCardless
- Clique em Desconectar
- Opcionalmente, revogue o Token de Acesso do dashboard do GoCardless