Vault підключається до Monobank напряму, через власний API Monobank. Ви підтверджуєте доступ у застосунку Monobank на телефоні, обираєте, які картки й рахунки додати, а Vault далі сам підтримує їх в актуальному стані. Як працюють банківські підключення загалом, читайте в статті Підключення банківського рахунку.

Що дає підключення

Доступ ви підтверджуєте в застосунку Monobank, а не у Vault. Vault не бачить і не зберігає ваші дані для входу в Monobank чи реквізити карток. У списку рахунків Vault показує лише останні чотири цифри кожної картки.

Доступ лише для читання. Vault бачить ваші рахунки, баланси й транзакції. Здійснювати платежі чи переказувати гроші він не може.

Один клієнт Monobank — одне підключення. Усі ваші картки й рахунки Monobank працюють за одним підтвердженням і разом займають одне місце для банківського підключення у вашому тарифі. Якщо згодом ви додасте ще картки Monobank, додаткове місце вони не займуть.

Перш ніж почати

Банківські підключення доступні на платних тарифах. Нові воркспейси отримують пробний період Pro на 14 днів без картки, тож спробувати можна одразу.

Тариф	Банківські підключення
Free	Не входять
Basic	2
Pro	10
Enterprise	За індивідуальною домовленістю

Також знадобляться:

право керувати рахунками у воркспейсі;
телефон зі встановленим застосунком Monobank, у який ви увійшли.

Як підключити

На дашборді натисніть Додати рахунок і відкрийте вкладку Банк.
У полі Постачальник даних оберіть Monobank.
Вкажіть Дату початку: з якого дня Vault має імпортувати транзакції. Можна обрати до 720 днів тому або скористатися швидкими варіантами на 30, 90 і 180 днів. Якщо залишити поле порожнім, Vault імпортує останні 31 день. Потім натисніть Додати рахунок.
Vault покаже QR-код і посилання. На комп’ютері відскануйте QR-код камерою телефона. На телефоні скопіюйте посилання й відкрийте його. В обох випадках відкриється застосунок Monobank.
У застосунку Monobank підтвердьте доступ для Vault.
Повернувшись у Vault, ви побачите Підтверджено — завантажуємо перелік рахунків…, а потім список ваших карток і рахунків Monobank з валютою, типом картки, останніми чотирма цифрами та балансом.
Позначте потрібні й натисніть Додати обрані. Решту можна додати пізніше.

Не закривайте вікно Vault, поки підтверджуєте доступ. Vault перевіряє підтвердження автоматично. Якщо це триває довше приблизно 10 хвилин, з’явиться повідомлення Усе ще чекаємо на підтвердження. Посилання при цьому дійсне, тож підтвердьте доступ у застосунку й натисніть Перевірити ще раз.

Що може бути в списку рахунків:

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

Перший імпорт

Нові рахунки одразу з’являються на дашборді, а поки завантажується історія, на картці рахунку видно Імпорт транзакцій.

Історія завантажується частинами, тому перший імпорт триває якийсь час. Monobank дозволяє Vault за один запит прочитати приблизно місяць історії, і лише обмежену кількість запитів на хвилину. Кілька місяців історії зазвичай завантажуються за кілька хвилин, а рік-два для кількох карток — за годину й більше. Тим часом можна працювати у Vault: транзакції з’являтимуться в міру надходження.

Як часто оновлюються дані

Нові транзакції зазвичай з’являються протягом кількох хвилин. Monobank повідомляє Vault про зміни на рахунку, і Vault одразу завантажує нові транзакції. Крім того, щонайменше раз на 6 годин Vault перевіряє кожен рахунок, на випадок якщо якесь повідомлення загубилося.

Що містить кожна транзакція

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

Категорії з Monobank не імпортуються, тож їх ви задаєте самі. Ваші категорії, назви й нотатки наступні оновлення ніколи не перезаписують.

Транзакції в обробці

Оплати карткою, які Monobank ще утримує, імпортуються зі статусом В обробці. Вони виділені кольором і враховуються в підсумках. Коли платіж проведено, та сама транзакція оновлюється на місці, без дубліката; остаточна сума може трохи відрізнятися. Якщо утримання скасовано, транзакція зникає. Такі зміни можуть з’являтися із затримкою до 6 годин.

Баланс

Vault показує баланс, який Monobank повідомляє для кожного рахунку, і оновлює його з кожним оновленням. Якщо на картці замість балансу стоїть —, Vault ще не має актуального балансу. Транзакції при цьому імпортуються.

Коли потрібно перепідключитися

Доступ до Monobank не спливає сам по собі. Він припиняється, лише якщо його відкликали: наприклад, якщо ви видалили доступ Vault у Monobank або знову підтвердили доступ для Vault з іншого воркспейсу (див. нижче).

Коли доступ припиняється, на картці рахунку з’являються червона крапка й Потрібне перепідключення. Історія залишається у Vault. Щоб відновити підключення:

Відкрийте меню рахунку й оберіть Перепідключити.
Відскануйте QR-код або відкрийте посилання й підтвердьте доступ у застосунку Monobank. Використайте той самий акаунт Monobank, який підключали спочатку.

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

Пункт Перепідключити з’являється лише тоді, коли це потрібно. Кожне нове підтвердження в Monobank замінює попереднє, тож якщо почати перепідключення справного підключення й не завершити підтвердження, підключення зламається.

Monobank у кількох воркспейсах

Monobank дозволяє лише одне активне підтвердження на клієнта. Якщо підключити той самий Monobank у другому воркспейсі, підключення в першому перестане отримувати дані й покаже Потрібне перепідключення. Vault попереджає про це до підтвердження.

Тож тримайте кожного клієнта Monobank підключеним лише в одному воркспейсі. Перепідключення в першому воркспейсі, своєю чергою, зупинить другий.

Пауза, відключення й видалення

Усе це є в меню картки рахунку.

Дія	Що відбувається	Місце в тарифі
Призупинити інтеграцію	Попередні транзакції залишаються видимими. Нові й далі надходять, але приховані, доки ви не відновите інтеграцію. Баланс фіксується.	Залишається зайнятим, якщо це не останній активний рахунок Monobank. Інакше підключення відключається, а місце звільняється.
Відновити інтеграцію	Транзакції за час паузи з’являються в списках, звітах і підсумках.	Зайняте
Відключити підключення	Синхронізація зупиняється для всіх ваших рахунків Monobank у цьому воркспейсі. Історія й розмітка залишаються, видно останній баланс. Щоб підключити знову, потрібне нове підтвердження в застосунку Monobank.	Звільняється
Перепідключити	Повертає ті самі рахунки з історією. Див. вище.	Знову зайняте
Перетворити на ручний	Рахунок назавжди стає ручним. Видима історія залишається; приховані за час паузи транзакції видаляються; суми транзакцій в обробці стають остаточними. Скасувати неможливо.	Звільняється, коли не лишається підключених рахунків
Видалити	Рахунок і всі його транзакції видаляються. Скасувати неможливо.	Звільняється, коли не лишається підключених рахунків

Потрібно звільнити місце, нічого не втративши? Скористайтеся пунктом Відключити підключення. Його повністю можна скасувати.

Як видалити доступ Vault у Monobank

Відключення чи видалення у Vault зупиняє лише бік Vault. Monobank не дає сервісам змоги самим відкликати доступ, тож Vault залишається в списку сервісів із доступом до вашого Monobank, доки ви його не видалите.

Щоб видалити доступ, увійдіть на api.monobank.ua і відкрийте сторінку Agent access tokens. Там перелічено всі сервіси з доступом до вашого Monobank; видаліть запис Vault. Якщо зробити це, поки рахунки ще підключені, на них з’явиться Потрібне перепідключення.

Зміна тарифу та оплата

Перехід на нижчий тариф у застосунку. Якщо банківських підключень більше, ніж дозволяє новий тариф, Vault запитає, які з них відключити. Історія залишається, перепідключитися можна пізніше.
Скасування підписки. Підключення понад ліміт нового тарифу відключаються (на Free — усі). На картці буде Відключено через обмеження тарифу. Повторна підписка сама їх не перепідключає: скористайтеся пунктом Перепідключити.
Платіж не пройшов. Поки платіж повторюється, дані синхронізуються далі. Якщо всі спроби невдалі, підключення відключаються зі статусом Відключено після остаточної несплати, а воркспейс стає доступним лише для перегляду, доки підписку не буде відновлено або ви не перейдете на Free.
Пробний період закінчився, а платний тариф не обрано. Підключення відключаються зі статусом Пробний період завершився, а воркспейс стає доступним лише для перегляду, доки ви не оберете тариф або не перейдете на Free.

У будь-якому разі ваша історія залишається у Vault.

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

Повідомлення	Що робити
Термін дії запиту минув	Посилання для підтвердження більше не дійсне. Натисніть Спробувати ще раз, щоб отримати нове.
Усе ще чекаємо на підтвердження	Підтвердьте доступ у застосунку Monobank і натисніть Перевірити ще раз.
Підключення розпочато в іншому воркспейсі	Перейдіть у воркспейс, де мають бути ці рахунки, і почніть спочатку.
Не вдалося зв’язатися з Monobank.	Спробуйте ще раз за кілька хвилин. Якщо ви додаєте картки до відключеного підключення, спершу перепідключіть його.
Не вдалося перепідключити. Нічого не змінилося — спробуйте ще раз.	Переконайтеся, що підтверджуєте доступ у тому самому акаунті Monobank, який підключали спочатку, і спробуйте ще раз.
Рахунок не підключено	Цю картку зараз не можна підключити; інших рахунків це не стосується. Напишіть нам у чат.
Досягнуто ліміту банківських підключень вашого тарифу.	Перейдіть на вищий тариф або відключіть інший банк, щоб звільнити місце.
Для підключення банку потрібно поновити оплату воркспейсу.	Оновіть платіжні дані в налаштуваннях оплати й спробуйте ще раз.

Не вдається розібратися? Напишіть нам у чат або на [email protected].