# Connecting a PrivatBank account via API

URL: https://bimpsoft.com/en/help/integrations/privatbank-api/
Updated: 2026-11-06

> For Bimp to receive statements from a new PrivatBank account automatically, open the account card in the "Banks/Bank accounts" directory, go to the "Integration" tab, choose the Privatbank integrator, paste the token (Autotoken) from the bank's online account and click "Save".

## When you need the API connection

The API connection is needed so that Bimp receives bank statements from a PrivatBank account automatically. You do it separately for each new account, because the integration is set up in the card of a specific account. For a general overview of bank integration, see [Automatic exchange with banks](https://bimpsoft.com/en/help/integrations/bank-integration/).

## Before you start

1. The account must already exist in **Directories → Banks/Bank accounts** - see [Bank accounts and cash desks](https://bimpsoft.com/en/help/getting-started/bank-accounts-and-cash-desks/).
2. In your PrivatBank online account, create a merchant: in the "All services" section open "Business" and then the "Merchant" item. Ask the bank's support for the exact procedure.
3. Generate a token (Autotoken) in the API settings of the bank app.

![PrivatBank online account: the "All services" tab, the "Business" section is highlighted on the left and the "Merchant" item is highlighted on the right](https://bimpsoft.com/help/_img/b0f43036-1718-4ec2-bd3f-22680071ea3f.webp)

## How to connect the account

1. Open **Directories → Banks/Bank accounts** and choose the account you need.
2. Go to the "Integration" tab.
3. In the "Integrator" field, choose **Privatbank**.
4. In the "token" field, paste the token (Autotoken) generated in the bank's online account.
5. Click **Save** - synchronization is activated.

![A PrivatBank account card in Bimp: the "Integration" tab is open, "Privatbank" is selected in the "Integrator" field, below it are the empty required "token" field and the Save and Delete buttons](https://bimpsoft.com/help/_img/b5cbb5b6-48ea-4e0c-bb3a-24215c06b120.webp)

> [!TIP] The token is a secret access key to the account statement. Keep it in a safe place and do not share it with outsiders.

## How to get a statement after connecting

Open the **Finance** section, click **Client-bank**, choose the account and the "Period", and save - details are in Automatic exchange with banks. Allocate the received transactions to documents: [Allocating bank statement transactions](https://bimpsoft.com/en/help/finance/bank-statement-processing/).

## Common problems

**I cannot find where to generate the token.** The token is created in the API settings of the bank app. If the section is missing, contact PrivatBank support.

**The statement does not load after saving the token.** Check that a merchant has been created in the bank's online account, and that the token was pasted without extra spaces into the card of exactly the account you need the statement from.

## FAQ

**Where do I get the PrivatBank token for Bimp?**

In the API settings of your bank app or PrivatBank online account. If you do not see a section for generating the token, contact the bank's support.

**Do I need to do anything in PrivatBank before connecting?**

Yes, you need to create a merchant in the bank's online account. Ask PrivatBank support for the creation procedure.

**What should I do if I opened a new PrivatBank account?**

Create a separate account for it in the "Banks/Bank accounts" directory in Bimp and set up the integration in its card following these instructions.