Problema
Este erro ocorre quando há falha de autorização ou proibição ao tentar consumir um endpoint bancário.
O retorno normalmente vem acompanhado do status 401 (Unauthorized) ou 403 (Forbidden) e indica que a aplicação não possui permissão válida para acessar o serviço bancário.
Embora a mensagem mencione um banco específico, este erro é genérico e pode ocorrer com qualquer instituição financeira integrada.
Na maioria dos casos, o problema está relacionado à configuração da aplicação no e-Bank ou às permissões liberadas junto ao banco.
Solução
Como resolver
Verifique atentamente as configurações da aplicação no e-Bank.
As causas mais comuns são:
- Certificado digital vencido ou inválido
- Certificado não vinculado corretamente ao convênio
- Permissões de API não liberadas pelo banco
- Credenciais incorretas configuradas no e-Bank. Verifique o clientid e o secret informados pelo banco.
- Ambiente incorreto (homologação x produção)
- Código de beneficiário incorreto
No painel do e-Bank, confirme se:
- O certificado está válido e atualizado
- O convênio está corretamente configurado
- As credenciais correspondem ao ambiente selecionado
O banco Itaú [341] utiliza-se de certificado próprio para autenticação vinculado ao clientid e secret fornecidos pelo banco.
Em caso de dúvida, entre em contato com o suporte:
📲 Falar com o suporte no WhatsApp
Após revisar as configurações e permissões, tente novamente a operação.