Підключення банківського термінала ПриватБанку до Skynum.Каса
Термінал ПриватБанку працює зі Skynum.Каса через програму ПриватБанку, запущену на комп'ютері каси. Термінал підключається до комп'ютера через USB, Wi-Fi або мережевий кабель.
Каса працює з терміналом ПриватБанку:
- на Windows — у браузері за адресою
pos.skynum.comабо в Skynum.Каса для Windows; - на Mac — тільки в браузері. Замість програми ПриватБанку на Mac потрібна програма Skynum: зверніться в підтримку Skynum.
На Android термінал ПриватБанку не підключається. На Android-пристрої з NFC використовуйте NFC-оплату ПриватБанк. Інші способи безготівкової оплати: Еквайринг у Skynum.Каса.
Нижче — підключення на комп'ютері з Windows, по кроках.
Крок 1. Налаштувати термінал у банку
Термінал має бути налаштований банком на роботу з комп'ютером каси.
Якщо на головному екрані Android-термінала є значок Касове суміщення, банк уже це зробив. Відкрийте Касове суміщення і виберіть, як термінал підключений до комп'ютера: USB підключення, WIFI підключення або LAN підключення (мережевий кабель).
Якщо значка немає або термінал кнопковий, без Android, зателефонуйте в підтримку ПриватБанку: 0 800 500 030. Скажіть:
- Потрібно підключити термінал до комп'ютера каси за протоколом JSON.
- Вид підключення: USB, Wi-Fi або мережевий кабель.
- Суміщення нежорстке.
Нежорстке суміщення означає, що пункт Оплата залишається в меню термінала: оплату можна провести і з каси, і з самого термінала.
Крок 2. Завантажити програму ПриватБанку
- Відкрийте сторінку ПриватБанку Технічні рекомендації та інструкції по інтеграції POS-терміналів.
- У блоці JSON протокол завантажте Касовий емулятор для Windows.zip.
- Розпакуйте архів. У ньому дві програми:
- з
genericDriverJsonUSBу назві — для USB; - з
genericDriverJsonETHу назві — для Wi-Fi і мережевого кабелю.
- з
- Перенесіть програму для свого підключення на робочий стіл.
Для USB завантажте на тій самій сторінці ще й драйвер: у блоці USB драйвери для терміналів виберіть архів виробника свого термінала. Розпакуйте архів і встановіть драйвер.
Крок 3. Підключити термінал до комп'ютера
Через USB
- Підключіть термінал до комп'ютера кабелем USB.
- Відкрийте Параметри Windows → Bluetooth та пристрої → Пристрої.
- У блоці Інші пристрої знайдіть термінал. У дужках після назви стоїть номер порту, наприклад
Ingenico Desk3xxx (COM4). - Запишіть число з номера порту. У прикладі це
4.
Через Wi-Fi або мережевий кабель
- Підключіть термінал до того самого роутера, що й комп'ютер каси.
- Знайдіть IP-адресу термінала: у списку підключених пристроїв роутера або в налаштуваннях мережі на самому терміналі.
- Запишіть IP-адресу, наприклад
192.168.31.65.
Крок 4. Створити ярлик «PrivatBank»
Програму ПриватБанку завжди запускають через ярлик. У ярлику записаний номер порту або IP-адреса термінала.
- Натисніть на програму на робочому столі правою кнопкою миші і виберіть Створити ярлик. У Windows 11 цей пункт є в розділі Показати додаткові параметри.
- Перейменуйте ярлик на
PrivatBank. - Натисніть на ярлик правою кнопкою миші і виберіть Властивості.
- У полі Об'єкт (у російській Windows — Объект) поставте курсор у кінець рядка і через пробіл допишіть:
- для USB —
-pі число з номера порту, наприклад-p 4; - для Wi-Fi і мережевого кабелю —
-ipі IP-адресу термінала, наприклад-ip 192.168.31.65.
- для USB —
- Натисніть Застосувати, потім OK.
Поле Об'єкт після цього виглядає приблизно так:
"C:\Users\Kasa\Desktop\genericDriverJsonETH_07072026.exe" -ip 192.168.31.65
Файл самої програми більше не відкривайте. Завжди запускайте ярлик PrivatBank.
Крок 5. Запустити ярлик
- Двічі натисніть на ярлик PrivatBank. Відкриється чорне вікно програми.
- Під час першого запуску Windows покаже повідомлення брандмауера. Натисніть Дозволити доступ.
- Дочекайтеся у вікні рядка
Socket waiting connection on * : 3000. Це означає, що програма з'єдналася з терміналом.
Вікно програми не закривайте, поки працює каса.
Крок 6. Налаштувати касу
- Відкрийте налаштування каси: значок шестерні внизу праворуч на головному екрані.
- У рядку Банківський термінал натисніть Налаштувати.
- У полі Протокол виберіть ПриватБанк JSON і натисніть OK.
- У полі Інтерфейс виберіть Websocket і натисніть OK.
- Натисніть на приклад адреси під полем IP адреса. У полі з'явиться
ws://localhost:3000/echo. Цю адресу не змінюйте. - Натисніть Перевірити. Якщо все налаштовано правильно, каса покаже Успішно налаштовано!. Натисніть Зрозуміло.
- Натисніть Зберегти. Каса повернеться на екран Налаштування.
- На екрані Налаштування натисніть Зберегти.
Кнопку Отримати в рядку Мерчант натискайте, тільки якщо на терміналі кілька мерчантів. Тоді виберіть мерчанта, через якого ця каса приймає оплату.
Як касир приймає оплату: оплата через термінал.
Крок 7. Щодня
- На початку дня запустіть ярлик PrivatBank, потім відкрийте касу.
- Наприкінці дня закрийте вікно програми. Якщо його не закрити, наступного ранку програма може працювати некоректно.
Якщо змінилася IP-адреса або порт
Після перезавантаження термінала чи роутера IP-адреса термінала може змінитися. Номер порту змінюється, якщо підключити термінал до іншого роз'єму USB.
- Закрийте вікно програми.
- Подивіться нову IP-адресу або новий номер порту, як у кроці 3.
- Відкрийте Властивості ярлика PrivatBank і змініть значення після
-ipабо-pу полі Об'єкт. - Натисніть Застосувати, потім OK, і запустіть ярлик знову.
Щоб IP-адреса не змінювалася, її можна закріпити за терміналом у роутері, якщо роутер це вміє: закріпити IP-адресу термінала в роутері.
Якщо каса не бачить термінал
Перевірте по черзі:
- Вікно програми відкрите, і в ньому є рядок
Socket waiting connection on * : 3000. - Програму запущено через ярлик PrivatBank, а не через сам файл програми.
- У полі Об'єкт ярлика вказана поточна IP-адреса або поточний номер порту термінала.
- У касі вибрано протокол ПриватБанк JSON, інтерфейс Websocket і адресу
ws://localhost:3000/echo.
Зв'язок комп'ютера з терміналом можна перевірити окремо від каси. Відкрийте в браузері http://localhost:3000, натисніть Open, потім Ping Device. Якщо в блоці Данные з'явилося Устройство подключено, комп'ютер бачить термінал.
Підсумок
Термінал ПриватБанку працює зі Skynum.Каса на Windows і Mac через програму ПриватБанку на комп'ютері каси. Банк налаштовує термінал на нежорстке суміщення за протоколом JSON. Програму завантажують зі сторінки ПриватБанку і запускають тільки через ярлик PrivatBank, у якому записаний номер порту або IP-адреса термінала. У касі вибирають ПриватБанк JSON, Websocket і адресу ws://localhost:3000/echo. Щодня ярлик запускають перед роботою, а програму закривають наприкінці дня.