Підключити ПриватБанк
- Доступно на ознайомчому періоді та тарифах Базовий, Стандарт і Преміум
- Потрібне доповнення «Моніторинг статусу оплати»
ПриватБанк підключається токеном доступу, який ви створюєте в Приват24 для бізнесу і вставляєте у вікно «Підключити PrivatBank» на сторінці Підключення банків. Після підключення сервіс сам перевіряє виписку ваших рахунків у ПриватБанку, і оплати за посиланнями на ці рахунки отримують статус «Оплачено» без вашої участі. Як сервіс звіряє оплати, описано в статті Як працює моніторинг статусу оплати.
Перед підключенням
- Перевірте, що доповнення «Моніторинг статусу оплати» підключене: без нього кабінет не дасть підключити банк. Як його підключити — у статті Доповнення до тарифу.
- Вам потрібен доступ до Приват24 для бізнесу з компʼютера: у мобільному застосунку розділу для створення токена немає.
- Відстежуватися будуть посилання, IBAN яких належить рахункам, до яких дає доступ токен. Посилання на рахунки в інших банках підключення ПриватБанку не зачепить.
Отримати токен у Приват24 для бізнесу
Токен створюється у веб-версії Приват24 для бізнесу, у розділі інтеграції Автоклієнт: ви підключаєте API для нового застосунку (назвіть його, наприклад, IBAN oplata), обмежуєте його права лише отриманням балансів і транзакцій за рахунками і копіюєте токен, який покаже банк. Із такими правами сервіс може тільки читати виписку — переказувати кошти він не може. Покрокову інструкцію зі знімками екрана наведено в статті блогу Як отримати токен у Приват24 для бізнесу; на неї веде й посилання у вікні підключення.
Копіюйте токен цілком і вставляйте одразу з буфера обміну, без проміжних файлів: обрізаний токен банк не прийме.
Підключити ПриватБанк у кабінеті
- Відкрийте сторінку Підключення банків: у меню акаунта (чип із вашою поштою внизу бокової панелі; на вузькому екрані — у меню кабінету) або кнопкою Підключення банків на сторінці Моніторинг оплат.
- На картці PrivatBank натисніть Підключити. Відкриється вікно «Підключити PrivatBank» з полями Назва і Токен PrivatBank.
- У полі Назва вкажіть назву, за якою ви впізнаєте це підключення у списку, — наприклад, імʼя ФОП або назву рахунку. Поле обовʼязкове, до 256 символів.
- У поле Токен PrivatBank вставте скопійований токен.
- Натисніть Підтвердити доступ. Сервіс перевірить токен у банку й отримає список рахунків; зʼявиться вікно «PrivatBank успішно підключений.».
- Прочитайте повідомлення про ідентифікатор оплат у цьому вікні і натисніть ОК.
Повідомлення про ідентифікатор оплат каже, чи додаватиме сервіс до призначення платежу код на кшталт «#K7M2». «Ідентифікатор оплат увімкнено» означає, що код додаватиметься до кожної нової оплати; «Ідентифікатор оплат вимкнено» — що колись ви вимкнули його самі, і підключення банку цей вибір не змінило. Навіщо код, описано в статті Ідентифікатор оплати у призначенні платежу.
Що зʼявиться після підключення
У таблиці на сторінці Підключення банків зʼявиться рядок: у колонці Банк — «ПриватБанк», у колонці Назва — те, що ви вказали у вікні, у колонці Статус — «Активний». Назву можна змінити пізніше — як це зробити, описано в статті Перейменувати або відключити банк.
Окремо обирати рахунки в кабінеті не потрібно: сервіс бере всі рахунки, до яких токен давав доступ у момент підключення, і звіряє надходження на ті з них, IBAN яких стоїть у ваших посиланнях. Рахунок, відкритий у ПриватБанку пізніше, сервіс не побачить: видаліть старе підключення і підключіть ПриватБанк ще раз. Якщо у вас кілька бізнес-кабінетів у ПриватБанку, підключіть кожен окремим токеном.
ПриватБанк не повідомляє сервіс про зарахування сам, тому сервіс перевіряє виписку: найчастіше — у перші хвилини після того, як платник натиснув Оплатити, а далі дедалі рідше, але не рідше ніж раз на годину.
Якщо щось не так
- Під полем «Токен PrivatBank» зʼявилося «Токен доступу до АПІ PrivatBank не дійсний». Токен скопійовано не повністю, або його відкликано в Приват24 для бізнесу. Скопіюйте токен ще раз цілком або створіть новий і вставте його.
- Під полем зʼявилося «Обліковий запис відключено через налаштування додатка «Автоклієнт» у «Приват24 для бізнесу»». Застосунок, для якого створено токен, вимкнений або не має потрібних прав. Перевірте його налаштування в Приват24 для бізнесу.
- Під полем зʼявилося «PrivatBank тимчасово обмежив кількість запитів. Спробуйте за кілька хвилин.». Зачекайте кілька хвилин і натисніть Підтвердити доступ ще раз.
- Під полем зʼявилося повідомлення «PrivatBank відхилив запит» з кодом або «Не вдалося підключитися до банку з цим токеном. Перевірте токен та спробуйте ще раз.». Перевірте налаштування застосунку в Приват24 для бізнесу і сам токен; якщо помилка повторюється, зверніться в підтримку і назвіть код із повідомлення.
- Під полем зʼявилося «Автоматичний трекінг вхідних оплат доступний лише за наявності відповідного доповнення до передплати.». Доповнення «Моніторинг статусу оплати» не підключене або його період закінчився. Підключіть доповнення на сторінці Мій тариф і спробуйте знову.
- Після натискання «Підключити» відкрилося вікно «Потрібне доповнення «Моніторинг статусу оплати»». Доповнення не підключене або його період закінчився.
- Щоб підключити доповнення з цього вікна, натисніть Підключити доповнення — сторінка Мій тариф відкриється в новій вкладці. Як оформити доповнення, описано в статті Доповнення до тарифу.
- Підключення пройшло, а оплати не підтверджуються. Перевірте, що IBAN у посиланнях належить рахунку, до якого дає доступ токен. Інші причини описано в статті Оплата є, а статус не змінився.