# Tutorial do Banco Inter Empresas

Para conectar sua conta do **Banco Inter Empresas** ao **Pluggy**, você primeiro precisa criar uma **autorização de compartilhamento de dados** dentro do próprio Internet Banking do Inter.

Essa autorização é feita criando uma **integração de API** dentro da sua conta.

Após criar essa integração, o Banco Inter fornecerá:

- **Client ID**
- **Client Secret**
- Arquivo **Key** ("Chave Key")
- **Certificate** ("Certificado")

Essas quatro informações serão usadas para conectar sua conta do **Inter Empresas** ao **Pluggy**.

**Informações necessárias para a conexão:**

- Client ID
- Client Secret
- Arquivo **Key (.key)**
- Arquivo **Certificate (.crt)**

(veja a figura):

![Formulário de conexão do widget Pluggy para Inter Empresas](/docs/images/readme/59fae3438799b13cd91c5fd0b51b30b59218a5cebfb86ade7aba60f781d3a0d5-image7.png)

## Como criar a integração no Banco Inter

Para criar seu aplicativo e obter suas credenciais de acesso (Client ID, Client Secret, arquivo key e certificado), siga as instruções abaixo:

### Passo 1 — Acesse o Internet Banking

- Faça login na sua conta do Banco Inter Empresas [aqui](https://contadigital.bancointer.com.br/?t=pj);
- Após autenticar via QR code, você será levado à página inicial da sua conta.

### Passo 2 — Abra o menu de integrações

No menu superior da página inicial:

1. Clique em **Integrar**
2. Selecione **Integrações**
3. Clique em **Nova integração**

![Menu de integrações no Internet Banking do Inter](/docs/images/readme/874e4e39ca72809417143f27a4d7319ee619fc4ef6f8ccc2854833bb326ac0e4-image9.png)

### Passo 3 — Crie a nova integração

Na tela de **Nova integração**, preencha os campos:

- **Nome da integração**
  Insira um nome de sua escolha
- **Descrição**
  Insira uma descrição de sua escolha

Em seguida, clique em: **Próximo**

![Formulário de nova integração](/docs/images/readme/929add2def62606a33886434707e3d05640de11cab7fda62355efc46e588a4d5-image14.png)

### Passo 4 — Defina o escopo da integração

Na página de **Nova Integração via API**, você precisará selecionar as permissões da integração.

Expanda o menu:

**API Banking**

Selecione a opção:

- **Consultar extrato e saldo**

Em seguida, clique em: **Criar Integração**

![Selecionando o escopo da API Banking](/docs/images/readme/db49849f423a2bf2682c823c6b042c000d7531f3f5bc5c2f2340af855f819fa1-image1.png)

**Funcionalidade opcional**

Se você também quiser emitir boletos através da API, selecione:

- **API Cobrança (Boleto + Pix)**

  ![Escopo da API de cobrança opcional](/docs/images/readme/f92aa20bf6730de2ed641738c7801ce4893dda00f5976d30e9f41b5c59c1f98b-image16.png)

### Passo 5 — Autenticação adicional

Uma tela de **autenticação adicional** será exibida.

O Banco Inter enviará um **código de 6 dígitos via SMS** para o celular cadastrado.

Digite o código recebido para continuar.

![Tela de verificação por SMS](/docs/images/readme/637fc8ba2b854a5f90c96a8de400f7a907a30538a13f8f3460c7eba0fbb59c8b-image8.png)

### Passo 6 — Preencha o formulário de integração

Após autenticar, a seguinte mensagem aparecerá:

- **Integração criada com sucesso**

Clique em: **Preencher formulário**

![Integração criada com sucesso](/docs/images/readme/9ff7a8cac435542f0e12660edc80c1ddce430115d41baba809a4edd5a587fc40-image12.png)

O Banco Inter usa este formulário para entender melhor como a integração será utilizada.

Você precisará preencher informações sobre:

- **A atividade dos seus clientes**

  ![Formulário de atividade do cliente](/docs/images/readme/c650f2f7e958bef3d128a6742de1734467a46565dd4de1cc31ff88019a123dce-image3.png)
- **Informações da empresa**

  ![Formulário de informações da empresa](/docs/images/readme/05653c4def3725429e42fe1a6c87801095e780bc4640ddde9335dc79a4f27d71-image11.png)
- **Campo de atuação da empresa**

  ![Formulário de campo de atuação da empresa](/docs/images/readme/7c4eba4020a85b9dfcabaf8d56770a07787c246571a47a1a67fa853ebba7e2b6-image10.png)

Preencha os dados **de acordo com as informações reais da sua empresa**.

Quando terminar, envie o formulário.

### Passo 7 — Aguarde a análise do Banco Inter

Após o envio do formulário, o Banco Inter pode realizar uma **validação das informações**.

Nesse caso, uma mensagem será exibida informando que:

- **Seus dados estão em análise**

Clique em: **Acessar minhas integrações**

![Tela de dados em análise](/docs/images/readme/08012e8fbd5324fb2cc311377c616631fd2af6d233c0349bd2cf63968916ec96-image13.png)

### Passo 8 — Baixe a chave e o certificado

Na tela de **Minhas integrações**:

1. Localize a integração que você criou (pelo **nome e descrição** definidos anteriormente).
2. Verifique o **status** da integração.

Possíveis status:

- **Em validação** → aguarde a aprovação
- **Novo** → as credenciais podem ser baixadas agora

![Minha lista de integrações](/docs/images/readme/11162d9c9d3ad2b8fa87dc3b974e90d0bef5389359b7532595a1131cfaab2aea-image6.png)

Se o status for **Novo**:

1. Clique nos **três pontos**
2. Selecione a opção:
   **Download chave e certificado**

![Opção de download da chave e certificado](/docs/images/readme/75be3ee6da650d13b76266615626218ba16e84bd44865d285c74e64857d67d11-image15.png)

### Passo 9 — Confirme o download das credenciais

Um aviso será exibido informando que:

- ⚠️ **A chave e o certificado só podem ser baixados uma vez.**

Após ler as instruções, clique:

**Sim, baixar**

![Diálogo de confirmação de download](/docs/images/readme/d05697b7d0d57e3f827006eb5ee10112b4f5f552b25c64a0a795bf8d4ac92f07-image5.png)

### Passo 10 — Salve as credenciais

Após confirmar o download:

1. Uma **tela** será exibida:
   1. **Client ID**
   2. **Client Secret**

⚠️ **Salve essas informações imediatamente**, pois **não serão mostradas novamente**.

![Tela de Client ID e Client Secret](/docs/images/readme/31b9522d24d8454640da12bfcb55871461af1a6bb499550fedd87ea59a452413-image2.png)

### Passo 11 — Extraia os arquivos de chave e certificado

Um arquivo **ZIP** contendo os arquivos da integração também será baixado.

Extraia o arquivo **ZIP**.

Após a extração, você terá dois arquivos:

- `Inter_API_Chave.key` → chave da API
- `Inter_API_Certificado.crt` → certificado da API

**Esses arquivos serão usados na conexão com o Pluggy.**

A integração passará por um processo de validação; após alguns minutos, seu status será atualizado para **Ativo** e estará pronto para uso.

### Passo final — Conectar no Pluggy

Agora abra o **Pluggy widget** e insira os dados da integração.

Preencha os campos:

- **Client ID**
  Cole o Client ID gerado
- **Client Secret**
  Cole o Client Secret gerado
- **Key (.key)**
  Faça o upload do arquivo:
  `Inter_API_Chave.key`
- **Certificate (.crt)**
  Faça o upload do arquivo:
  `Inter_API_Certificado.crt`

Em seguida, clique no botão **Conectar**.

![Formulário de conexão do widget Pluggy](/docs/images/readme/70f06346b043a55dfe5d8bc6a8da00614e3dcd96293ad4fad1ce06907748249f-image4.png)

Sua conta do **Banco Inter Empresas** estará conectada ao **Pluggy**.

**Pronto! A integração foi concluída com sucesso.**