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