Procurando a documentação anterior?Acesse v1.docs.pluggy.ai
PluggyDocs

Dashboard: conectores, testar conexões e o itemId

Passo a passo no Dashboard da Pluggy: escolha quais conectores o Pluggy Connect exibe, conecte uma conta diretamente do Dashboard e copie o itemId e suas credenciais da API.

Ver como Markdown

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 connector 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.

  1. No menu à esquerda, abra Customização (sob Dados Financeiros).
  2. Vá para a aba Conectores.

  1. 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.
  2. 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.

  1. 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ê.

  1. Abra Aplicações e clique na aplicação que você deseja usar (o ícone de engrenagem abre suas configurações).
  2. Abra sua página Demo e clique em Conectar Conta.

  1. 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=…).

  1. Na mesma página Demo, a coluna à esquerda Itens Conectados lista os itens da aplicação.
  2. 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#

  1. Abra Aplicações. Cada linha de aplicação mostra seu Client ID e um Client Secret mascarado, com botões para revelá-los e copiá-los.

  1. Troque-os por uma chave de API com POST /auth (veja Autenticação).

O secret pode ser revelado novamente a qualquer momento a partir do mesmo local. Renovar Secret, nas configurações da aplicação, o rotaciona — o secret antigo para de funcionar.

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.
Esta página foi útil?