Перейти до основного вмісту

Підключення банківського термінала ПриватБанку до 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. Скажіть:

  1. Потрібно підключити термінал до комп'ютера каси за протоколом JSON.
  2. Вид підключення: USB, Wi-Fi або мережевий кабель.
  3. Суміщення нежорстке.

Нежорстке суміщення означає, що пункт Оплата залишається в меню термінала: оплату можна провести і з каси, і з самого термінала.

Крок 2. Завантажити програму ПриватБанку​

  1. Відкрийте сторінку ПриватБанку Технічні рекомендації та інструкції по інтеграції POS-терміналів.
  2. У блоці JSON протокол завантажте Касовий емулятор для Windows.zip.
  3. Розпакуйте архів. У ньому дві програми:
    • з genericDriverJsonUSB у назві — для USB;
    • з genericDriverJsonETH у назві — для Wi-Fi і мережевого кабелю.
  4. Перенесіть програму для свого підключення на робочий стіл.

Для USB завантажте на тій самій сторінці ще й драйвер: у блоці USB драйвери для терміналів виберіть архів виробника свого термінала. Розпакуйте архів і встановіть драйвер.

Крок 3. Підключити термінал до комп'ютера​

Через USB​

  1. Підключіть термінал до комп'ютера кабелем USB.
  2. Відкрийте Параметри Windows → Bluetooth та пристрої → Пристрої.
  3. У блоці Інші пристрої знайдіть термінал. У дужках після назви стоїть номер порту, наприклад Ingenico Desk3xxx (COM4).
  4. Запишіть число з номера порту. У прикладі це 4.

Через Wi-Fi або мережевий кабель​

  1. Підключіть термінал до того самого роутера, що й комп'ютер каси.
  2. Знайдіть IP-адресу термінала: у списку підключених пристроїв роутера або в налаштуваннях мережі на самому терміналі.
  3. Запишіть IP-адресу, наприклад 192.168.31.65.

Крок 4. Створити ярлик «PrivatBank»​

Програму ПриватБанку завжди запускають через ярлик. У ярлику записаний номер порту або IP-адреса термінала.

  1. Натисніть на програму на робочому столі правою кнопкою миші і виберіть Створити ярлик. У Windows 11 цей пункт є в розділі Показати додаткові параметри.
  2. Перейменуйте ярлик на PrivatBank.
  3. Натисніть на ярлик правою кнопкою миші і виберіть Властивості.
  4. У полі Об'єкт (у російській Windows — Объект) поставте курсор у кінець рядка і через пробіл допишіть:
    • для USB — -p і число з номера порту, наприклад -p 4;
    • для Wi-Fi і мережевого кабелю — -ip і IP-адресу термінала, наприклад -ip 192.168.31.65.
  5. Натисніть Застосувати, потім OK.

Поле Об'єкт після цього виглядає приблизно так:

"C:\Users\Kasa\Desktop\genericDriverJsonETH_07072026.exe" -ip 192.168.31.65

Файл самої програми більше не відкривайте. Завжди запускайте ярлик PrivatBank.

Крок 5. Запустити ярлик​

  1. Двічі натисніть на ярлик PrivatBank. Відкриється чорне вікно програми.
  2. Під час першого запуску Windows покаже повідомлення брандмауера. Натисніть Дозволити доступ.
  3. Дочекайтеся у вікні рядка Socket waiting connection on * : 3000. Це означає, що програма з'єдналася з терміналом.

Вікно програми не закривайте, поки працює каса.

Крок 6. Налаштувати касу​

  1. Відкрийте налаштування каси: значок шестерні внизу праворуч на головному екрані.
  2. У рядку Банківський термінал натисніть Налаштувати.
  3. У полі Протокол виберіть ПриватБанк JSON і натисніть OK.
  4. У полі Інтерфейс виберіть Websocket і натисніть OK.
  5. Натисніть на приклад адреси під полем IP адреса. У полі з'явиться ws://localhost:3000/echo. Цю адресу не змінюйте.
  6. Натисніть Перевірити. Якщо все налаштовано правильно, каса покаже Успішно налаштовано!. Натисніть Зрозуміло.
  7. Натисніть Зберегти. Каса повернеться на екран Налаштування.
  8. На екрані Налаштування натисніть Зберегти.

Кнопку Отримати в рядку Мерчант натискайте, тільки якщо на терміналі кілька мерчантів. Тоді виберіть мерчанта, через якого ця каса приймає оплату.

Як касир приймає оплату: оплата через термінал.

Крок 7. Щодня​

  1. На початку дня запустіть ярлик PrivatBank, потім відкрийте касу.
  2. Наприкінці дня закрийте вікно програми. Якщо його не закрити, наступного ранку програма може працювати некоректно.

Якщо змінилася IP-адреса або порт​

Після перезавантаження термінала чи роутера IP-адреса термінала може змінитися. Номер порту змінюється, якщо підключити термінал до іншого роз'єму USB.

  1. Закрийте вікно програми.
  2. Подивіться нову IP-адресу або новий номер порту, як у кроці 3.
  3. Відкрийте Властивості ярлика PrivatBank і змініть значення після -ip або -p у полі Об'єкт.
  4. Натисніть Застосувати, потім OK, і запустіть ярлик знову.

Щоб IP-адреса не змінювалася, її можна закріпити за терміналом у роутері, якщо роутер це вміє: закріпити IP-адресу термінала в роутері.

Якщо каса не бачить термінал​

Перевірте по черзі:

  1. Вікно програми відкрите, і в ньому є рядок Socket waiting connection on * : 3000.
  2. Програму запущено через ярлик PrivatBank, а не через сам файл програми.
  3. У полі Об'єкт ярлика вказана поточна IP-адреса або поточний номер порту термінала.
  4. У касі вибрано протокол ПриватБанк JSON, інтерфейс Websocket і адресу ws://localhost:3000/echo.

Зв'язок комп'ютера з терміналом можна перевірити окремо від каси. Відкрийте в браузері http://localhost:3000, натисніть Open, потім Ping Device. Якщо в блоці Данные з'явилося Устройство подключено, комп'ютер бачить термінал.

Підсумок​

Термінал ПриватБанку працює зі Skynum.Каса на Windows і Mac через програму ПриватБанку на комп'ютері каси. Банк налаштовує термінал на нежорстке суміщення за протоколом JSON. Програму завантажують зі сторінки ПриватБанку і запускають тільки через ярлик PrivatBank, у якому записаний номер порту або IP-адреса термінала. У касі вибирають ПриватБанк JSON, Websocket і адресу ws://localhost:3000/echo. Щодня ярлик запускають перед роботою, а програму закривають наприкінці дня.