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 é

Quem usa Liquify Ultra—incluindo o período experimental gratuito de 30 dias—e quer ligar bancos brasileiros. O Liquify nunca vê o login do banco — autorizas no Meu Pluggy e partilhas apenas chaves de API encriptadas e um Item ID.

Antes de começares

  • Liquify Ultra (subscrição ou período experimental gratuito de 30 dias)
  • Um banco brasileiro com suporte a Open Finance
  • Cerca de 15 minutos para uma configuração única (repete o OAuth do Demo uma vez por banco)

Dois sites da Pluggy — não os confundas

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é 10 por pessoa).

Banco ligado no Meu Pluggy
Os bancos ligados aparecem aqui.

2. Cria uma conta de programador Pluggy

Regista-te em dashboard.pluggy.ai. A Pluggy inicia um trial curto no painel; depois podes continuar no caminho do Meu Pluggy para sincronizar bancos pessoais no Liquify.

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.

No Liquify: Ligar banco → Brasil → cola Client ID, Client Secret e Item ID. O Liquify encripta as chaves nos nossos servidores e inicia a sincronização.

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.

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.

Capturas de ecrã cortesia da Pluggy (interface do Meu Pluggy em português).