Visão geral
Destina-se a quem tem sessão iniciada no Liquify (Free, Pro ou Ultra) e quer ligar bancos brasileiros com as tuas próprias chaves Pluggy. É uma configuração ao estilo de programador—sem exigência de Ultra. O Liquify nunca vê o início de sessão do teu banco—autorizas o banco no Meu Pluggy e partilhas apenas chaves de API encriptadas e um Item ID. Para limites e para saber como funciona a sincronização, consulta Sincronização bancária.
Antes de começares
- Uma conta Liquify com sessão iniciada (Free, Pro ou Ultra)
- Um banco brasileiro com Open Finance
- Cerca de 15 minutos para a configuração única (repita o Demo OAuth uma vez por banco)
- O Meu Pluggy pode mostrar um período experimental — ignora-o; para uso pessoal continua gratuito para sempre com até 5 ligações bancárias
Links da Pluggy — não confundas os portais
meu.pluggy.ai
App de consumidor onde ligas cada banco brasileiro via Open Finance.
dashboard.pluggy.ai
Portal de programador onde crias uma app, ativas o Meu Pluggy e copias Client ID, Client Secret e Item ID.
Cobertura de bancos
Vê quais bancos brasileiros a Pluggy oferece via Open Finance antes de ligar.
Guia Meu Pluggy
Passo a passo da própria Pluggy se algo falhar do lado deles ao ligar ou autorizar.
1. Liga os teus bancos no Meu Pluggy
Regista-te em meu.pluggy.ai. No ecrã inicial, toca no botão principal para começar a ligar um banco.
Início do Meu Pluggy — toca no botão principal para ligar um banco.
Procura o teu banco, seleciona-o e conclui o fluxo Open Finance do próprio banco (CPF, agência, palavra-passe ou SMS — conforme o banco).
Escolhe o teu banco na lista.
Introduz o CPF e conclui o login do banco.
Quando correr bem, o banco aparece em contas ligadas. Repete para cada banco brasileiro que quiseres no Liquify (até 5 por pessoa).
Os bancos ligados aparecem aqui.
2. Cria uma conta de programador Pluggy
Registe-se em dashboard.pluggy.ai. A Pluggy pode iniciar um trial curto do dashboard — ignore isso neste setup. O Meu Pluggy continua gratuito para sync pessoal; o Liquify não exige Ultra neste caminho Pluggy (Brasil).
3. Ativa o conector Meu Pluggy
No painel Pluggy, abre Customization → Connector list. O Meu Pluggy é fácil de esquecer — ativa-o antes de continuares.
Customization → Connector list.
Depois de ativares o Meu Pluggy, deve aparecer na lista de conectores. Sem este passo, o OAuth do Demo depois não mostra Meu Pluggy.
Meu Pluggy ativado na lista de conectores.
4. Cria uma Development Application e copia as chaves
Na página Application, cria uma Development Application. Recebes um Client ID e um Client Secret para colar no Liquify.
Cria uma Development Application.
Copia os dois valores. Guarda o Client Secret de imediato — a Pluggy pode mostrá-lo só uma vez.
Copia o Client ID e o Client Secret.
5. Autoriza o Meu Pluggy no Pluggy Demo (uma vez por banco)
Abre o Pluggy Demo pelo painel, inicia uma ligação e escolhe Meu Pluggy para começar o OAuth.
Inicia o OAuth do Meu Pluggy no Pluggy Demo.
Permite o acesso e escolhe qual banco do Meu Pluggy partilhar. Faz isto uma vez por banco, não por conta.
Escolhe o banco e permite o acesso.
Quando a autorização correr bem, o Demo mostra o item Meu Pluggy ligado. Cada banco torna-se o seu próprio Item.
Autorizado — o banco está pronto a importar.
6. Copia o Item ID e termina no Liquify
Na página Items do painel Pluggy (ou no menu do item no Demo), copia o Item ID (UUID) desse banco.
Registe-se em dashboard.pluggy.ai. A Pluggy pode iniciar um trial curto do dashboard — ignore isso neste setup. O Meu Pluggy continua gratuito para sync pessoal; o Liquify não exige Ultra neste caminho Pluggy (Brasil).
O mesmo Client ID e Secret servem para todos os bancos; cada banco precisa do seu Item ID. O Liquify atualiza cerca de a cada 6 horas e quando puxas para atualizar. Desligar no Liquify não apaga a ligação no Meu Pluggy ou na Pluggy.
7. Mude o nome do banco e das contas no Liquify
Em Ligar banco, abra Editar banco na ligação. Defina um Nome do banco e um Nome para cada conta para as encontrar facilmente ao associar caixas. Deixe o campo vazio para manter o rótulo atual.
Editar banco — mude o nome do banco e de cada conta no Liquify.
Estás pronto quando…
O Liquify mostra o banco em Ligar banco / Contas com saldos. Associa contas às caixas em Editar caixa de despesas quando quiseres Plano vs Contas.
Se a ligação mostrar Precisa religar, toca em Religar no Liquify e introduz de novo o Client ID, Client Secret e Item ID — os campos podem já vir preenchidos da última vez. Isso só atualiza o Liquify; não abre o banco. Se o consentimento do banco expirou (em geral a cada ~90 dias), renova primeiro no Meu Pluggy / Pluggy Demo e depois usa Religar no Liquify com o Item ID atual.