Hap

Itaú: gerar o Certificado Dinâmico pelo assistente

O Itaú não aceita o certificado A1 da empresa: exige um emitido pela autoridade dele próprio, o Certificado Dinâmico. O Hap tem um assistente que gera a chave e o pedido, envia ao Itaú e instala o certificado, sem linha de comando. Este artigo percorre os quatro passos e o que fazer quando o envio automático falha.

FinanceiroAtualizado em 17/09/2026

Quando usar

Use ao configurar a conta Itaú pela primeira vez, quando o certificado vencer - ele vale 365 dias - ou quando a emissão falhar dizendo que o certificado não foi emitido pelo STS.

Antes de começar

  • Client ID e o token temporário enviados pelo Itaú por e-mail. O token vale 7 dias corridos.
  • Conta Itaú cadastrada no Hap, com o convênio já criado.

Por que o Itaú é diferente

Todos os outros bancos integrados aceitam o certificado A1 da empresa, o mesmo usado na nota fiscal. O Itaú não. Ele exige um certificado emitido pela autoridade certificadora do próprio banco, chamado Certificado Dinâmico. Se você tentar usar o A1, a conexão é recusada com uma mensagem dizendo que o certificado não foi emitido pelo STS - e não há como contornar.

Gerar esse certificado à mão exigiria comandos de linha e navegação pelo portal do Itaú. O Hap tem um assistente que faz isso por você, em quatro passos, dentro do convênio da conta Itaú.

Antes de abrir o assistente

Tenha em mãos o Client ID e o token temporário que o Itaú envia por e-mail depois da contratação. O token vale 7 dias corridos - se passar disso, é preciso pedir outro ao responsável pela API no Itaú.

Os quatro passos

  1. 1

    Passo 1 - informar os dados. Client ID, token temporário e os dados da conta. É o que identifica o pedido no Itaú.

  2. 2

    Passo 2 - gerar a chave e o pedido. O assistente cria a chave privada e o arquivo de pedido de certificado. A chave fica guardada no Hap e nunca é enviada ao banco.

  3. 3

    Passo 3 - enviar ao Itaú. O assistente envia o pedido e recebe de volta o certificado assinado, junto com o Client Secret.

  4. 4

    Passo 4 - validar e instalar. O assistente confere que o certificado combina com a chave gerada e o instala no convênio.

Problemas comuns

  • A emissão falha dizendo que a cadeia certificadora é inválida e que o certificado não foi emitido pelo STS: é o A1 da empresa sendo usado no lugar do Certificado Dinâmico. Refaça pelo assistente.
  • O token temporário expirou: ele vale 7 dias corridos a partir do envio pelo Itaú. Peça outro ao responsável pela API.
  • O envio automático ao Itaú foi recusado: o assistente permite subir manualmente o certificado baixado do portal. A chave privada gerada no passo 2 continua guardada - você não perde o trabalho.
  • O certificado venceu: ele vale 365 dias. Refaça o assistente com um token novo.
  • Perdi a chave privada: não há como recuperá-la, e sem ela o certificado não serve. Gere um novo pelo assistente.

Artigos relacionados

FinanceiroAnálise FinanceiraPainel do financeiro do período - a receber, a pagar, resultado, inadimplência do mês e acumulada, caixa dia a dia, clientes, contas a pagar, centros de resultado e fechamento - com os pontos de atenção já apontados.FinanceiroCheques: cadastro, compensação e saldoComo funciona a tela Financeiro > Cheques (próprio x terceiros), por que cadastrar não mexe no saldo e só Compensar mexe, o reflexo em Caixas e Contas, o saldo fracionado e o erro clássico de compensar um cheque já repassado.FinanceiroComissão a partir de uma data - vendas de antes não geram comissãoEm Configurações > Financeiro, o administrador informa a data a partir da qual a comissão conta. Vendas e OS emitidas antes dela não geram comissão no Hap, mesmo quando o título é recebido depois. Serve para a loja que começou a usar o Hap no meio do mês e já pagou a comissão de antes pelo sistema anterior.FinanceiroConferência e reconciliação de caixaComo ativar a Conferência de Caixa, liberar as permissões e reconciliar o fechamento comparando o total do sistema com o das maquininhas - corrigindo forma de pagamento ou lançando ajustes de sobra e falta sem estornar vendas.