FAQ

Aqui você encontrará as perguntas mais frequentes.

O que é um item?

Um item representa a conexão entre um usuário e uma instituição financeira, bem como todos os dados retornados nessa conexão.

O que é uma aplicação e quais os tipos disponíveis?

Uma aplicação diz respeito as chaves de clientId e clientSecret utilizadas para acessar a API. Essas chaves devem ser manuseadas com atenção, pois é somente com elas que os dados da API podem ser retornados. É possível criar aplicações nos ambientes de Desenvolvimento e Produção.

Como consultar as instituições financeiras disponíveis para conexão?

Existem algumas maneiras de consultar as instituições financeiras (conectores) disponíveis:

• Documentação:

Conectores Open Finance (regulado) consultar aqui.

Conectores Pluggy (não regulado) consultar aqui.

• API:

Consultar [aqui](> https://docs.pluggy.ai/reference/connectors-list).

• Dashboard:

Consultar [aqui](1. https://dashboard.pluggy.ai/customization).

Quais instituição precisam de token para conectar?

As instituições que requerem token para realizar a conexão podem ser analisadas nesta página de nossa documentação.

As novas transações de uma conta são atualizadas em tempo real?

Não. As novas transações de uma conta somente estarão disponíveis para a consulta após uma atualização na conexão. Para mais informações sobre a atualização das contas, consultar nossa documentação.

P.S.: Novas transações nos conectores Open Finance (regulado) podem levar até 24h para estarem disponíveis para consulta

Como funciona a atualização automática?

A Pluggy sistematiza uma atualização automática para os itemIds. Basta manifestar interesse nos nossos canais de comunicação. É possível escolher um horário de início das atualizações. Os itemIds vão para uma fila e são atualizados de acordo com a capacidade de processamento, para evitar sobrecargas.

Como habilitar os conectores em minha aplicação?

Para habilitar conectores na nossa widget, basta acessar a aba de Customização na nosso dashboard.

Como ir para produção?

Para ir para produção, basta criar uma nova aplicação de produção na nossa dashboard, aba de Aplicações, clicando em “Ir para a produção”.

É importante criar essa aplicação de produto pois, nessa aplicação:

• É disponibilizada atualização automática;
• Não há limite de itemIds;
• Não há acesso a página demo para que dados sensíveis de clientes não fiquem expostos;

Qual a diferença entre apiKey e connectToken?

apiKey é a chave que dá acesso à nossa API. É obtida através das credenciais do cliente na Pluggy (clientId & clientSecret) e tem validade de 2 horas.

connectToken é a chave utilizada para acessar o Pluggy Connect Widget, ou seja, a interface gráfica de nossa API. Para obter o connectToken é necessário a obtenção da apiKey em primeiro lugar. O connectToken tem duração de 30 minutos.

Para mais informações, acesse nossa documentação.

Qual a diferença entre conectores Pluggy e conectores Open Finance ?

Conectores Pluggy, também chamados de conexão direta ou conectores não-regulado, são os conectores criados pela Pluggy, com tecnologia proprietária. Neles, acessamos diretamente as instituições financeiras e retornamos os dados conforme dispostos no Internet Banking.

Conectores Open Finance, também chamados de conectores regulados, são os conectores que acessam a estrutura regulada pelo Banco Central, onde as instituições compartilham os dados solicitados pelos usuários através do consentimento. Nesses conectores, nós coletamos os dados que as instituições compartilham e retornamos para você de maneira padronizada e enriquecida.

Para mais informações, acesse nossa documentação.

Como posso identificar que uma conexão (itemId) pertence a um cliente específico?

Nós disponibilizamos um campo para ser preenchido com as informações do usuário que está realizando a conexão. Esse campo é o “clientUserId” e deve ser enviado no momento da criação do item (conexão da conta) ou, para usuários da Pluggy Connect Widget, pode ser enviado no momento de sua abertura.

O campo “clientUserId” recebe qualquer dado (string) que você quiser enviar, mas recomendamos o seguinte padrão: “<nome do usuário> | | ".

Mais detalhes em nossa documentação.

Se um usuário conectar duas vezes a mesma conta, serão geradas duas conexões diferentes?

Sim. Cada vez que o usuário dá seu consentimento (inserção de credenciais nos conectores Pluggy ou seleção dos dados a serem compartilhados nos conectores Open Finance), é gerada nova conexão (novo itemId). Para evitar que isso ocorra, devemos realizar uma conexão e atualizar essa mesma conexão (itemId) para que os dados mais recentes possam ser retornados pela nossa API.

Para mitigar esse cenário, oferecemos uma configuração que verifica se a conta já foi conectada anteriormente. Para mais informações, acesso nossa documentação.

Quais os eventos disponíveis no webhook?

A lista dos eventos disponíveis pode ser consultada aqui.

É possível pular a etapa de selecionar o banco na Pluggy Connect Widget?

Sim, nós disponibilizamos um atributo (selectedConnectorId) que permite exibir apenas o conector pré-definido. Mais detalhes em nossa documentação.

É possível ter ambientes de Desenvolvimento e Produção separados? Mudaria o client_id/secret?

Sim, é possível criar diferentes ambientes através de nosso Dashboard. Quando um novo ambiente é criado, novas credenciais são geradas (clientId e clientSecret).

O ambiente de Desenvolvimento (Development) tem um limite de criação de 100 itens.

É possível listar todos os items que eu já criei na Pluggy?

Items can’t be queried due to security reasons, to avoid any data leak