# Banco Inter Empresas Tutorial

To connect your **Banco Inter Empresas** account to **Pluggy**, you first need to create a **data-sharing authorization** inside Inter's own Internet Banking.

This authorization is done by creating an **API integration** within your account.

After creating this integration, Banco Inter will provide:

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

These four pieces of information will be used to connect your **Inter Empresas** account with **Pluggy**.

**Information required for the connection:**

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

(see figure):

![Pluggy widget connection form for Inter Empresas](/docs/images/readme/59fae3438799b13cd91c5fd0b51b30b59218a5cebfb86ade7aba60f781d3a0d5-image7.png)

## How to create the integration in Banco Inter

To create your application and obtain your access credentials (Client ID, Client Secret, key file, and certificate), follow the instructions below:

### Step 1 — Access Internet Banking

- Log in to your Banco Inter Empresas account [here](https://contadigital.bancointer.com.br/?t=pj);
- After authenticating via QR code, you will be taken to your account's home page.

### Step 2 — Open the integrations menu

In the top menu of the home page:

1. Click **Integrar** (Integrate)
2. Select **Integrações** (Integrations)
3. Click **Nova integração** (New integration)

![Integrations menu in Inter Internet Banking](/docs/images/readme/874e4e39ca72809417143f27a4d7319ee619fc4ef6f8ccc2854833bb326ac0e4-image9.png)

### Step 3 — Create the new integration

On the **Nova integração** (New integration) screen, fill in the fields:

- **Nome da integração** (Integration name)
  Enter a name of your choice
- **Descrição** (Description)
  Enter a description of your choice

Then click: **Próximo** (Next)

![New integration form](/docs/images/readme/929add2def62606a33886434707e3d05640de11cab7fda62355efc46e588a4d5-image14.png)

### Step 4 — Define the integration scope

On the **Nova Integração via API** (New API Integration) page, you will need to select the integration's permissions.

Expand the menu:

**API Banking**

Select the option:

- **Consultar extrato e saldo** (Query statement and balance)

Then click: **Criar Integração** (Create Integration)

![Selecting the API Banking scope](/docs/images/readme/db49849f423a2bf2682c823c6b042c000d7531f3f5bc5c2f2340af855f819fa1-image1.png)

**Optional functionality**

If you also want to issue boletos through the API, select:

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

  ![Optional billing API scope](/docs/images/readme/f92aa20bf6730de2ed641738c7801ce4893dda00f5976d30e9f41b5c59c1f98b-image16.png)

### Step 5 — Additional authentication

An **additional authentication** screen will be displayed.

Banco Inter will send a **6-digit code via SMS** to the registered mobile phone.

Enter the received code to continue.

![SMS verification screen](/docs/images/readme/637fc8ba2b854a5f90c96a8de400f7a907a30538a13f8f3460c7eba0fbb59c8b-image8.png)

### Step 6 — Fill in the integration form

After authenticating, the following message will appear:

- **Integração criada com sucesso** (Integration created successfully)

Click: **Preencher formulário** (Fill in the form)

![Integration created successfully](/docs/images/readme/9ff7a8cac435542f0e12660edc80c1ddce430115d41baba809a4edd5a587fc40-image12.png)

Banco Inter uses this form to better understand how the integration will be used.

You will need to fill in information about:

- **Your customers' activity**

  ![Customer activity form](/docs/images/readme/c650f2f7e958bef3d128a6742de1734467a46565dd4de1cc31ff88019a123dce-image3.png)
- **Company information**

  ![Company information form](/docs/images/readme/05653c4def3725429e42fe1a6c87801095e780bc4640ddde9335dc79a4f27d71-image11.png)
- **Company field of operation**

  ![Company field of operation form](/docs/images/readme/7c4eba4020a85b9dfcabaf8d56770a07787c246571a47a1a67fa853ebba7e2b6-image10.png)

Fill in the data **according to your company's real information**.

When you are done, submit the form.

### Step 7 — Wait for Banco Inter's review

After the form is submitted, Banco Inter may perform a **validation of the information**.

In that case, a message will be displayed informing you that:

- **Seus dados estão em análise** (Your data is under review)

Click: **Acessar minhas integrações** (Access my integrations)

![Data under review screen](/docs/images/readme/08012e8fbd5324fb2cc311377c616631fd2af6d233c0349bd2cf63968916ec96-image13.png)

### Step 8 — Download the key and certificate

On the **Minhas integrações** (My integrations) screen:

1. Locate the integration you created (by the **name and description** defined earlier).
2. Check the integration's **status**.

Possible statuses:

- **Em validação** (Under validation) → wait for approval
- **Novo** (New) → the credentials can now be downloaded

![My integrations list](/docs/images/readme/11162d9c9d3ad2b8fa87dc3b974e90d0bef5389359b7532595a1131cfaab2aea-image6.png)

If the status is **Novo** (New):

1. Click the **three dots**
2. Select the option:
   **Download chave e certificado** (Download key and certificate)

![Download key and certificate option](/docs/images/readme/75be3ee6da650d13b76266615626218ba16e84bd44865d285c74e64857d67d11-image15.png)

### Step 9 — Confirm the credentials download

A warning will be displayed informing you that:

- ⚠️ **The key and certificate can only be downloaded once.**

After reading the instructions, click:

**Sim, baixar** (Yes, download)

![Download confirmation dialog](/docs/images/readme/d05697b7d0d57e3f827006eb5ee10112b4f5f552b25c64a0a795bf8d4ac92f07-image5.png)

### Step 10 — Save the credentials

After confirming the download:

1. A **screen** will display:
   1. **Client ID**
   2. **Client Secret**

⚠️ **Save this information immediately**, as it **will not be shown again**.

![Client ID and Client Secret screen](/docs/images/readme/31b9522d24d8454640da12bfcb55871461af1a6bb499550fedd87ea59a452413-image2.png)

### Step 11 — Extract the key and certificate files

A **ZIP** file containing the integration files will also be downloaded.

Extract the **ZIP** file.

After extraction you will have two files:

- `Inter_API_Chave.key` → API key
- `Inter_API_Certificado.crt` → API certificate

**These files will be used in the connection with Pluggy.**

The integration will go through a validation process; after a few minutes its status will be updated to **Ativo** (Active) and it will be ready to use.

### Final step — Connect in Pluggy

Now open the **Pluggy widget** and enter the integration data.

Fill in the fields:

- **Client ID**
  Paste the generated Client ID
- **Client Secret**
  Paste the generated Client Secret
- **Key (.key)**
  Upload the file:
  `Inter_API_Chave.key`
- **Certificate (.crt)**
  Upload the file:
  `Inter_API_Certificado.crt`

Then click the **Conectar** (Connect) button.

![Pluggy widget connection form](/docs/images/readme/70f06346b043a55dfe5d8bc6a8da00614e3dcd96293ad4fad1ce06907748249f-image4.png)

Your **Banco Inter Empresas** account will be connected to **Pluggy**.

**Done! The integration has been completed successfully.**