Problema
{
"message": "Acesso a rota não permitido filter failed"
}Este erro ocorre quando a API do Itaú impede o acesso a uma rota específica devido a configurações inadequadas nas credenciais ou nos parâmetros da requisição.
Solução
1. Scopes Inadequados
Os scopesdefinidos nas credenciais podem não estar corretos ou completos.
- Scope para Boleto:
cash_management/instrucaocobranca.write cash_management/emissaocobranca.write boletoscash-boletos-consulta_titulo boletoscash-notificacoesboletos-webhook.read boletoscash-notificacoesboletos-webhook.write
- Scope para Bolecode:
payments/pix.read paymentsprovider/receipts/qrcode webhook.write cash-management/receipts/qrcode.post cash-management/receipts/qrcode.read cash-management/receipts/refund.read cobv.read cash-management/receipts/qrcode payments/pix.post payloadlocation.read cobv.write cob.write cash-management/sispag/payment payments/webhook.write cash-management/receipts/pix.read paymentsprovider/pix.read lotecobv.write paymentsprovider/pix payments/pix pix.write payloadlocation.write lotecobv.read cob.read webhook.read cash-management/sispag/payment.read pix.read cash-management/receipts/refund cash-management/pix.refund payments/webhook.read
Solução:Verifique se os scopesatribuídos às suas credenciais correspondem aos necessários para a operação desejada. Caso contrário, entre em contato com o suporte do Itaú para solicitar a correção ou a emissão de novas credenciais com os scopesapropriados.
2. Problemas com o Certificado Digital
O certificado digital utilizado pode estar ausente ou instalado incorretamente.
Solução:Reinstale o certificado digital conforme as instruções fornecidas pelo Itaú. Certifique-se de que o certificado está corretamente instalado e reconhecido pelo sistema.
3. Credenciais Incorretas
As credenciais (Client ID e Client Secret) podem estar incorretas ou desatualizadas.
Solução:Verifique se as credenciais inseridas estão corretas e correspondem às fornecidas pelo Itaú. Em caso de dúvida, valide-as novamente com o banco.
4. Configuração do Ambiente
O ambiente configurado (produção ou homologação) pode não corresponder ao das credenciais utilizadas.
Solução:Certifique-se de que o ambiente configurado no sistema corresponde ao ambiente para o qual as credenciais foram emitidas. Por exemplo, se estiver utilizando credenciais de produção, o ambiente deve estar configurado como produção.