Vault підключається до Приват24 для бізнесу напряму, через власний API ПриватБанку «Автоклієнт». Ви вставляєте ID і токен із Приват24 для бізнесу, і Vault починає імпортувати баланси та транзакції.
Vault лише читає дані. Він запитує в ПриватБанку баланси й виписки і ніколи не викликає платіжні функції.
Про інші банки читайте в статті Підключення банківського рахунку. Про банки в Україні — у статті Україна.
Що робить підключення
Ви копіюєте з Приват24 для бізнесу два значення: ID і токен. Vault перевіряє їх у ПриватБанку і показує рахунки, які банк повертає для цього токена.
Токен та ID зберігаються в зашифрованому вигляді. Вони ніколи не потрапляють у посилання, журнали чи повідомлення про помилки. Коли підключення відключено, Vault видаляє свою збережену копію.
Що Vault може:
читати баланси рахунків;
читати транзакції рахунків, які ви виберете.
Чого Vault не може:
здійснювати платежі чи перекази;
змінювати щось у Приват24 для бізнесу;
відкликати токен на боці банку. Це можете зробити лише ви (див. нижче).
Один токен — одне підключення. Токен може давати доступ до кількох рахунків, і всі вони належать до одного підключення. Воно займає одне місце для банківських підключень у вашому тарифі, незалежно від кількості рахунків.
Мультивалютний рахунок стає окремим рахунком у Vault для кожної валюти.
Vault показує саме ті рахунки, які ПриватБанк повертає для токена. Якщо у вашого ФОП і вашого ТОВ окремі токени, кожен токен — це окреме підключення, і воно займає окреме місце.
Перед початком
Банківські підключення доступні на платних тарифах. Нові воркспейси отримують пробний період Pro на 14 днів без картки, тож спробувати можна одразу.
Тариф | Банківські підключення |
Free | Не входять |
Basic | 2 |
Pro (і пробний період Pro) | 10 |
Enterprise | За індивідуальною домовленістю |
ПриватБанк, Monobank і європейські банки рахуються в межах одного ліміту. Криптогаманці — ні.
Потрібне право керувати рахунками. Воно є в ролей Власник, Адміністратор і Редактор. Для своєї ролі право Керування рахунками має бути встановлено на Перегляд і редагування.
У Приват24 для бізнесу вам потрібен доступ до розділу «Автоклієнт», щоб створити токен.
Як отримати ID і токен у Приват24 для бізнесу
Відкрийте Приват24 для бізнесу.
Відкрийте «Автоклієнт» → API.
Створіть токен.
Скопіюйте ID, який показано поруч із токеном.
Скопіюйте сам токен.
Переконайтеся, що потрібні вам рахунки увімкнено для цього токена в «Автоклієнт».
Копіюйте ID і токен з одного запису «Автоклієнт». Токен без свого ID не працює.
Як підключити у Vault
На дашборді натисніть Додати рахунок і відкрийте вкладку Банк.
У полі Постачальник даних виберіть ПриватБанк.
Вкажіть Дата початку. З цієї дати почнеться ваша історія (див. наступний розділ). Оберіть її зараз: пізніше її не можна змінити.
Натисніть Додати рахунок.
Вставте ID у поле ID автоклієнта, а токен — у поле Токен.
Натисніть Підключити. Vault перевірить токен у ПриватБанку і покаже рахунки, які повертає банк.
У вікні Виберіть рахунки для додавання позначте потрібні рахунки й натисніть Додати вибрані.
У кожному рядку — валюта, назва рахунку, останні чотири символи номера рахунку і баланс. Рахунки, які вже є в цьому воркспейсі, позначено Підключено, і їх не можна вибрати.
Решту можна додати пізніше. Підключіться ще раз із тим самим токеном: нові рахунки потраплять у те саме підключення і не займуть додаткового місця.
Якщо в рядку написано Немає курсу для USD (або для іншої валюти), у Vault поки немає курсу для цієї валюти.
Після Підключити список рахунків зберігається одну годину. Якщо ви чекали довше, вставте токен ще раз.
Перший імпорт
Історія починається з обраної дати початку. Це може бути до 720 днів тому (близько двох років). У полі спочатку стоїть сьогоднішня дата. Якщо її не змінити, Vault завантажить лише найсвіжіші операції, без давнішої історії.
Дата початку належить підключенню. Перепідключення її не змінює.
Імпорт починається протягом хвилини після додавання рахунків. Поки він триває, на картці рахунку написано Імпорт транзакцій.
Як це працює:
спочатку завантажуються найсвіжіші операції;
давніша історія завантажується далі кроками по 31 дню;
Vault надсилає ПриватБанку приблизно один запит на секунду для кожного токена, тож рахунки одного токена завантажуються по черзі.
Довга історія та рахунки з великою кількістю операцій завантажуються довше. Поки триває імпорт, Vault можна користуватися.
Як часто оновлюються дані
Vault читає свіжі операції кожні 15 хвилин. Після кожного такого читання оновлюється баланс.
Коли день у банку закрито, Vault ще раз читає його з підсумкової виписки банку, щоб операції дня з нею збігалися.
Якщо ПриватБанк не опитувався понад 45 хвилин, на картці написано: Синхронізація затримується: банк не опитувався понад 45 хвилин. Баланс і операції можуть бути неактуальними.
Кнопки ручного оновлення для ПриватБанку немає.
Що містить кожна транзакція
Дата і час. Коли ПриватБанк передає час, Vault зберігає точний час (за Києвом). Інакше зберігається лише дата.
Сума і валюта. Сума у валюті рахунку. Списання — від’ємні, зарахування — додатні. Vault також зберігає суму у валюті воркспейсу за курсом на дату транзакції.
Опис. Перший рядок — призначення платежу. Другий рядок — назва контрагента і його код ЄДРПОУ.
Якщо призначення вже містить назву контрагента, у другому рядку буде лише код ЄДРПОУ. Якщо якоїсь частини немає, її пропущено.
Ваші правки зберігаються. Після імпорту Vault ніколи не переписує опис, категорію чи контрагента. Оновлюються лише банківські дані: сума, дата і статус «В обробці».
Транзакції в обробці
Якщо ПриватБанк повідомляє про операцію, яку ще не проведено, Vault імпортує її з позначкою В обробці.
Коли банк її проведе, та сама транзакція втратить позначку. Ваші правки залишаться.
Коли банк її сторнує або відхилить, Vault її видалить.
Якщо її немає в підсумковій виписці банку за її день, Vault теж її видалить.
Якщо Vault не зміг звірити частину операцій в обробці з підсумковою випискою, на картці написано: Деякі операції в очікуванні не вдалося звірити з підсумковою випискою; одна з них може бути застарілою.
Баланс
Баланс — це власна цифра ПриватБанку, поточний баланс рахунку в банку. Vault не додає й не віднімає операції в обробці.
Щойно доданий рахунок отримує баланс, показаний у списку. Далі він оновлюється кожні 15 хвилин.
«—» означає, що Vault не має підтвердженого балансу для цього рахунку. Наприклад, ПриватБанк не передав баланс або передав суми, що не збігаються. Транзакції залишаються доступними. Якщо наступне читання не вдасться, Vault залишить останній підтверджений баланс.
Коли потрібне перепідключення
На картці написано Потрібне перепідключення, коли:
ПриватБанк більше не приймає токен (наприклад, ви його видалили) або ID не відповідає токену. Це стосується всіх рахунків підключення;
рахунок вимкнено в «Автоклієнт». Це стосується лише цього рахунку.
Як перепідключити:
Відкрийте меню рахунку й виберіть Перепідключити.
Вставте ID автоклієнта і Токен. Використайте токен тієї самої компанії: новий або чинний, якщо він ще працює.
Натисніть Перепідключити.
Нічого не втрачається. Рахунки, транзакції, категорії та ваші правки збережуться. Vault зіставляє рахунки за номером рахунку і валютою, тож новий токен знайде ті самі рахунки. Операції, пропущені поки доступу не було, завантажаться після цього.
Перепідключення відновлює рахунок, з якого ви його почали. Інші рахунки, які ви призупинили, залишаться на паузі.
Кілька воркспейсів
Той самий токен можна підключити в кількох воркспейсах. Кожен воркспейс отримує власне підключення, синхронізує його самостійно і займає власне місце.
В одному воркспейсі той самий рахунок не можна підключити двічі.
Один токен — одне підключення у воркспейсі. Для перепідключення не можна використати токен, який уже використовує інше підключення ПриватБанку в тому самому воркспейсі.
Пауза, відключення і видалення
Дія | Що відбувається | Історія і баланс | Місце в тарифі |
Призупинити інтеграцію (один рахунок) | Нові операції продовжують завантажуватися, але приховані до відновлення. Інші рахунки синхронізуються далі. | Зберігаються. Операції до паузи залишаються видимими. | Залишається зайнятим |
Призупинити інтеграцію (останній активний рахунок) | Підключення відключається. Vault видаляє свою копію токена та ID. Щоб продовжити, використайте Перепідключити. | Зберігаються | Звільняється |
Відновити інтеграцію | Vault запитує в ПриватБанку свіжий баланс. Операції, завантажені під час паузи, з’являються. | Зберігаються | Залишається зайнятим |
Відключити банк | Синхронізація зупиняється для всіх рахунків підключення. Vault видаляє свою копію токена та ID. Щоб продовжити, використайте Перепідключити. | Зберігаються разом із вашими правками | Звільняється |
Перетворити на ручний | Рахунок стає ручним. Приховані операції періоду паузи видаляються. Скасувати не можна. | Видима історія і правки зберігаються | Звільняється, якщо це був останній банківський рахунок підключення |
Видалити | Рахунок і всі його транзакції видаляються. Скасувати не можна. | Видаляються | Звільняється, якщо це був останній банківський рахунок підключення |
Коли ви видаляєте останній активний рахунок підключення, підключення теж видаляється. Його призупинені рахунки стають ручними: історія до паузи зберігається, операції періоду паузи видаляються.
Як забрати доступ Vault у ПриватБанку
Vault не може відкликати токен ПриватБанку. Відключення чи видалення у Vault прибирає копію Vault, але токен у банку залишається активним.
Щоб відкликати доступ, видаліть токен самостійно в Приват24 для бізнесу, у налаштуваннях «Автоклієнт».
Якщо видалити токен, поки підключення активне, на картці з’явиться Потрібне перепідключення. Ваша історія у Vault залишиться.
Зміна тарифу та оплата
Перехід на Free (зокрема після скасування підписки): банківські підключення відключаються. На картці написано Відключено через обмеження тарифу.
Перехід на тариф із меншою кількістю банківських підключень: підключення понад новий ліміт відключаються. На картці написано Відключено через обмеження тарифу.
Невдала оплата: синхронізація триває, поки оплата повторюється. Якщо спроби закінчилися без оплати, синхронізація зупиняється, а підключення відключаються. На картці написано Відключено після остаточної несплати.
Пробний період закінчився без оплати: синхронізація зупиняється, а підключення відключаються. На картці написано Пробний період завершився.
Історія та баланси завжди зберігаються. Після оплати підключення не відновлюється автоматично: використайте Перепідключити. Для перепідключення відключеного підключення потрібне вільне місце в тарифі.
Якщо щось пішло не так
Повідомлення під час підключення чи перепідключення
Повідомлення | Що робити |
Вкажіть ID автоклієнта. Приват24 для бізнесу показує його поруч із токеном у налаштуваннях «Автоклієнт». | Вставте ID з того самого запису «Автоклієнт», що й токен. |
Банк не прийняв цей токен. Перевірте його в Приват24 для бізнесу і спробуйте ще раз. | Скопіюйте токен ще раз. Якщо його видалено, створіть новий. |
Цей ID не відповідає токену. Скопіюйте обидва значення з одного запису «Автоклієнт» у Приват24 для бізнесу і спробуйте ще раз. | Скопіюйте ID і токен ще раз, з одного запису. |
Рахунок вимкнено в «Автоклієнт». Увімкніть його в Приват24 для бізнесу і спробуйте ще раз. | Увімкніть рахунок для цього токена в «Автоклієнт». |
У токені немає пробілів і переносів рядка. Скопіюйте його ще раз повністю, без розривів. | Скопіюйте токен ще раз, цілим. |
Це задовго для токена (понад допустиму кількість символів). Скопіюйте лише токен. | Вставте лише токен. |
Це задовго для ID (понад допустиму кількість символів). Скопіюйте лише ID. | Вставте лише ID. |
В ID бувають лише латинські літери, цифри та розділові знаки. Скопіюйте його ще раз із Приват24 для бізнесу. | Скопіюйте ID ще раз. |
Банк не повернув рахунків для цього токена. | Увімкніть рахунки для цього токена в «Автоклієнт» і підключіться ще раз. |
ПриватБанк зараз недоступний. Спробуйте за кілька хвилин. | Зачекайте кілька хвилин і спробуйте ще раз. |
У ПриватБанку технологічне вікно. Спробуйте пізніше. | Спробуйте пізніше. |
Не вдалося зв’язатися з ПриватБанком. Спробуйте за кілька хвилин. | Зачекайте кілька хвилин і спробуйте ще раз. |
ПриватБанк не відповів. Спробуйте за кілька хвилин. | Зачекайте кілька хвилин і спробуйте ще раз. |
Підключення до банку зараз зайняте синхронізацією. Спробуйте ще раз за кілька секунд. | Спробуйте ще раз за кілька секунд. |
ПриватБанк відповів у неочікуваному форматі. Спробуйте пізніше. | Спробуйте пізніше. Якщо повторюється, напишіть у підтримку. |
ПриватБанк поки недоступний для цього воркспейсу. | Напишіть у підтримку. |
Підключення ПриватБанку тимчасово недоступне. | Спробуйте пізніше. Якщо повторюється, напишіть у підтримку. |
Підключення минуло. Вставте токен ще раз. | Після Підключити минуло понад годину. Вставте токен ще раз. |
Не вдалося відновити підключення. Вставте токен ще раз. | Вставте токен ще раз. |
Ці рахунки вже підключено. | Нічого робити не потрібно: вони вже є в цьому воркспейсі. |
Один із цих рахунків щойно підключив хтось інший. Спробуйте ще раз. | Спробуйте ще раз. У списку він буде позначений як підключений. |
Підключення змінилося, поки ви зберігали. Спробуйте ще раз. | Спробуйте ще раз. |
Це підключення відключено. Відкрийте меню одного з його рахунків і виберіть «Перепідключити». | Використайте Перепідключити на картці рахунку замість повторного додавання. |
Оберіть дату початку не раніше ніж два роки тому і не пізніше сьогодні. | Виберіть дату в цьому проміжку. |
Цей токен належить іншій компанії: у його списку немає жодного рахунку цього підключення. Використайте токен із того самого «Автоклієнт», що й раніше. | Використайте токен компанії, якій належить це підключення. |
Цей токен уже використовує інше підключення ПриватБанку в цьому воркспейсі. Створіть окремий токен для цього підключення. | Створіть окремий токен для цього підключення. |
У списку токена немає цього рахунку, тому його не перепідключено. Перевірте, що рахунок увімкнено в «Автоклієнт» у Приват24 для бізнесу, і спробуйте ще раз. | Увімкніть рахунок для токена в «Автоклієнт» і перепідключіть. Інші рахунки підключення вже перепідключено. |
Токен прийнято, але відновити підключення не вдалося. Спробуйте ще раз. | Натисніть Спробувати ще раз. Вставляти токен повторно не потрібно. |
Підключення змінилося після того, як ви почали перепідключення. Закрийте це вікно й перевірте рахунок. | Закрийте вікно й перевірте картку рахунку. |
Цей рахунок більше не належить до підключення ПриватБанку в цьому воркспейсі. Оновіть сторінку. | Оновіть сторінку. |
У вас немає прав на керування цим підключенням. | Попросіть Власника чи Адміністратора надати право керувати рахунками. |
У вас більше немає доступу до цього воркспейсу, нічого не збережено. Оновіть сторінку. | Оновіть сторінку. |
Активний воркспейс змінився, нічого не збережено. Оновіть сторінку та повторіть. | Оновіть сторінку та спробуйте ще раз. |
Сесію завершено. Увійдіть знову. | Увійдіть знову. |
Щось пішло не так. Спробуйте ще раз. | Спробуйте ще раз. Якщо повторюється, напишіть у підтримку. |
Під час перепідключення проблема з тарифом чи оплатою показує звичайне повідомлення про оплату з кнопкою переходу до Оплата.
Що показує картка рахунку
Статус | Що робити |
Імпорт транзакцій | Зачекайте. Історія завантажується. |
Синхронізовано | Нічого робити не потрібно. |
Синхронізація затримується: банк не опитувався понад 45 хвилин. Баланс і операції можуть бути неактуальними. | Зазвичай це тимчасовий збій банку, і Vault повторює спроби сам. Якщо це триває годинами, напишіть у підтримку. |
Потрібне перепідключення | Використайте Перепідключити (див. вище). |
Помилка синхронізації | Напишіть у підтримку. |
Частина операцій за певний період могла не завантажитися. | Порівняйте цей період із Приват24 для бізнесу і напишіть у підтримку. |
Деякі операції в очікуванні не вдалося звірити з підсумковою випискою; одна з них може бути застарілою. | Звірте операції в обробці з Приват24 для бізнесу. |
Синхронізацію призупинено — потрібна оплата | Перейдіть до розділу Оплата. |
Усі рахунки призупинені / Відключено вручну / Відключено через обмеження тарифу / Відключено після остаточної несплати / Пробний період завершився | Використайте Перепідключити, коли захочете знову синхронізувати. |
Не вдається розібратися? Напишіть нам у чат або на [email protected].
