Vault connects to Privat24 for Business directly, through PrivatBank's own «Автоклієнт» API. You paste an ID and a token from Privat24 for Business, and Vault starts importing balances and transactions.
Vault only reads. It asks PrivatBank for balances and statements and never calls payment functions.
For other banks, see Connecting a bank account. For banks in Ukraine, see Ukraine.
What the connection does
You copy two values from Privat24 for Business: the ID and the token. Vault checks them with PrivatBank and shows the accounts the bank returns for this token.
The token and the ID are stored encrypted. They are never put in a link, a log or an error message. When a connection is disconnected, Vault deletes its stored copy.
What Vault can do:
read account balances;
read the transactions of the accounts you choose.
What Vault cannot do:
make payments or transfers;
change anything in Privat24 for Business;
revoke the token on the bank's side. Only you can do that (see below).
One token is one connection. A token can give access to several accounts, and all of them belong to the same connection. It uses one bank connection slot of your plan, whatever the number of accounts.
An account with several currencies becomes a separate Vault account for each currency.
Vault shows exactly the accounts PrivatBank returns for the token. If your ФОП and your ТОВ have separate tokens, each token is its own connection and uses its own slot.
Before you start
Bank connections are available on paid plans. New workspaces get a 14-day Pro trial with no card required, so you can try them straight away.
Plan | Bank connections |
Free | Not included |
Basic | 2 |
Pro (and the Pro trial) | 10 |
Enterprise | Agreed individually |
PrivatBank, Monobank and European banks all count towards the same limit. Crypto wallets do not.
You need the right to manage accounts. The Owner, Admin and Editor roles have it. A custom role needs Account management set to View and edit.
In Privat24 for Business, you need access to the «Автоклієнт» section, so you can create a token.
How to get the ID and token in Privat24 for Business
Open Privat24 for Business.
Open «Автоклієнт» → API.
Create a token.
Copy the ID shown next to the token.
Copy the token itself.
Make sure the accounts you want in Vault are enabled for this token in «Автоклієнт».
Copy the ID and the token from the same «Автоклієнт» entry. A token without its own ID does not work.
How to connect in Vault
On the dashboard, click Add account and open the Bank account tab.
Under Data provider, choose PrivatBank.
Set the Start date. This is where your history begins (see the next section). Choose it now: you cannot change it later.
Click Add account.
Paste the ID into Autoclient ID and the token into Token.
Click Connect. Vault checks the token with PrivatBank and shows the accounts the bank returns.
In Choose accounts to add, tick the accounts you want and click Add selected.
Each row shows the currency, the account name, the last four characters of the account number and the balance. Accounts already in this workspace are marked Connected and cannot be ticked.
You can add the rest later. Connect again with the same token: the new accounts join the same connection and use no extra slot.
If a row says No exchange rate for USD (or another currency), Vault has no rate for that currency yet.
After Connect, the accounts list is kept for one hour. If you wait longer, paste the token again.
The first import
History starts at the Start date you chose. It can be up to 720 days ago (about two years). The field starts at today's date. If you leave it there, Vault loads only the most recent operations, not older history.
The start date belongs to the connection. A reconnect does not move it.
Import starts within a minute of adding the accounts. While it runs, the account card shows Importing transactions.
How it works:
the most recent operations come first;
older history follows in 31-day steps;
Vault sends PrivatBank about one request per second for each token, so accounts under the same token load one after another.
Long histories and busy accounts take longer. You can use Vault while the import runs.
How often data updates
Vault reads recent operations every 15 minutes. The balance updates after each of these reads.
Once a day has closed at the bank, Vault reads that day again from the bank's final statement, so the day's operations match it.
If PrivatBank has not been read for more than 45 minutes, the card says: Sync is delayed: the bank has not been read for over 45 minutes. Balances and operations may be out of date.
There is no manual refresh button for PrivatBank.
What each transaction contains
Date and time. When PrivatBank sends a time, Vault keeps the exact time (Kyiv time). Otherwise it keeps the date only.
Amount and currency. The amount in the account's currency. Debits are negative, credits are positive. Vault also stores the amount in your workspace currency, at the rate of the transaction date.
Description. The first line is the payment purpose. The second line is the counterparty's name and ЄДРПОУ code.
If the purpose already contains the counterparty's name, the second line shows only the ЄДРПОУ code. If a part is missing, it is left out.
Your edits are kept. Vault never rewrites the description, the category or the counterparty after import. Only bank facts are updated: the amount, the date and the pending status.
Pending transactions
If PrivatBank reports an operation as not yet booked, Vault imports it with the Pending mark.
When the bank books it, the same transaction loses the mark. Your edits stay.
When the bank reverses or rejects it, Vault removes it.
If it is missing from the bank's final statement for its day, Vault removes it too.
If Vault could not check some pending operations against the final statement, the card says: Some pending operations could not be checked against the final statement; one of them may be out of date.
Balance
The balance is PrivatBank's own figure, from the bank's current balance for the account. Vault does not add or subtract pending operations.
When you add an account, it starts with the balance shown in the list. After that, it updates every 15 minutes.
«—» means Vault has no confirmed balance for this account. For example, PrivatBank sent no balance, or sent figures that disagree. Transactions stay available. If a later read fails, Vault keeps the last confirmed balance.
When you need to reconnect
The card shows Reconnect needed when:
PrivatBank no longer accepts the token (for example, you deleted it), or the ID does not match the token. This affects every account of the connection;
an account was disabled in «Автоклієнт». This affects that account only.
To reconnect:
Open the account's menu and choose Reconnect.
Paste the Autoclient ID and the Token. Use a token of the same business: a new one, or the current one if it still works.
Click Reconnect.
Nothing is lost. The accounts, transactions, categories and your edits stay. Vault matches the accounts by account number and currency, so a new token finds the same accounts. Operations missed while access was down are loaded afterwards.
Reconnect resumes the account you started it from. Other accounts you paused stay paused.
More than one workspace
You can connect the same token in several workspaces. Each workspace gets its own connection, syncs it on its own and uses its own slot.
Within one workspace, the same account cannot be connected twice.
One token is one connection in a workspace. To reconnect a connection, you cannot use a token that is already used by another PrivatBank connection in the same workspace.
Pausing, disconnecting and removing
Action | What happens | History and balance | Plan slot |
Pause integration (one account) | New operations keep importing but stay hidden until you resume. Other accounts keep syncing. | Kept. Operations before the pause stay visible. | Still used |
Pause integration (last active account) | The connection is disconnected. Vault deletes its copy of the token and ID. To resume, use Reconnect. | Kept | Freed |
Resume integration | Vault asks PrivatBank for a fresh balance. Operations imported during the pause appear. | Kept | Still used |
Disconnect bank | Sync stops for every account of the connection. Vault deletes its copy of the token and ID. To resume, use Reconnect. | Kept, with your edits | Freed |
Convert to manual | The account becomes manual. Hidden operations from a pause are deleted. Cannot be undone. | Visible history and edits kept | Freed if it was the last bank account of the connection |
Delete | The account and all its transactions are deleted. Cannot be undone. | Deleted | Freed if it was the last bank account of the connection |
When you delete the last active account of a connection, the connection is removed too. Its paused accounts become manual: history before the pause stays, operations from the pause are deleted.
Removing Vault's access in PrivatBank
Vault cannot revoke a PrivatBank token. Disconnecting or deleting in Vault removes Vault's copy, but the token stays active at the bank.
To revoke access, delete the token yourself in Privat24 for Business, in the «Автоклієнт» settings.
If you delete the token while the connection is active, the card shows Reconnect needed. Your history stays in Vault.
Plan changes and payments
Moving to Free (including a cancelled subscription): bank connections are disconnected. The card says Disconnected due to plan limits.
Moving to a plan with fewer bank connections: connections over the new limit are disconnected. The card says Disconnected due to plan limits.
A failed payment: sync continues while the payment is retried. If the retries end without payment, sync stops and connections are disconnected. The card says Disconnected after payment attempts ended.
A trial that ended without payment: sync stops and connections are disconnected. The card says The trial has ended.
History and balances are always kept. Paying again does not reconnect automatically: use Reconnect. Reconnecting a disconnected connection needs a free slot in your plan.
If something goes wrong
Messages while connecting or reconnecting
Message | What to do |
Enter the Autoclient ID. Privat24 for Business shows it next to the token in the «Автоклієнт» settings. | Paste the ID from the same «Автоклієнт» entry as the token. |
The bank did not accept this token. Check it in Privat24 for Business and try again. | Copy the token again. If it was deleted, create a new one. |
This ID does not match the token. Copy both from the same «Автоклієнт» entry in Privat24 for Business and try again. | Copy the ID and the token again, from one entry. |
The account is disabled in «Автоклієнт». Enable it in Privat24 for Business and try again. | Enable the account for this token in «Автоклієнт». |
A token has no spaces or line breaks. Copy it again in full, without gaps. | Copy the token again, in one piece. |
This is too long to be a token (more than the allowed number of characters). Copy only the token. | Paste only the token. |
This is too long to be an ID (more than the allowed number of characters). Copy only the ID. | Paste only the ID. |
An ID has only Latin letters, digits and punctuation. Copy it again from Privat24 for Business. | Copy the ID again. |
The bank returned no accounts for this token. | Enable the accounts for this token in «Автоклієнт», then connect again. |
PrivatBank is unavailable right now. Try again in a few minutes. | Wait a few minutes and try again. |
PrivatBank is in a maintenance window. Try again later. | Try again later. |
We could not reach PrivatBank. Try again in a few minutes. | Wait a few minutes and try again. |
PrivatBank did not respond. Try again in a few minutes. | Wait a few minutes and try again. |
The bank connection is busy with a sync right now. Try again in a few seconds. | Try again in a few seconds. |
PrivatBank answered in a shape we do not understand. Try again later. | Try again later. If it repeats, contact support. |
PrivatBank is not available for this workspace yet. | Contact support. |
Connecting PrivatBank is temporarily unavailable. | Try again later. If it repeats, contact support. |
The connection expired. Paste the token again. | More than an hour passed after Connect. Paste the token again. |
The connection could not be restored. Paste the token again. | Paste the token again. |
These accounts are already connected. | Nothing to do: they are already in this workspace. |
One of these accounts was just connected by someone else. Try again. | Try again. The list will show it as connected. |
The connection changed while you were saving. Try again. | Try again. |
This connection is disconnected. Open the menu of one of its accounts and choose Reconnect. | Use Reconnect on the account card instead of adding it again. |
Choose a start date between two years ago and today. | Pick a start date in that range. |
This token belongs to a different business: it lists none of this connection’s accounts. Use a token from the same «Автоклієнт» as before. | Use a token of the business this connection belongs to. |
This token is already used by another PrivatBank connection in this workspace. Create a separate token for this connection. | Create a separate token for this connection. |
The token’s list does not include this account, so it was not reconnected. Check that the account is enabled in «Автоклієнт» in Privat24 for Business and try again. | Enable the account for the token in «Автоклієнт», then reconnect. Its other accounts were already reconnected. |
The token was accepted, but the connection could not be restored. Try again. | Click Try again. You do not need to paste the token again. |
This connection changed after you started reconnecting. Close this window and check the account. | Close the window and check the account card. |
This account is no longer part of a PrivatBank connection in this workspace. Reload the page. | Reload the page. |
You do not have permission to manage this connection. | Ask an Owner or Admin for the right to manage accounts. |
You no longer have access to this workspace, so nothing was saved. Refresh the page. | Refresh the page. |
The active workspace changed, so nothing was saved. Refresh the page and try again. | Refresh the page and try again. |
Your session has ended. Sign in again. | Sign in again. |
Something went wrong. Please try again. | Try again. If it repeats, contact support. |
During a reconnect, a plan or payment problem shows the usual billing message with a button to Billing.
What the account card shows
Status | What to do |
Importing transactions | Wait. History is loading. |
Synced | Nothing to do. |
Sync is delayed: the bank has not been read for over 45 minutes. Balances and operations may be out of date. | Usually a temporary bank outage, and Vault retries on its own. If it lasts for hours, contact support. |
Reconnect needed | Use Reconnect (see above). |
Sync error | Contact support. |
Some operations for a period may not have loaded. | Compare that period with Privat24 for Business and contact support. |
Some pending operations could not be checked against the final statement; one of them may be out of date. | Check the pending operations against Privat24 for Business. |
Sync paused — payment required | Go to Billing. |
All accounts are paused / Disconnected manually / Disconnected due to plan limits / Disconnected after payment attempts ended / The trial has ended | Use Reconnect when you want to sync again. |
Still stuck? Write to us in the chat or at [email protected].
