Três coisas que toda integração precisa do Pluggy Dashboard, com o local exato para clicar. Os mesmos passos funcionam para qualquer conector — um banco, uma instituição de Open Finance, ou o MeuPluggy para uso pessoal (veja Uso pessoal com Meu Pluggy).
1. Escolha quais conectores o Pluggy Connect exibe#
A seleção de conectores é definida uma vez para sua equipe e se aplica ao widget Pluggy Connect de cada aplicação.
- No menu à esquerda, abra Customização (sob Dados Financeiros).
- Vá para a aba Conectores.
- Escolha um modo:
- Padrão para todos selecionados — todos os conectores disponíveis são exibidos.
- Seleção personalizada ativa — apenas os conectores que você ativar são exibidos.
- Use a caixa de pesquisa para encontrar um conector pelo nome (por exemplo
MeuPluggy,Itaú,Nubank). Os resultados são agrupados por categoria (Pessoal, Negócios, Investimento); abra um grupo e escolha entre suas abas Conectores OF e Direct Connectors — MeuPluggy é um conector Direct (ele possui o selo Direct). No modo personalizado, ative o interruptor do conector.
- Use Pré-visualização à direita para abrir o widget real e verificar a lista que seus usuários verão.
Mantenha pelo menos um conector
O Pluggy Connect sempre precisa de pelo menos um conector selecionado. A marca (nome, logo, cores, texto do botão) está na aba Geral da mesma página — veja Customização.
2. Conectar uma conta a partir do Dashboard#
Você não precisa de um frontend para testar uma conexão: cada aplicação tem uma página Demo que abre o Pluggy Connect para você.
- Abra Aplicações e clique na aplicação que você deseja usar (o ícone de engrenagem abre suas configurações).
- Abra sua página Demo e clique em Conectar Conta.
- Escolha a instituição no widget e finalize a conexão. O conector Sandbox está sempre listado aqui (pesquise
Sandbox), então você pode testar com as credenciais do sandbox em qualquer plano; o item que ele cria é chamado Pluggy Bank.
3. Encontre o itemId#
Cada conexão cria um Item, e seu id — o itemId — é o que a API usa para ler dados (GET /accounts?itemId=…).
- Na mesma página Demo, a coluna à esquerda Itens Conectados lista os itens da aplicação.
- Clique em um item: seus detalhes mostram o itemId com um botão de copiar, além de suas contas, identidade e investimentos.
Na sua própria integração, o itemId também chega no callback onSuccess do widget e em cada webhook item/* — armazene-o quando a conexão for criada. Veja Item.
4. Client ID e Client Secret#
- Abra Aplicações. Cada aplicação mostra seu Client ID, que você pode copiar a qualquer momento.
- O Client Secret é exibido apenas uma vez, quando é gerado: quando você cria a aplicação, ou quando clica em Gerar novo secret na página da aplicação. Copie-o para o seu gerenciador de segredos imediatamente — o diálogo só fecha após você confirmar que o armazenou.
- Troque ambos por uma chave de API com
POST /auth(veja Autenticação).
O secret não pode ser visualizado novamente
Depois que esse diálogo é fechado, o Client Secret não está disponível em nenhum lugar — nem no Dashboard e nem através da API. Se você perdê-lo, clique em Gerar novo secret na página da aplicação. O secret anterior para de funcionar imediatamente, então atualize toda integração que o utiliza.
Apenas Owners e Admins da equipe podem gerar um novo secret. Quando uma aplicação é movida para produção, seu secret é rotacionado e o Dashboard exibe um aviso pedindo a um Owner ou Admin para gerar um novo.
Perguntas comuns#
- "O conector que eu quero não está no widget." Verifique a aba Conectores: no modo personalizado, apenas conectores ativados aparecem.
- "Eu quero dados reais (de produção)." As empresas solicitam isso com Liberar dados reais na aplicação (isso leva a Vendas e due diligence). Para uso pessoal, escolha essa opção e você será direcionado para Meu Pluggy, que é gratuito.