Conectar bancos pela Pluggy
Como ligar suas contas bancárias e cartões ao Gestify Finance usando a sua conta gratuita da Pluggy e o Meu Pluggy.
A Pluggy é a empresa que conecta o Gestify Finance aos bancos pelo Open Finance. Com ela, os saldos e as transações das suas contas e cartões entram no Gestify Finance sozinhos, sem você exportar nada.
Você usa a sua própria conta da Pluggy, que é gratuita. O Gestify Finance só lê os dados com as chaves que você cadastrar.
O que o plano gratuito da Pluggy cobre
Até 5 conexões de contas do mesmo titular, feitas pelo Meu Pluggy, com atualização a cada 24 horas. Para mais que isso, veja os planos da Pluggy. Se o seu banco não couber, você pode importar o extrato.
Antes de começar
Você vai usar dois sites da Pluggy, com o mesmo login nos dois:
- Meu Pluggy: onde você autoriza cada banco.
- Dashboard da Pluggy: onde ficam as chaves (Client ID e Client Secret) que o Gestify Finance usa.
O passo a passo leva uns 10 minutos.
Passo a passo
Conecte seus bancos no Meu Pluggy
Crie sua conta em meu.pluggy.ai e adicione cada banco que você quer ver no Gestify Finance. Cada banco pede a sua própria autorização (CPF ou CNPJ, aprovação no app do banco).
Banco que você adicionar depois também precisa ser autorizado lá.
Entre no Dashboard da Pluggy
Acesse dashboard.pluggy.ai com a mesma conta do Meu Pluggy e abra Aplicações. Se ainda não houver nenhuma aplicação sua, crie uma (o nome pode ser "Gestify Finance").
Copie o Client ID e o Client Secret
Em Aplicações:
- O Client ID aparece na linha da sua aplicação. Dá para copiar a qualquer momento.
- O Client Secret só é mostrado uma vez, quando é gerado. Se você não guardou, abra a aplicação e clique em Gerar novo secret.
Ao gerar um novo secret, o anterior para de funcionar na hora. Se você já tinha cadastrado as chaves no Gestify Finance, cadastre de novo (veja Trocar as chaves).
Confira se o conector MeuPluggy está liberado
Só é preciso se você mudou a lista de conectores da Pluggy. No Dashboard, abra
Customização → Conectores. Se estiver em Seleção personalizada,
pesquise MeuPluggy e ative o conector (ele fica na aba Direct
Connectors do grupo Pessoal).
Cadastre as chaves no Gestify Finance
No Gestify Finance, abra Integrações → Integrações disponíveis e, em Bancos (Pluggy), clique em Conectar.
Cole o Client ID e o Client Secret e clique em Salvar chaves. O Gestify Finance confere as chaves com a Pluggy antes de salvar. O secret fica criptografado e nunca volta para o navegador.
Conecte o banco pelo MeuPluggy
Clique em Conectar banco pela Pluggy. Na janela da Pluggy, escolha MeuPluggy (e não o seu banco nem o Sandbox) e entre com a sua conta do Meu Pluggy.
Se a janela pedir CPF e aprovação no app do banco de novo, você escolheu o banco em vez do MeuPluggy. Feche e escolha MeuPluggy.
Pronto
A conexão aparece em Integrações → Conexões. Abra-a e clique em Sincronizar agora para trazer as contas e transações na hora. Depois disso, o Gestify Finance sincroniza sozinho.
Depois de conectar
- Atualização: o Meu Pluggy busca os dados nos bancos a cada 24 horas, e o Gestify Finance lê o que ele já buscou. Uma transação de hoje pode aparecer só amanhã.
- Contas que não são da empresa: na página da conexão, marque como ignorada a conta que não deve entrar nos relatórios. Ela some do saldo e dos lançamentos.
- Limite do plano: cada conexão conta como um banco na faixa do seu plano do Gestify Finance. Veja o uso clicando no nome da organização, no topo do menu lateral, e depois em Plano e uso.
Problemas comuns
"A Pluggy recusou essas chaves"
O Client ID e o Client Secret precisam ser da mesma aplicação. Confira se você copiou o secret inteiro e se ele não foi trocado depois (gerar um novo invalida o anterior).
Um banco não apareceu
Confira se ele foi autorizado no Meu Pluggy (passo 1). Se o banco já aparece no Dashboard da Pluggy, em Aplicações → sua aplicação → Demo → Itens Conectados, copie o itemId dele e, no Gestify Finance, use Já tenho o ID do item na janela de conexão.
A conexão parou de trazer dados depois de um ano
A autorização do Meu Pluggy para a sua aplicação vence em um ano. Para renovar, conecte de novo pelo MeuPluggy (passo 6). Se a Pluggy criar uma conexão nova, você pode ignorar as contas da antiga.
Trocar as chaves
Na janela Conectar banco (Pluggy), clique em Trocar chaves e cadastre o novo Client ID e Client Secret.
Cada banco conectado pertence à conta da Pluggy que o conectou. Se você cadastrar as chaves de outra conta da Pluggy, os bancos conectados pela anterior param de sincronizar e precisam ser conectados de novo.