PaymentOnline: connecting monobank

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) account at monobank. LLC accounts cannot be connected through monobank.
• The monobank app on the account owner's phone.
• A Cash desk selected on the PaymentOnline screen. Until one is selected, the Connect button does nothing.

Where to get the token

1. Open api.monobank.ua.
2. Scan the QR code shown there with the monobank app.
3. Copy the token that appears on the page.

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.

monobank sends notifications about incoming payments to just one address per token. If another service already receives payment notifications for this token, they go to Wlaunch once you connect, and that service stops receiving them.

Connecting

1. Open Payments for online services -> Payment services -> PaymentOnline.
2. In the Bank account block, choose Monobank.
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 account you need is not in the list, click Refresh. monobank allows reading the accounts once a minute, so try again a little later.

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

monobank notifies Wlaunch of every incoming payment itself, so a transfer shows up almost as soon as the payer makes it.

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 reissued at api.monobank.ua, 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 receiving notifications from monobank. Wlaunch cannot switch the token itself off: if you no longer need it, delete or reissue it at api.monobank.ua.