¶ Загальна інформація
Перед початком налаштування потрібно отримати попередньо налаштований термінал у банку.
На терміналі банком має бути:
- Встановлено налаштування для роботи терміналу;
- Заведено мерчанта або торгівця по якому будуть здійснюватись транзакції по терміналу, або кілька мерчантів(за потреби);
Номер мерчанту, для подальшої роботи з терміналом, можна дізнатись в банку або через Device Manager за допомогою API або через вебінтерфейс налаштування терміналу натиснувши на кнопку "Отримати список мерчантів".
- Підключено ліцензію на користування (або ключі).
- Налаштовано інтерфейс підключення до касового пз із доступних на самому терміналі.
¶ Підключення та налаштування
Для підключення потрібно обрати інтерфейс через який буде здійснюватись комунікація з банківським терміналом:
Доступні інтерфейси: Ethernet/Wi-Fi, USB/COM, TCP Server)
Мається на увазі комунікація з терміналом по мережі. Термінал до мережі може бути підключеним як по Wi-Fi так і через кабель.
Для підключення даним способом потрібно знати IP адресу терміналу та порт якщо він відрізняється від стандартного у банку.
Приклад перегляду IP адреси через сайт маршрутизатора tp-link(http://tplinkwifi.net/#networkMap). Можливо також здійснити пошук ІР адресу терміналу по МАС термінала в налаштуваннях роутера. МАС адрес вказано на самому терміналі.
Якщо термінал відсутній в списку, але він підключений до мережі - потрібно звернутись в банк для уточнення деталей і налаштування.
Як видно з фото вище даний термінал має динамічну ip адресу 192.168.1.103
Зверніть увазу що роботу зі статичною IP адресою підтримують не всі моделі терміналів!
Мається на увазі комунікація з терміналом за допомогою USB або RS232 кабелю. Не важливо яким саме кабелем підключено термінал, в системі він завжди буде відображатись як підключений через COM.
Додатково потрібно підключити термінал до вашого пристрою USB кабелем та встановити драйвер який надасть банк. Для підключення потрібна назва COM порту на якому підключено термінал.
Для підключення через даний тип з'єднання потрібно уточнити чи надає банк можливість підключати термінали за допомогою
COM, так як не всі банки надають таку можливість.
Так як підключення по USB здійснюється через емуляцію COM порту переглянути який COM зараз має термінал можна через диспетчер пристроїв, вкладка "Порти COM і LPT" (приклад для терміналу моделі Ingenico Desk/3200). Якщо термінал відсутній в списку, але USB/COM кабель підключено до терміналу і вашого пристрою - це означає що термінал не може працювати через USB. Потрібно звернутись в банк для уточнення деталей і налаштування.
Як видно з фото вище даний термінал працює на порту COM9
Спеціальний тип підключення який доступний лише для терміналів PAX що працюють по протоколу Simpays ККМ.
Замість стандартного підключення коли касова програма підключається до терміналу, в даному випадку термінал підключається до окремого вебсерверу на комп'ютері і через цей TCP сервер відбувається комунікація.
Для налаштування терміналу на цей інтерфейс підключення потрібно повідомити банку чи підряднику на стороні банку локальну IP адресу вашого комп'ютера чи телефону та порт (порт можна обрати будь який не зайнятий на пристрої).
¶ Створення терміналу
-
Для створення терміналу як пристрою в додатку переходимо на сторінку підключення пристроїв.
За посиланням http://localhost:3939/dm/dashboard або перейти через інтерфейс ПРРО
-
Натискаємо
ДОДАТИ ПРИСТРІЙабоДОДАТИ НОВИЙ ПРИСТРІЙ
-
На першому кроці потрібно вказати, назву для терміналу (на власний розсуд, але назва терміналу має бути унікальна в розрізі всіх пристроїв включаючи ПРРО), обрати тип пристрою
Банківський терміналта натиснутиНАСТУПНИЙ КРОК
Назву терміналу наполегливо рекомендуємо вказувати без пробілів та спеціальних символів типу знаку табуляції(\t) чи лапок.
Дозволені символи в назві:
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz АБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдеёжзийклмнопрстуфхцчшщъыьэюя
ІіЇїҐґЄє
!.,";:?()_«»-/0123456789
- На кроці 2 необхідно вказати налаштування вашого терміналу.
Оберіть банк. Вкажіть банк або еквайрингову компанію яка надала вам термінал. В разі якщо потрібного банку немає в списку можна обрати “Інший банк“ і на наступному кроці обрати протокол.Оберіть протокол. Якщо у банку (наприклад у Приватбанку чи Укрсиббанку) підтримується лише термінали на одному протоколі - даного пункту не буде, якщо їх кілька - тоді з випадаючого списку потрібно обрати той який зараз використовує ваш термінал для комунікації з касою. Найменування протоколу можна дізнатись у банку.Оберіть інтерфейс підключення- потрібно обрати той тип підключення на який налаштовано термінал:
Ethernet(підключення по мережі кабелем або через Wi-Fi);
COM(підключення через USB або COM порт за допомогою кабелю)
TCP Server(Тільки для протоколу Simpays ККМ. Спеціальний спосіб підключення коли термінал з'єднується з пк, а не навпаки пк підключається до терміналу.)Комісійна винагорода еквайра (% від суми оплати)- потрібно вказати комісію яку стягує банк з кожної операції.
- Після вибору потрібного інтерфейсу потрібно вказати дані для підключення або натиснути кнопку "Пошук".
Після натиснення на кнопку Пошук або Розширений пошук DM автоматично спробує знайти ваш термінал, та заповнить всі необхідні дані, якщо пристрій доступний.
Якщо пошук не знайшов ваш термінал - спробуйте вказати дані вручну:
Якщо було обрано інтерфейс Ethernet
Потрібно вказати IP адресу терміналу в мережі. Залежно від обраного банку порт буде встановлено за замовчуванням, у випадку якщо порт терміналу відрізняється від стандартного його можна вказати через : після IP адресу, наприклад 192.168.1.103:2000
Приклад перегляду IP адреси через сайт маршрутизатора tp-link(http://tplinkwifi.net/#networkMap) для стаціонарних терміналів. Можливо також здійснити пошук ІР адресу терміналу по МАС термінала в налаштуваннях роутера. МАС адрес може бути вказано на самому терміналі або можна уточнити у банку.
Як видно з фото вище даний термінал з MAC 54-65-03-8E-FA-84 має ip адресу 192.168.1.101 яку потрібно вказати в поле IP.
Також рекомендовано закріпити за терміналом фіксовану адресу на маршрутизаторі щоб вона не змінювалась із перезавантаженням терміналу і не потрібно було вказувати нову адресу.
На різних моделях маршрутизаторів налаштування можуть відрізнятись.
Приклад встановлення налаштування через сайт маршрутизатора tp-link(http://tplinkwifi.net/#networkMap)
- З головної переходимо на вкладку
Додатково - Вибираємо пункт
Безпека, підпунктIP та MAC Прив'язка - Вмикаємо налаштування
IP та MAC Прив'язка - Шукаємо в списку пристроїв термінал та вмикаємо
Пов'язати - Знизу екрану буде відображено текст "Операція успішна"
Якщо було обрано інтерфейс COM
Потрібно вказати назву COM порту в форматі COM№ де № - номер порту та швидкість. Стандартно швидкість на терміналах встановлюється максимальна(115200), але якщо банк встановив іншу, можна її змінити.
Так як підключення по USB здійснюється через емуляцію COM порту переглянути який COM зараз має термінал можна через диспетчер пристроїв, вкладка "Порти COM і LPT" (приклад для терміналу моделі Ingenico Desk/3200). Якщо термінал відсутній в списку, але USB/COM кабель підключено до терміналу і вашого пристрою - це означає що термінал не може працювати через USB. Потрібно звернутись в банк для уточнення деталей і налаштування.
Як видно з фото вище даний термінал працює на порту COM9
- Після встановлення всіх вищевказаних налаштувань натискаєте
СТВОРИТИ
Приклад заповнення для Ethernet:
Приклад заповнення для COM:
Приклад заповнення для TCP Server:
Додавання терміналу завершено
¶ Перевірка зв'язку
Після додавання пристрою відкриється сторінка створеного терміналу
Для перевірки коректності підключення терміналу можна натиснути "Перевірити зв'язок з терміналом". Буде виконано спробу з'єднатись з терміналом.
Якщо термінал налаштовано коректно, внизу екрану відобразиться повідомлення:
Зв'язок з терміналом встановлено
У разі помилки - потрібно перевірити коректність введених даних.
Якщо перевірка зв'язку виконана успішно - налаштування завершено і термінал готовий до роботи.
¶ Робота з помилками
В даному розділі описано можливі помилки при налаштування та роботі з терміналами та способи їх вирішення.
¶ Помилки при підключення/налаштуванні терміналу
У випадку якщо термінал недоступний по IP адресу та порту:
Неможливо встановити з'єднання з терміналом по інтерфейсу Ethernet (192.168.1.103)
Помилка при з'єднанні за вказаною адресою: 192.168.1.103
В дужках буде ip адреса яка виставлена в налаштуваннях терміналу в ДМ.
Рішення: При отриманні даної помилки потрібно перевірити коректність введення IP адреси, у випадку якщо адреса коректна, але помилка повторюється - звернутись в банк для уточнення деталей.
Рішення: При отриманні даної помилки потрібно перевірити коректність введення IP адреси, для android терміналів PAX A930 та Newland N950 від Приватбанку має бути запущено Касове суміщення та обрано тип підключення WI-FI або LAN. Скоріше за все адрес або порт вказано некоректно.
Якщо все перевірено, але помилка повторюється, за деталями та вирішенням помилки рекомендовано звернутись до вашого банку
- У випадку якщо термінал доступний по IP адресу, але не готовий/не може приймати запити:
Таймаут при перевірці зв'язку з терміналом
Рішення: Дана помилка відображається лише для терміналів Приватбанку. Повертається у випадку якщо IP адресу чи порт вказано кореткно але термінал не відповідає. В такому випадку рекомендовано звернутись до банку для доналаштування терміналу.
Некоректно вказано COM порт, порт відсутній в системі або його зайняла/відкрила інша програма:
Неможливо встановити з'єднання з терміналом по інтерфейсу COM (COM4)
Неможливо відкрити СОМ порт. Порт відсутній в системі або зайнятий.
Рішення: При отриманні даної помилки потрібно перевірити коректність введення COM порту, у випадку номер порту вказано коректно, та перевірити що закрито всі програми що можуть використовувати порт на якому працює термінал (наприклад емулятор каси від Приватбанку). Для android терміналів PAX A930 та Newland N950 від Приватбанку має бути запущено Касове суміщення та обрано тип підключення USB. Також по USB може працювати лише мобільний термінал, стаціонарний роботу по USB не підтримує.
Якщо все перевірено, але помилка повторюється, за деталями та вирішенням помилки рекомендовано звернутись до вашого банку.
- У випадку якщо COM наявний в системі, але термінал не відповідає на запити:
Таймаут при перевірці зв'язку з терміналом
Рішення: Дана помилка відображається лише для терміналів Приватбанку. Повертається у випадку якщо COM порт вказано кореткно, але термінал не відповідає. В такому випадку рекомендовано звернутись до банку для доналаштування терміналу.
¶ Помилки при роботі з терміналом
Опис всіх можливих помилок можна знайти за посиланням: