PaymentOnline: connecting PrivatBank

Before connecting a bank, turn on PaymentOnline and fill in the legal details. How to do that, and how payment rules and the commission balance work, is covered in PaymentOnline - payment by IBAN transfer.

What you need

• A sole proprietor (FOP) or LLC account at PrivatBank with access to Privat24 for Business.
• Access to Privat24 for Business with the right to connect integrations.
• A Cash desk selected on the PaymentOnline screen. Until one is selected, the Connect button does nothing.

Where to get the token

1. Sign in to Privat24 for Business.
2. In the right-hand menu, choose Усі продукти та послуги (All products and services).
3. Find the Інтеграція (Автоклієнт) tile (Integration, Autoclient) and click Підключити API (Connect API).
4. Under Обмеження по сервісам (Service restrictions), choose Дозволити лише обрані (Allow selected only), mark Отримання балансів і транзакцій за рахунками (Getting account balances and transactions) and click Підключити (Connect).
5. Click the key icon Отримати токен (Get token), copy the token and paste it into Wlaunch.

The token gives read access to the balances and transactions of your accounts. Do not send it to anyone, and paste it into Wlaunch only.

Connecting

1. Open Payments for online services -> Payment services -> PaymentOnline.
2. In the Bank account block, choose PrivatBank.
3. Paste the token into the Token field and click Connect.
4. A list of the accounts the token reaches appears. In the Choose the account to receive payments block, mark the account payers will transfer money to and click Select account. If there is only one account, it is selected automatically.

If the bank does not accept the token, check that you copied it in full. If the account you need is not in the list, click Refresh.

Once an account is selected, the Account for incoming payments block shows the IBAN payments arrive at. To pick another account of the same bank, click Change.

How Wlaunch sees payments

PrivatBank does not send notifications about incoming payments, so Wlaunch checks the account periodically, usually every few minutes. Because of that, a bank transfer through PrivatBank is confirmed with a delay. For a required payment, set the Payment timeout in the payment rule to at least 30 minutes, or the appointment may be cancelled before Wlaunch sees the transfer.

While the connection to the bank works, the account carries no label. If the connection breaks, a Needs attention label appears next to the account, with a Problems detected message and its reason. First click Refresh. If the token is no longer valid, for example, because it was changed at PrivatBank, disconnect the bank and connect it again with a new token.

Disconnecting and changing the bank

The bank or the token can only be changed by disconnecting:

1. Click Disconnect under the account and confirm with Yes, disconnect.
2. Connect the same bank with a new token, or connect a different bank, and choose the account that receives payments.

While the bank is disconnected, payers are not offered PaymentOnline. The option comes back once a bank is connected and an account is selected.

After disconnecting, Wlaunch stops checking the account. Wlaunch cannot switch the token itself off: if you no longer need it, turn it off in Privat24 for Business.