Relatando Problemas

Visão Geral #

Este guia explica como entender problemas que os usuários podem ter e como relatá-los à equipe de suporte da Pluggy.

Quando um item encontra um erro esperado, ele retornará com o status OUTDATED, com ERROR como o status de execução. Erros podem ocorrer após a fornecimento de credenciais, quando o item começa a se conectar à instituição financeira e começa a fornecer respostas/webhooks.

Erros Inesperados #

Erros inesperados geralmente são retornados quando a instituição financeira (FI) está instável ou quando há um caso que não foi mapeado pela Pluggy. Se erros inesperados forem consistentes, você deve relatá-los à equipe.

Quando a instituição está enfrentando uma instabilidade, o executionStatus será SITE_NOT_AVAILABLE. No entanto, quando é um erro inesperado do lado da Pluggy, o executionStatus será ERROR ou CONNECTION_ERROR.

Erros de Conexão #

Erros de conexão ocorrem após a fornecimento de credenciais, quando o item começa a se conectar à instituição financeira. Esses erros estão tipicamente relacionados a:

Instabilidade ou inatividade da instituição
Cenários não mapeados do lado da Pluggy
Mudanças de autenticação na instituição

Como Relatar Problemas #

Quando você está enfrentando problemas, a chave é fornecer contexto suficiente para que a equipe de suporte possa investigar.

Ao usar o widget, o usuário acabará em uma tela com um erro inesperado e um ErrorCode. Se você estiver usando o Connect widget da Pluggy, esse erro será exibido no widget. Relate uma captura de tela do widget para dar à equipe de suporte contexto suficiente.

Usando a API Diretamente #

Se você estiver criando sua própria UX, você verá o erro na resposta HTTP POST /items. Relate a resposta HTTP para dar à equipe de suporte contexto suficiente.

Evidência: o itemId é obrigatório

Ao usar o widget, uma captura de tela da tela de erro ou do código de erro é suficiente.

É altamente recomendável que os clientes rastreiem as tentativas de conexão de seus usuários, armazenando-as como conexões malsucedidas. Você pode capturar o itemId através da implementação do seu Connect widget da Pluggy, capturando o evento onError, ou através do evento webhook item/error.

Ao se conectar diretamente através da API, envie o itemId trocado no fluxo da API.

Não podemos analisar erros sem um itemId, então é obrigatório que você o capture e forneça.

Relatório de Execução #

Mais informações sobre o que falhou estarão disponíveis no campo executionReport do Item. Se algo der errado fatalmente com a conexão, como um erro inesperado, e nenhum dado puder ser recuperado, o status do Item será OUTDATED e o executionStatus relacionado será ERROR.

O widget e a resposta HTTP fornecem informações suficientes para você entender o que está dando errado, e eles dão à equipe de suporte o contexto necessário para investigar o problema.

Erros ao Fornecer Credenciais (HTTP 400)#

Geralmente, esse problema ocorre quando o usuário envia suas credenciais, mas a criação do Item não é bem-sucedida. Isso significa que a criação do Item retorna um erro HTTP 400 para validações.

Geralmente, isso significa:

As credenciais não estão no formato correto.
Existem credenciais ausentes.
Há uma conexão ativa, ou uma conexão duplicada foi detectada.

Se você estiver usando o Connect widget da Pluggy, esse erro será exibido no widget; se você estiver criando sua própria UX, você verá esse erro na resposta HTTP POST /items. Para mais detalhes sobre quais erros são retornados, você pode conferir a referência da API.

Evidência

Quando você está tendo esse tipo de problema, relate uma captura de tela do widget ou a resposta HTTP para dar à equipe de suporte contexto suficiente. Esperamos que o widget e a resposta HTTP forneçam informações suficientes para você entender o que está dando errado.

Página de Status #

A Pluggy tem uma página de status pública onde eles publicam quaisquer incidentes e interrupções para que você possa ficar ciente de quaisquer problemas existentes. Você pode visitar a página de status em status.pluggy.ai.

Você também pode se inscrever usando o botão no topo da página de status para ser notificado sobre incidentes assim que eles acontecerem. Você pode receber atualizações de incidentes e mensagens de status de manutenção no Slack ao se inscrever.

Para mais informações sobre como se inscrever na página de status, veja Inscreva-se em nossa Página de Status.