Integração Teorema Bank com o Itau

---
title: Integração Teorema Bank com o Itau
slug: integracao-teorema-bank-com
sistema:
  - Teorema Pay
categoria: user_manual
tipo: how-to
autor: Pellison Leutner Cesar
setor: Qualidade
modulo: TeoremaPay
revisao: Andreia Burko
aprovado_em: 07/2024
versao_pipeline: 2.5.2
publico: "equipe técnica / implantação"
keywords:
  - TeoremaPay
  - Itaú
  - certificado digital
  - OpenSSL
  - CSR
  - PFX
  - CNAB
  - boleto
  - API
  - Bolecode
  - remessa bancária
ultima_revisao: "2026-06-12"
---

## Visão Geral

Descreve o processo completo de integração entre o Teorema Pay e o banco Itaú via API, abrangendo a geração dos certificados digitais (CSR, KEY, CRT e PFX) com OpenSSL, a solicitação do certificado ao banco via Postman, e a configuração da conta e convênio no Gestão Administrativo e no Teorema Pay para envio de remessas bancárias por API.

## Pré-requisitos

- OpenSSL versão 1.1.1 instalado (download em <https://www.openssl.org/source/>)
- Postman instalado (download em <https://www.postman.com/downloads/>)
- Token temporário fornecido pelo Itaú para solicitação de certificado
- Conta já homologada no CNAB 400 (recomendado — facilita a validação efetiva do boleto na API)
- CNPJ e Token do Teorema Pay liberados após acordo comercial com a Teorema Sistemas

## Gerar o CSR e a KEY

Verifique a versão do OpenSSL instalada com o comando:

```
openssl version
```

Execute o seguinte comando no Prompt de Comando como Administrador para gerar o arquivo CSR e a chave privada KEY:

```
openssl req -new -out nome_arquivo.csr -nodes -sha512 -newkey rsa:2048 -keyout nome_arquivo.key
```

Após executar o comando, preencha os campos solicitados conforme o modelo abaixo.

![Terminal OpenSSL exibindo os campos do Distinguished Name (DN) a preencher: Country Name (BR), State or Province Name (sigla da UF, ex.: PR), Locality Name (nome da cidade, ex.: GUARAPUAVA), Organization Name (nome da empresa, ex.: TEOREMA SISTEMAS), Organizational Unit Name (número do CNPJ, ex.: 01.234.567/0001-00), Common Name (Client ID fornecido pelo Itaú, ex.: 123abc34-567d-8b9e-010f-f000a11b123c), Email Address (e-mail cadastrado no banco). Os campos challenge password e optional company name devem ficar em branco.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-01.png)

> **Nota:** Os campos **challenge password** e **optional company name** devem ser deixados em branco (pressione Enter sem digitar nada).

## Verificar o Subject no CSR

Execute o comando abaixo para conferir os dados gravados no CSR:

```
openssl req -in nome_arquivo.csr -noout -text
```

Verifique a linha **Subject** na saída. Os dados devem estar de acordo com o modelo informado no passo anterior.

![Terminal OpenSSL exibindo Certificate Request com Subject: C=BR, ST=PR, L=GUARAPUAVA, O=TEOREMA SISTEMAS, OU=01.234.567/0001-00, CN=123abc34-567d-8b9e-010f-f000a11b123c; campos Public Key Algorithm: rsaEncryption, RSA Public-Key (2048 bit) e Signature Algorithm: sha512WithRSAEncryption.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-02.png)

## Enviar o CSR para o Itaú via Postman

No Postman, crie uma nova solicitação:

```
POST https://sts.itau.com.br/seguranca/v1/certificado/solicitacao
```

Na aba **Authorization**, selecione o Auth Type **Bearer Token** e cole no campo **Token** o token temporário recebido do Itaú.

![Postman com requisição POST para https://sts.itau.com.br/seguranca/v1/certificado/solicitacao; aba Authorization selecionada com Auth Type Bearer Token e campo Token preenchido com valor truncado.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-03.png)

Na aba **Headers**, confirme que o header **Content-Type** está definido como **text/plain**. Se não estiver, altere manualmente.

![Postman aba Headers da mesma requisição POST; linha Content-Type destacada com valor text/plain; demais headers listados: Authorization (ofuscado), Cookie, Cache-Control (no-cache), Postman-Token, Content-Length, Host, User-Agent (PostmanRuntime/7.39.0), Accept, Accept-Encoding, Connection.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-04.png)

Abra o arquivo CSR no Bloco de Notas, copie todo o conteúdo e, na aba **Body** do Postman, selecione a opção **raw** e cole o conteúdo copiado.

![Postman aba Body com opção raw selecionada; corpo da requisição exibe o bloco -----BEGIN CERTIFICATE REQUEST----- / MIICyTCCAbECAQ.... / -----END CERTIFICATE REQUEST-----.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-05.png)

Clique em **Send**. Se tudo estiver configurado corretamente, o banco retornará a Secret e o conteúdo do certificado CRT, que será utilizado nos envios via API.

![Postman aba Body mostrando a resposta do servidor com o bloco -----BEGIN CERTIFICATE REQUEST----- no corpo enviado e, na seção Raw da resposta (status 403 Forbidden no exemplo de modelo), os campos secret: 1f09-..., -----BEGIN CERTIFICATE-----, MIIDp......, -----END CERTIFICATE-----.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-06.png)

## Salvar a Secret Key e o Certificado Digital

Salve a Secret Key em local seguro. Copie o restante do conteúdo retornado (bloco do certificado), abra o Bloco de Notas, cole e salve com a extensão `.crt` (ex.: `nome_arquivo.crt`). Mantenha o arquivo `nome_arquivo.key` gerado no primeiro passo na mesma pasta.

![Bloco de Notas exibindo o conteúdo do certificado CRT: -----BEGIN CERTIFICATE----- / MIIDp...... / -----END CERTIFICATE-----.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-07.png)

## Gerar o Arquivo PFX (A1)

Com os arquivos `.crt` e `.key` na mesma pasta, execute o comando abaixo no Prompt de Comando como Administrador:

```
openssl pkcs12 -export -out arquivo_nome.pfx -inkey arquivo_nome.key -in arquivo_nome.crt
```

Após a execução, o sistema solicitará um **password**; preencha-o. O certificado digital com extensão `.pfx` será gerado na mesma pasta.

> ⚠️ **Atenção:** A conta deve estar homologada no CNAB 400 antes de prosseguir. No envio por API o boleto passa por validação efetiva e fica disponível para pagamento imediatamente; qualquer dado incorreto causará erro ou rejeição.

## Configurar a Conta no Gestão Administrativo

No módulo **Gestão Administrativo**, acesse o menu **Cadastros > Contas** e localize a conta do Itaú.

![Gestão Administrativo com menu Cadastros expandido e opção Contas selecionada e destacada.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-08.png)

Na ficha da conta, preencha os seguintes campos obrigatórios e salve:

1. Agência — incluir o dígito
2. Conta Corrente
3. Convênio
4. Layout — alterar para **Teorema Bank**
5. Código e Dígito Cedente
6. Nosso Número — incluir o último número utilizado
7. Carteira de Cobrança

![Cadastro de Contas no Gestão Administrativo exibindo a conta 085 (Banco Itaú); campos numerados: (1) Agência com Dígito, (2) Número Conta/Dígito, (3) campo Lay-Out Arquivo Remessa com valor destacado, (4) Espécie da Cobrança, (5) Código Cedente e Dígito Código Cedente, (6) Nosso Número com valor 10001674, (7) Carteira de Cobrança.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-09.png)

## Acessar o Teorema Pay

Abra o Teorema Pay no navegador e efetue login com o CNPJ e o Token do cliente.

> **Nota:** CNPJ e Token são liberados após acordo comercial com a Teorema Sistemas.

![Tela de login do Teorema Pay com campos (1) CNPJ e (2) Token e botão Entrar.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-10.png)

## Configurar Contas e Convênios no Teorema Pay

No Teorema Pay, acesse o menu **Contas / Convênios** no painel lateral.

![Teorema Pay — Área do Cedente com menu lateral destacando o item Contas / Convênios; painel principal exibe a seção Meus Dados com campos CNPJ, Razão Social, Nome Fantasia, E-mail, Telefone, Endereço, Bairro, CEP, Estado, Cidade e Token (todos ofuscados).](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-11.png)

Clique em **+ Adicionar** para incluir uma nova conta.

![Teorema Pay — tela Contas com botão + Adicionar destacado; tabela vazia com colunas Código Banco, Tipo, Agência e Conta.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-12.png)

Preencha os campos obrigatórios e clique em **Salvar**:

1. Código Banco — **341 ITAU**
2. Tipo — **Corrente**
3. Agência — sem o dígito; campo dígito separado ao lado
4. Número da conta e o dígito ao lado
5. Código Beneficiário — sem dígito
6. Marque **Validação Ativa**

![Teorema Pay — formulário Contas Editar com campos: Código Banco (341 - ITAU), Tipo (Corrente), Agência (campo principal e dígito separado, ofuscados), Número (conta e dígito, ofuscados), Código Beneficiário (ofuscado), checkbox Validação Ativa marcado; botão Salvar.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-13.png)

Após salvar, clique nos três pontos na coluna **Ações** e selecione **Listar convênios**.

![Teorema Pay — tela Contas com a conta 341 CORRENTE listada; menu de ações expandido com opções Editar conta, Excluir conta, Listar convênios (destacado) e Personalizar webhook.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-14.png)

Na tela de convênios, clique em **+ Adicionar**.

![Teorema Pay — tela Convênios com botão + Adicionar destacado; tabela vazia com colunas Número Convênio e Descrição Convênio.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-15.png)

### Aba Dados do Convênio

Preencha os campos da aba **Dados do convênio**:

1. Número do Convênio
2. Descrição
3. Carteira
4. Espécie — **R$**
5. Padrão CNAB — **400**

![Teorema Pay — formulário Convênios Editar com aba Dados do convênio expandida; campos numerados: (1) Número (ofuscado), (2) Descrição (ofuscado), (3) Carteira (ofuscado), (4) Espécie (R$), (5) Padrão CNAB (400); seções Configurações do convênio e Configurações Bolecode recolhidas; botão Salvar.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-16.png)

### Aba Configurações do Convênio

Na aba **Configurações do convênio**, marque primeiro as flags **Reiniciar número da remessa diariamente** e **Registro instantâneo**, depois preencha:

1. Versão Web Service — **V2**
2. API ID — fornecido pelo banco
3. Segredo — API Secret fornecido pelo banco

![Teorema Pay — aba Configurações do convênio com checkboxes Reiniciar número da remessa diariamente (marcado) e Registro instantâneo (marcado) ambos destacados; campos: (1) Versão web service (v2), (2) API - ID (ofuscado), (3) Segredo (ofuscado); nota "Os dados acima serão encriptados para serem salvos no banco de dados".](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-17.png)

Ainda na mesma aba, role a tela para baixo e marque as flags **Alteração via WS**, **Consulta via WS** e **Utilizar Bolecode** (necessário para QR Code nos boletos). Em seguida, inclua o certificado PFX gerado anteriormente.

![Teorema Pay — continuação da aba Configurações do convênio com checkboxes: Alteração via WS (marcado), Consulta via WS (marcado), Utilizar Bolecode (marcado), Consulta Francesa (desmarcado); seção Certificado exibindo dados ofuscados do certificado carregado; links Trocar certificado e Excluir Certificado.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-18.png)

### Aba Configurações Bolecode

Na aba **Configurações Bolecode**, preencha os campos e clique em **Salvar**:

1. Chave PIX
2. Client ID — fornecido pelo banco
3. Client Secret — fornecido pelo banco
4. Certificado

![Teorema Pay — aba Configurações Bolecode com campos: (1) Chave PIX (ofuscado), (2) Client ID (ofuscado), (3) Client Secret (ofuscado); seção Certificado com dados ofuscados e link Trocar certificado; botão Salvar.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-19.png)

## Verificar DLLs e Enviar Remessa

Antes de enviar a remessa, confirme se as DLLs `libeay32.dll` e `ssleay32.dll` estão presentes na pasta `bin` do Teorema. Se não estiverem, atualize-as primeiro.

No módulo **Gestão Administrativo**, acesse **Financeiro > Remessa Bancária de Recebimento API**.

![Gestão Administrativo com menu Financeiro expandido e opção Remessa Bancária de Recebimento API destacada; demais itens do menu listados: Contas a Receber/Pagar, Adiantamentos, Cheques Recebidos, Movimento de Contas, Recibo Avulso, Encontro de Contas, Orçado x Realizado, Movimento de Frente de Caixa, Remessa Bancária de Recebimento, Remessa Bancária de Pagamento, Remessa Bancária de Pagamento API (BB Teste), Remessa Serasa.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-20.png)

Selecione a conta dos boletos, marque o título do primeiro boleto de produção para teste e clique em **Enviar remessa**.

![Tela PIX — Geração, Retorno de Remessa e Impressão de Boletos; barra de ferramentas com botões Retornar, Localizar, Filtro, Editar, Impr. Remessa, Grade, Remessa (expandido com opções Enviar Remessa e Enviar e Imprimir destacadas), Boletos, Retorno e Cancelar Boleto; lista de títulos com uma linha selecionada exibindo Remessa: Não Identificado, Tipo Ocorrência: 01 - Entrada Título, Documento: 0027062024, Parcela: 1, Valor da parcela: 10,00.](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024/integracao-teorema-bank-com/integracao-teorema-bank-com-21.png)

---

## Informações do documento

> Autor: Pellison Leutner Cesar
> Setor: Qualidade
> Módulo: TeoremaPay
> Versão do Sistema:
> Versão do documento: 01
> Revisão: Andreia Burko
> Aprovado em: 07/2024

---

> 📎 **Arquivos originais:** [Manual Integração Teorema Bank com o Itau.docx](https://drive.google.com/uc?export=download&id=1fRbMy9X2ljyTtvQxhcL9G00h9TNf6kRU) · [Manual Integração Teorema Bank com o Itau.pdf](https://drive.google.com/uc?export=download&id=1FIuJRAQDukejL6QTEoNLRt-f033I9wHA)