Як отримати токен monobank і підключити його до трекера витрат

Кому знадобиться ця інструкція

Ви користуєтеся monobank, хочете бачити витрати в трекері, не вписуючи вручну кожну каву, і не бажаєте віддавати вхід до банку сторонньому сервісу. Budgie підключається до monobank натомість через персональний токен: ви самі створюєте його на сторінці банку й вставляєте в застосунок.

monobank відкриває такий доступ лише клієнтам від 16 років; дані дитячих карток доступні через доступ батьків.

Що токен може, а чого — ні

Персональний токен monobank призначений для читання ваших власних даних: списку карток і банок, їхніх залишків і виписки. Персональний доступ monobank не має платіжних функцій, тож токен не може переказати гроші чи щось змінити у вашому банку.

Budgie використовує його рівно для двох речей: щоб отримати список ваших карток і банок із залишками та щоб завантажити транзакції за рахунками, які ви оберете.

Покроково

1. Відкрийте підключення monobank у Budgie

Відкрийте «Новий рахунок» і в розділі «Синхронізація рахунків» натисніть «Монобанк». Якщо ви ще проходите початкове налаштування застосунку, там є таке саме підключення monobank. Відкриється екран «Підключити Монобанк».

2. Отримайте персональний токен у monobank

• Натисніть «Отримати API-токен» угорі екрана. Сторінка API monobank, api.monobank.ua, відкриється просто в Budgie. Цю адресу можна відкрити й у будь-якому браузері.
• Увійдіть, відсканувавши QR-код на цій сторінці застосунком monobank. QR-код найзручніше сканувати з іншого екрана, тож часто швидше відкрити сторінку на комп’ютері.
• Створіть на цій сторінці персональний токен і скопіюйте його.

3. Вставте токен у Budgie

Поверніться на екран «Підключити Монобанк» і вставте токен у поле внизу — кнопка поруч із полем вставляє його з буфера обміну одним дотиком. Поле приховує токен під час введення. Далі натисніть «Отримати рахунки».

4. Оберіть картки й банки

Один токен охоплює всі ваші картки в monobank. Budgie показує спершу картки, а нижче, окремим розділом, банки. Позначте потрібні або натисніть «Вибрати всі», а тоді «Продовжити».

5. Оберіть, скільки історії завантажити

monobank надсилає приблизно один місяць історії за хвилину для кожного вибраного рахунку, тож це вибір між глибиною історії та часом очікування:

• «Останній 1 місяць» — близько хвилини.
• «Останні 3 місяці» — близько 3 хвилин. Цей варіант обрано за замовчуванням.
• «Останні 6 місяців» — близько 6 хвилин.
• «Останній рік» — близько 12 хвилин.
• «Увесь період» — для давнього рахунку може тривати години.
• «Не синхронізувати історію» — минулі операції не завантажуються, лише нові відтепер.

Час указано для одного рахунку: три місяці для двох карток — це приблизно шість хвилин. Рік або весь період довантажуються у фоновому режимі й ідуть значно повільніше, коли застосунок закритий, тож відкритий Budgie прискорює процес.

6. Натисніть «Розпочати синхронізацію»

Ось і все налаштування. Ваші картки й банки з’являться як рахунки, згруповані під monobank, кожен із власним перемикачем, і почнуть надходити транзакції.

Що відбувається після підключення

• Нові транзакції надходять у фоновому режимі, навіть коли ви не користуєтеся застосунком, — хоча й повільніше, ніж із відкритим Budgie.
• Покупки надходять із кодом категорії продавця (MCC), який додає банк, і Budgie одразу розносить багато з них за категоріями. Докладніше — автоматичні категорії за MCC-кодами.
• Коли надходять реальні витрати, місячний бюджет перестає бути здогадкою. Докладніше — планування бюджету.
• Усе, що вміє це підключення, — від банок до переказів між власними картками, — описано на сторінці синхронізації з monobank.

Де зберігається ваш токен

Токен зберігається в базі даних Budgie на вашому телефоні, і застосунок надсилає його лише в monobank: телефон запитує ваші дані в банку напряму. Власного сервера, який бачив би ваш токен чи транзакції, у Budgie немає.

Ставтеся до токена як до ключа від своєї виписки: не вставляйте його в чати й нікому не передавайте. Якщо підозрюєте, що він потрапив до чужих рук, створіть новий на сторінці API monobank і оновіть його в Budgie, як описано нижче.

Якщо щось пішло не так

«Синхронізація не вдалась» або токен перестав працювати

Якщо monobank раз у раз відхиляє токен, Budgie кілька разів пробує знову, а потім позначає рахунок як «Синхронізація не вдалась» і вимикає для нього синхронізацію. Отримайте новий токен у monobank, відкрийте налаштування рахунку, натисніть «Змінити» біля «API токен», вставте новий і збережіть. Потім знову увімкніть перемикач «Синхронізація».

Історія завантажується повільно

Це обмеження monobank, а не збій: виписку можна запитувати не частіше ніж раз на хвилину, і один запит охоплює до 31 дня. Budgie сам перечікує паузу й продовжує, тож нічого натискати не треба. Найшвидше довга історія завантажується, коли застосунок відкритий.

Деякі недавні транзакції виглядають неправильно або відсутні

Відкрийте налаштування рахунку й повторно синхронізуйте період: останні 7, 30 чи 90 днів або всю історію. Це почнеться під час наступної синхронізації. Докладніше — у розділі повторна синхронізація за період.

Часті запитання