Протокол ПриватБанку JSON

Інтеграція POS-терміналів банку з програмним забезпеченням касового модуля торговельно-сервісного підприємства.
 

JSON-протокол – це універсальний касовий протокол, який підтримує суміщення з будь-якою моделлю POS-термінала, що експлуатується в ПриватБанку (Ingenico, Verifone, PAX, Newland, Castles та інші).

Як налаштувати суміщення POS-термінала з касою

Касове суміщення – це інтеграція POS-термінала для приймання безготівкових платежів із програмним реєстратором розрахункових операцій (ПРРО) або іншим касовим апаратом, що дає змогу автоматично передавати дані про транзакції до податкової служби.

Умови для касового суміщення

Спочатку ознайомтеся з пріоритетними пропозиціями наших партнерів-розробників за посиланням.

Потім завантажте касову програму вибраного постачальника на комп’ютер, ноутбук або планшет. Якщо потрібно, скористайтеся інструкцією від постачальника.

Кроки налаштування:

Крок 1

Уточніть у представника касової програми:

  • тип підключення (WI-FI, Ethernet, USB);
  • протокол (JSON, BPOS);
  • тип суміщення.

Типи суміщення:

  • жорстке – усі платежі проводяться тільки за запитом каси (не дозволяє касиру ініціювати фінансові операції безпосередньо з термінала);
  • не жорстке – залишається можливість приймати платежі як за запитом із термінала, так і з каси (пункт «Оплата» залишається в меню термінала).

Крок 2

Якщо плануєте використовувати суміщення за USB, то обов'язково потрібно встановити драйвери до відповідної моделі термінала.

Якщо плануєте працювати з протоколом JSON (через USB, WiFi чи Ethernet), завантажте тестовий емулятор каси (generic Driver JSON).

Драйвери до терміналів, а також документацію за протоколом JSON можна завантажити з SFTP-сховища.

Як увійти та завантажити драйвери й документацію

  1. Завантажте та встановіть програму для доступу на SFTP. Рекомендуємо програму: https://winscp.net/eng/download.php
  2. Запустіть програму:
    • Нове підключення
    • Протокол файлу: SFTP
    • Ім’я хоста (вузол): sftp.privatbank.ua
    • Порт: 2222
    • Ім’я користувача: pos_ecr_all
    • Пароль: 3si*m;3uE#G5E8&N
  3. Натисніть «Увійти».
  4. Виберіть папку з необхідним протоколом залежно від вимог налаштування системи касової програми (JSON, BPOS).

Після узгодження параметрів суміщення зверніться до підтримки ПриватБанку, щоб налаштувати термінал. Телефон підтримки: 0 800 500 030.

Крок 3

Налаштуйте касову програму з ІТ-представником компанії касової програми.

Налаштування протоколу JSON через WI-FI.

Якщо у вас уже встановлено термінал на системі Android, рекомендуємо налаштувати суміщення за протоколом JSON через WI-FI. Ви можете зробити це самостійно через сторінку Helper (меню «Технічні питання – Налаштування термінала – Налаштування суміщення») або звернутися до підтримки ПриватБанку за телефоном: 0 800 500 030.

 

Поширені запитання

  1.  Що говорить закон про реалізацію поєднання термінала з фронт-офісним ПЗ і реалізацію єдиного чека?
    • Постанова КМУ № 878 від 29.10.2010 «Про здійснення розрахунків за продані товари (надані послуги) з використанням спеціальних платіжних засобів».
    • Закон України № 1053-1 «Про внесення змін до Закону України "Про застосування реєстраторів розрахункових операцій у сфері торгівлі, громадського харчування та послуг" щодо детінізації розрахунків у сфері торгівлі і послуг».
    • Наказ Міністерства фінансів України № 13 від 21.01.2016, розділ ІІ «Фіскальний касовий чек на товари (послуги)», пункт 6.
     
  2. Що таке JSON-протокол від ПриватБанку?
    JSON-протокол – це єдиний протокол для інтеграції POS-терміналів ПриватБанку з фронт-офісним програмним забезпеченням, що використовується на касових вузлах у торговельно-сервісних мережах. Підтримує поєднання з вендорами Ingenico, Verifone, PAX, Newland.
     
  3. Чим JSON-протокол вигідно відрізняється від інших протоколів або бібліотек для інтеграції?
    Бібліотека протоколу вшита в програмне забезпечення POS-терміналів, що дозволяє розгорнути касове рішення на будь-якій платформі без прив’язки до ОС, що істотно спрощує інтегрування. Не вимагає встановлення, реєстрації додаткових бібліотек, компонентів тощо на ПК.
     
  4. У чому вигода переходу на JSON-протокол?
    У найближчому майбутньому ПриватБанк поступово відмовиться від закупівлі класичних кнопкових терміналів, віддаючи перевагу Android-моделям із просунутим функціоналом, що тягне витіснення закритих протоколів окремих вендорів і перехід на єдиний загальнобанківський JSON-протокол. Реалізація JSON-протоколу дозволить отримати універсальне касове рішення з підтримкою всіх моделей терміналів та використовувати просунуті способи оплати, наприклад FacePay24.
     
  5. Які типи підключень можливі на JSON-протоколі?
    Термінал може підключатися як за допомогою USB/Ethernet, так і через Wi-Fi (моделі на Android: PAX, Newland).
     
  6. Чи необхідно оновлювати драйвери при підключенні терміналів?
    Так, на ОС сімейства Windows необхідно оновити драйвери, актуальні версії для всіх вендорів терміналів (Ingenico, Verifone, PAX, Newland) викладені на SFTP.
     
  7. Що може протокол JSON?
    JSON-протокол підтримує роботу з усіма сервісами банку, як от: «Оплата частинами», «Миттєва розстрочка», облік робочого часу, інкасація, видача готівки тощо.
    Продаж із видачею готівки йде як звичайна операція, а не у форматі окремого сценарію, що істотно спрощує та прискорює процес.
    Ще одним плюсом є реалізація в перспективі операції FacePay через касу.
     
Зміст