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

e-Bank e-bankconfigurationIdConfigurationIdNotFoundExceptionconfiguracaoconta-correnteautenticacao

ConfigurationIdNotFoundException - Configuração de conta corrente não encontrada

O erro ConfigurationIdNotFoundException ocorre quando o e-Bank não consegue localizar uma configuração de conta corrente correspondente ao configurationId informado na requisição. O configurationId...

Atualizado em 5 de nov. de 2026, 19:42

Problema

O erro ConfigurationIdNotFoundException ocorre quando o e-Bank não consegue localizar uma configuração de conta corrente correspondente ao configurationId informado na requisição.

O configurationId é um identificador criado durante o processo de configuração da conta corrente no e-Bank e está vinculado ao cliente responsável pela integração.

Esse erro pode ocorrer nas seguintes situações:

  • O configurationId informado está incorreto ou não existe.
  • O identificador pertence a outro cliente ou não está associado ao par de chaves utilizado na autenticação.
  • A configuração da conta corrente ainda não foi cadastrada no e-Bank.

Exemplo de mensagem retornada:

O configurationId 'xxxxxx' não existe para este cliente ou a configuração está incompleta. Confira o identificador e os dados nas configurações do e-Bank.

Solução

Para resolver o problema, siga as verificações abaixo:

  1. Confira o configurationId: verifique se o identificador enviado na requisição está correto e corresponde à configuração da conta corrente desejada.
  2. Valide o par de chaves: confirme se o configurationId pertence ao mesmo cliente associado ao par de chaves utilizado na autenticação da API.
  3. Verifique a existência da configuração: certifique-se de que a conta corrente está devidamente cadastrada e configurada no e-Bank.

Se a configuração ainda não existir, você poderá cadastrar uma nova conta corrente diretamente pelo Portal Unimake.

O acesso ao portal é exclusivo para clientes que possuem contrato assinado com a Unimake. Após a contratação e a liberação do acesso, será possível realizar o cadastro da conta corrente e obter o configurationId correspondente.

Caso não tenha acesso ao portal ou encontre dificuldades para realizar a configuração, entre em contato com o suporte da Unimake para solicitar auxílio no cadastro da conta corrente.

Importante: o configurationId está vinculado ao cliente para o qual a configuração foi criada. Portanto, utilize sempre o identificador correspondente ao mesmo par de chaves empregado na autenticação da API.