Voltar ao início

Ligue bancos brasileiros ao Liquify

Um guia único com Meu Pluggy—autoriza uma vez, copia as chaves e termina na app.

Para quem é

Qualquer pessoa com login no Liquify (Free, Pro ou Ultra) que queira ligar bancos brasileiros com as próprias chaves Pluggy. É uma configuração no estilo desenvolvedor—sem exigência de Ultra. O Liquify nunca vê o login do banco—você autoriza no Meu Pluggy e compartilha só chaves criptografadas e um Item ID.

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

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.

Ecrã inicial do Meu Pluggy
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).

A escolher o banco para ligar
Escolhe o teu banco na lista.
A confirmar a ligação bancária
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).

Banco ligado no Meu Pluggy
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.

Personalização do painel Pluggy
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.

Conector Meu Pluggy ativado
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.

A criar uma nova aplicação Pluggy
Cria uma Development Application.

Copia os dois valores. Guarda o Client Secret de imediato — a Pluggy pode mostrá-lo só uma vez.

Credenciais da aplicação Pluggy
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.

OAuth do Meu Pluggy no Pluggy Demo
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.

Autorizar acesso do Meu Pluggy
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.

Meu Pluggy autorizado
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.

Folha Editar banco no Liquify com Nome do banco e Nome da conta
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.