Oi, DEV! 👋
Crie sua conta para acessar mais recursos do portal.

e-Bank InvalidBankCredentialsExceptionconfiguraçãoconfigurationIdappIdappSecretcredenciaise-Bankconta correnteempresaHTTP 400

Configuração não encontrada ou não vinculada às credenciais da aplicação

O erro InvalidBankCredentialsException ocorre quando a configuração informada na requisição não está disponível para as credenciais utilizadas na autenticação. Isso pode acontecer quando: O identificador...

Atualizado em 19 de out. de 2026, 14:49

Problema

O erro InvalidBankCredentialsException ocorre quando a configuração informada na requisição não está disponível para as credenciais utilizadas na autenticação.

Isso pode acontecer quando:

  • O identificador da configuração (configurationId) foi informado incorretamente.
  • A configuração não existe ou foi removida.
  • A configuração existe, mas não está associada ao appId e secret utilizados na requisição.

Exemplo de mensagem retornada pela API:

A configuração 'XYZ5UT569ROSYPAE' não é válida para este contexto. Verifique se a configuração existe e se está configurada corretamente.

O erro retorna o status HTTP 400 (Bad Request).

Solução

Para corrigir o problema, verifique se a configuração informada pertence à aplicação autenticada.

  1. Acesse o Portal Unimake e confira o identificador da configuração utilizada na requisição.
  2. Verifique se o appId e o secret utilizados possuem acesso à configuração informada.
  3. Confirme se o identificador foi enviado corretamente, sem erros de digitação.

A configuração que deve ser verificada depende da API utilizada:

  • e-Bank: verifique as configurações de conta corrente e se estão vinculadas às credenciais utilizadas.
  • Demais APIs Unimake: verifique as configurações de empresa e se estão vinculadas às credenciais utilizadas.

Importante: uma configuração pode existir no Portal Unimake e ainda assim não estar disponível para determinado appId/appSecret. Certifique-se de que a configuração e as credenciais pertencem ao mesmo contexto de acesso.

Após corrigir o identificador ou o vínculo da configuração, execute novamente a requisição.