Eu recebi um erro, o que devo fazer? – Belvo - Centro de Ajuda

Se houver um erro tentando obter dados de um ponto final ou tentando criar um link, você receberá uma mensagem indicando o que aconteceu:

Para entender o que causou o erro e que ação você deve tomar, consulte nosso guia Belvo API and Widget Errors.

Aqui temos a lista com todos os erros causas e ações a serem tomadas, caso algum deles aconteça:

HTTP código	API Código de Erro	Descrição default	Relevante no widget?	Widget código de erro	Widget descrição do erro	Causa	Ação
500	unexpected_error	"Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution"	Sim	Ocorreu um erro	Ocorreu um erro ao vincular sua conta. Por favor, tente novamente e se o problema persistir, vamos corrigi-lo o mais rápido possível.	Houve uma mudança do lado da instituição que impede que a integração da Belvo funcione. O detalhe pode ser intermitente ou persistente.	Recomendamos repetir a chamada máxima 3 vezes caso o detalhe seja intermitente. Realizando a mesma operação e recebendo um terceiro erro 500, informe a Belvo com o request_id.
400	activation_failed	"The credentials provided were not accepted by the institution. Please verify CVV and PIN are correct."	Não	N/A	N/A	O usuário final não ativou seu banco online com a instituição com a qual está tentando criar um link. Belvo tentou ativar seu banco on-line, mas o CVV e o PIN inseridos estão incorretos.	É necessário que o usuário final entre em contato com seu banco para ativar seu banco online. O processo de ativação do banco online varia de acordo com a instituição. O site do banco deve indicar os passos a seguir. Depois de ativar seu banco online, o usuário final poderá criar um link com o Belvo com as mesmas credenciais. *É importante observar que uma conta no APP da instituição é diferente de um banco online da instituição.
400	institution_down	"The financial institution is down, try again later"	Sim	Ocorreu um erro	Esta instituição está temporariamente inacessível. Tente novamente mais tarde e poderemos processar sua solicitação.	O aplicativo da instituição está fora do ar ou em manutenção, portanto, o Belvo não pode criar novos links ou consumir informações financeiras.	A Belvo monitora constantemente as instituições. Para receber alertas no caso de algum detalhe com uma instituição, sugerimos que você se inscreva em nossa Página de Status de Instituições. *É possível filtrar quais instituições são exibidas no widget com o parâmetro "instituições": []. Como filtrar instituições
400	institution_inactive	N/A	Não	N/A	N/A	A Belvo desativou esta instituição dentro da API.	Enquanto uma instituição estiver desativada não é possível criar um link ou consumir informações financeiras de um link. *É possível filtrar quais instituições são exibidas no widget com o parâmetro "instituições": [].
400	institution_unavailable	"The financial institution is unavailable"	Sim	Ocorreu um erro	Esta instituição está temporariamente inacessível. Tente novamente mais tarde e iremos processar sua solicitação.	O aplicativo da instituição está temporariamente fora do ar ou em manutenção, portanto o Belvo não pode criar novos links ou consumir informações financeiras.	A Belvo monitora constantemente as instituições. Para receber alertas no caso de algum detalhe com uma instituição, sugerimos que você se inscreva em nossa Página de Status de Instituições. *É possível filtrar quais instituições são exibidas no widget com o parâmetro "instituições": [].
400	invalid_link	"The link has been invalidated. You may need to update link credentials"	Não	N/A	N/A	Foi feita uma tentativa de realizar um POST para algum endpoint de um link com status inválido. * Um link com status válido muda para status inválido após 6 chamadas POST com falha.	É necessário revisar os erros das chamadas POSTs mais recentes do link.
400	too_many_sessions	"Impossible to login, a session is already opened with the institution for these credentials"	Sim	Muitas sessões abertas	Parece que já existe uma sessão aberta nesta instituição com o seu nome de usuário. Esta instituição só permite uma sessão aberta de cada vez.	As instituições financeiras só permitem que uma sessão seja aberta por vez. Caso o usuário final tenha sua conta aberta no APP móvel ou seu banco online, não será possível criar um novo vínculo com o Belvo ou consumir dados financeiros deste usuário.	O usuário final deve certificar-se de sair de seu aplicativo móvel, bem como no banco online. Sugerimos também fechar o navegador ou quaisquer abas abertas. Depois que o usuário final encerrar todas as suas sessões abertas, ele poderá criar um link com o Belvo ou consumir dados financeiros de qualquer endpoint.
400	unconfirmed_link	"The link creation has not been completed yet"	Não	N/A	N/A	Foi feita uma tentativa de consumir dados de um link com status unconfirmed_link. * Um link tem status unconfirmed_link quando um token foi necessário para concluir a criação do link, mas o token inserido era inválido.	O usuário final deve inserir um token válido no widget no update mode atrelado a este link_id. O usuário final insere um token válido, o status do link será atualizado para válido e os dados do link poderão ser consumidos.
400	unsupported_operation	"The resource you are trying to access is not supported by this institution"	Sim	Ocorreu um erro	Ocorreu um erro com sua solicitação. Por favor, tente novamente e se o problema persistir, vamos corrigi-lo o mais rápido possível.	Foi feita uma tentativa de consumir um endpoint que não existe para o tipo de instituição especificado. Por exemplo, não é possível consumir o endpoint /invoices para um link do tipo banco. Somente o terminal /invoices pode ser consumido com links do tipo fiscal. Descrição dos terminais e a que tipo de link eles correspondem.	Execute apenas POSTs para endpoints que correspondam ao tipo de link especificado. Descrição dos terminais e a que tipo de link eles correspondem.
400	validation_error	"Bad request"	Não	N/A	N/A	Há um erro de sintaxe na chamada. A operação solicitada não foi executada.	1. Garante que o terminal seja compatível com o tipo de link. 2. Verifique o url, os parâmetros e o corpo da chamada para um caractere incorreto ou ausente.
428	activation_required	"This user doesn't have web access activated yet."	Sim	N/A	N/A	O usuário final não ativou seu banco online com a instituição à qual está tentando se conectar.	Ao receber este código, o widget exibirá um fluxo para habilitar o banco online para a conta inserida pelo usuário final. Durante este fluxo, o CVV e o PIN serão solicitados.
428	token_required	"A MFA token is required by the institution to login"	Sim	Token inválido	O token pode ter expirado, gere um novo e tente novamente.	O usuário final inseriu um token incorreto ou expirado no widget.	O usuário final deve inserir um token válido com o widget no modo de atualização.
408	request_timeout	"The request timed out, you can retry asking for less data by changing your query parameters."	Sim	Sessão expirada	O tempo de resposta foi muito longo e a conexão não pôde ser estabelecida. Tente novamente em alguns minutos.	A Belvo limita o tempo necessário para obter todos os detalhes de uma conta e sair. Um tempo limite ocorre quando há uma grande quantidade de dados e não podem ser recuperados dentro do tempo alocado. Por exemplo, se uma conta tiver mais de 2.000 transações por conta por mês.	Quando o timeout ocorre, a API do Belvo salva seu progresso nesse ponto, portanto, recomendamos fazer a chamada novamente e possivelmente recuperar todos os dados com êxito. Em caso de timeout com vários links ou 3 timeouts com o mesmo link, informe a Belvo com request_id.
401	token_not_valid	N/A	Sim	Sessão expirada	Sua sessão expirou, atualize a página e tente vincular sua conta novamente.	O access_token enviado para abrir o widget expirou. A chamada feita com este token não foi tentada.	O usuário precisa reabrir o widget. * Os tokens de acesso ao widget são válidos por 60 minutos. Para evitar receber esse erro, o usuário final deve concluir o fluxo dentro desse período. Você pode atualizar o access_token enquanto o widget estiver aberto com o refresh_token.

Temos também alguns erros relacionados a login:

HTTP Código	API Código de Erro	Descrição default	Relevante no widget?	Widget código de erro	Widget descrição do erro	Causa	Ação
400	login_error	"A MFA token is required by the institution, but it’s not supported yet by Belvo."	Não	N/A	N/A	Houve uma mudança por parte da instituição e o fluxo exigido não é desenvolvido.	Reportar a Belvo o request_id.
400	login_error	"Impossible to login, something unexpected happened while logging into the institution. Try again later."	Sim	Ocorreu um erro	Parece que ocorreu um erro ao vincular sua conta. Por favor, tente novamente e se o problema persistir, vamos corrigi-lo o mais rápido possível.	A criação de um link aleatoriamente será rejeitada pelo sistema de segurança da instituição. Essa rejeição não está relacionada ao usuário ou suas credenciais, é aleatória.	Sugerimos tentar novamente em intervalos de 15 minutos. * Como essas rejeições são aleatórias, é possível que a partir de duas tentativas para a mesma instituição ao mesmo tempo, uma rejeição e outra de sucesso. Se você receber esse erro após várias tentativas ou receber esse erro com frequência com uma determinada instituição, informe à Belvo o request_id.
400	login_error	"Login not attempted due to invalid credentials"	Não	N/A	N/A	Houve uma tentativa anterior com as mesmas credenciais. As credenciais não foram reenviadas à instituição.	Solicite ao usuário final que confirme suas credenciais com o widget no update mode. Ele solicita que o usuário final insira as credenciais no site oficial do banco online da instituição. Caso o usuário consiga fazer login com sucesso em seu banco online, mas receba invalid_credentials com o widget Belvo, informe a Belvo o request_id.
400	login_error	"Missing credentials to login to the institution"	Sim	Faltam informações	Por favor, insira todas as informações para poder acessar sua conta, parece que algumas das informações necessárias estavam faltando	Alterei os requisitos da instituição para as credenciais deste usuário, as credenciais inseridas anteriormente não são mais válidas.	Solicite ao usuário final que confirme suas credenciais com o widget no update mode. Ele solicita que o usuário final insira as credenciais no site oficial do banco online da instituição. Caso o usuário consiga fazer login com sucesso em seu banco online, mas receba invalid_credentials com o widget Belvo, informe a Belvo o request_id.
400	login_error	"The user account access was forbidden by the institution"	Sim	Erro da instituição	Parece que a instituição não está autorizando o acesso a esta conta. Entre em contato com sua entidade para que eles possam ajudá-lo.	A criação de um link aleatoriamente será rejeitada pelo sistema de segurança da instituição. Essa rejeição não está relacionada ao usuário ou suas credenciais, é aleatória.	Sugerimos tentar novamente em intervalos de 15 minutos. * Como essas rejeições são aleatórias, é possível que a partir de duas tentativas para a mesma instituição ao mesmo tempo, uma rejeição e outra de sucesso. Se você receber esse erro após várias tentativas ou receber esse erro com frequência com uma determinada instituição, informe à Belvo o request_id.
400	login_error	"The user account access was forbidden by the institution"	Sim	Acesso não permitido	A instituição com a qual você está tentando se conectar não está permitindo ou acessando esta conta.	A criação de um link aleatoriamente será rejeitada pelo sistema de segurança da instituição. Essa rejeição não está relacionada ao usuário ou suas credenciais, é aleatória.	Sugerimos tentar novamente em intervalos de 15 minutos. * Como essas rejeições são aleatórias, é possível que a partir de duas tentativas para a mesma instituição ao mesmo tempo, uma rejeição e outra de sucesso. Se você receber esse erro após várias tentativas ou receber esse erro com frequência com uma determinada instituição, informe à Belvo o request_id.
400	login_error	"The user account is locked, user needs to contact the institution to unlock it"	Sim	Erro da instituição	Parece que a instituição não está autorizando o acesso a esta conta. Por favor, contacte a sua entidade para que o possam ajudar.	A instituição retornou um erro de login indicando que a conta está bloqueada.	O usuário final deve entrar em contato com seu banco para desbloquear sua conta. O processo de desbloqueio varia de acordo com a instituição. O site do banco deve indicar os passos a seguir. Depois de desbloquear sua conta, o usuário final poderá criar um link com a Belvo ou consumir seus dados financeiros novamente. * Os aplicativos de banco online ou banco móvel são bloqueados quando: 1. Há várias tentativas de login com credenciais incorretas 2. Observe atividades suspeitas como muitas solicitações em um segundo * Para evitar que uma conta seja bloqueada, sugerimos: 1. Ouça os erros da Belvo e evite repetir uma solicitação que retornou invalid_credentials 2. Faça conjuntos de POSTs para um link no máximo a cada 6 horas e não com mais frequência

Artigos relacionados