How to get a monobank acquiring token
- In finiq, open “Integrations” → “Registers, CRM & payments”, find the monobank еквайринг card and click “Connect”.
- Sign in to the business cabinet at web.monobank.ua and open the internet acquiring settings.
- Create or copy the API token (X-Token). The personal token from api.monobank.ua will not do: it reads cards, not the shop's payments.
- Paste the token below. finiq only reads the merchant's details and the payment statement and changes nothing.
- Click “Check and continue”: finiq checks the access and shows the accounts.
- For each account, choose “New account”, “Existing account” or “Do not sync”.
- In “Load history for”, choose the number of months and click “Start syncing”. Transactions appear gradually.
Good to know
- Successful payments come in as income at the full amount with a revenue category, the bank's fee (the amount less what the merchant receives) as a separate expense, refunds as expenses dated when they were made. Holds and failed payments are not imported; refunds are seen if they happen within a month of the payment.
- Each currency of the shop is an account of its own, of the «E-wallet» type: money the service holds until it pays out. The service's API does not report payouts to your bank account, so mark the deposits from it in your connected bank as transfers from this account — easiest with an auto-rule «Purpose contains …» → «Transfer». Otherwise the revenue is counted twice.
- A cash register, CRM or payment service connects with an access key: order payments and sales become operations automatically every 30 minutes, buyers become counterparties, and auto-rules work just as for banks. The key is stored encrypted.
- The key is encrypted and never shown in full; disconnecting the integration deletes it.
Who can do this. The owner, admins and financiers connect cash registers, CRMs and payment services.