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

e-Bank sslcertificadocertificado digitalmtlsclient authenticationcódigo 99securitytokenexception401unauthorizede-bank

SSL with client authentication is required

Este erro indica que o banco exige autenticação SSL com certificado do cliente ( mTLS ) e não conseguiu validar o certificado utilizado durante a comunicação. Normalmente, o problema está relacionado ao certifi...

Atualizado em 29 de set. de 2026, 14:23

Problema

Este erro indica que o banco exige autenticação SSL com certificado do cliente (mTLS) e não conseguiu validar o certificado utilizado durante a comunicação.

Normalmente, o problema está relacionado ao certificado digital informado na configuração do cliente.

Solução

Verifique o certificado digital informado na configuração utilizada para realizar a operação.

Confirme principalmente se:

  • O certificado configurado é o certificado correto para a conta/convênio que está sendo acessado;
  • O certificado está dentro do prazo de validade;
  • O certificado contém a chave privada;
  • A senha do certificado, quando aplicável, está correta;
  • O certificado utilizado é o mesmo que foi cadastrado ou autorizado junto ao banco;
  • O ambiente configurado (produção ou homologação) corresponde ao ambiente no qual o certificado foi autorizado.

Importante: este erro ocorre durante a autenticação com o banco e não está relacionado aos dados enviados na operação de registro, consulta ou baixa. Antes de alterar os dados da requisição, valide o certificado configurado para o cliente.

Caso o certificado tenha sido recentemente renovado ou substituído, verifique também se o novo certificado precisa ser cadastrado ou autorizado junto ao banco.