¶ Загальна інформація
Перед початком налаштування потрібно отримати попередньо налаштований термінал у банку.
На терміналі банком має бути:
- Встановлено налаштування для роботи терміналу;
- Створено мерчанта по якому будуть здійснюватись транзакції по терміналу, або кілька мерчантів(за потреби);
Номер мерчанту, для подальшої роботи з терміналом, можна дізнатись в банку або через ДМ після підключення терміналу. Перевірити який номер мерчанту в терміналі можна за допомогою API або через вебінтерфейс налаштування терміналу натиснувши на кнопку "Отримати список мерчантів".
- Підключено ліцензію на користування(ключі).
- Налаштовано інтерфейс підключення(наприклад Ethernet або USB)
Якщо порт на терміналі відрізняєтсья від стандартних, його можна вказати в налаштуваннях.
Для терміналів
ОщадбанкутаБанку Востокстандартно встановлюється банком порт 2000, проте за рекомендаціями розробників протоколу для роботи з терміналами для стабільності в роботі бажано попросити у банку встановити порт2100або інший відмінний від2000.
¶ Підключення та налаштування
Для підключення потрібно обрати інтерфейс через який буде здійснюватись комунікація з банківським терміналом:
Ethernet- На терміналі банком має бути встановлено даний тип з'єднання банком. Додатково потрібно підключити термінал до мережі Ethernet кабелем. Встановлювати драйвери не потрібно.USB- На терміналі банком має бути встановлено даний тип з'єднання банком. Додатково потрібно підключити термінал до пристрою USB кабелем та встановити драйвер який надасть банк. Підключення по USB здійснюється через емуляцію в системі COM порту. Для підключення потрібна назва COM порту на якому підключено термінал.COM- На терміналі банком має бути встановлено даний тип з'єднання банком. Для підключення через даний тип з'єднання потрібно уточнити чи надає банк можливість підключати термінали за допомогоюCOM, так як наразі не всі банки надають таку можливість.
¶ Перевірка підключення терміналу
- Для роботи через Ethernet. Приклад перегляду IP адреси через сайт маршрутизатора tp-link(http://tplinkwifi.net/#networkMap). Можливо також здійснити пошук ІР адресу терміналу по
МАСтермінала в налаштуваннях роутера.МАСадрес вказано на самому терміналі.
Якщо термінал відсутній в списку але ethernet кабель підключено - це означає що термінал не може працювати через Ethernet. Потрібно звернутись в банк для уточнення деталей і налаштування.
Як видно з фото вище даний термінал має динамічну ip адресу192.168.1.103
Зверніть увазу що роботу зі статичною IP адресою підтримують не всі моделі терміналів!
- Для роботи через USB. Так як підключення по USB здійснюється через емуляцію COM порту аереглянути який COM зараз встановлено на терміналі можна через диспетчер пристроїв, вкладка "Порти COM і LPT" (приклад для терміналів Приватбанку, Ощадбанку, Укрсиббанку на моделі desk3200). Якщо термінал відсутній в списку, але USB/COM кабель підключено до терміналу і вашого пристрою - це означає що термінал не може працювати через USB. Потрібно звернутись в банк для уточнення деталей і налаштування.
Як видно з фото вище даний термінал працює на портуCOM9
¶ Створення терміналу
-
Для створення терміналу як пристрою в додатку переходимо на сторінку підключення пристроїв.
За посиланням http://localhost:3939/dm/dashboard або перейти через інтерфейс ПРРО
-
Натискаємо
ДОДАТИ ПРИСТРІЙ
-
На першому кроці потрібно вказати, назву для терміналу (на власний розсуд, але назва терміналу має бути унікальна в розрізі всіх пристроїв включаючи ПРРО), обрати тип пристрою
Банківський терміналта натиснутиНАСТУПНИЙ КРОК
Назву терміналу наполегливо рекомендуємо вказувати без пробілів та спеціальних символів типу знаку табуляції(
\t) чи лапок.
- Далі необхідно встановити налаштування для вашого терміналу.
- В пункті
Оберіть банквибираєте "Приватбанк"
- В пункті
Оберіть інтерфейс підключенняпотрібно обрати:
COM- у випадку підключення терміналу через USB або COM порт.Ethernet- у випадку підключення терміналу через мережу.
- Після вибору потрібного інтерфейсу потрібно вказати дані для підключення.
- Якщо було обрано
COM, потрібно вказати назву COM порту в форматіCOM№де № - номер порту та швидкість. Стандартно швидкість на терміналах встановлюється максимальна(115200), але якщо банк встановив іншу, можна її вказати. - Якщо було обрано
Ethernetпотрібно вказати IP адресу терміналу. Порт буде встановлено за замовчуванням залежно від обраного банку, у випадку якщо порт терміналу відрізняється від стандартного його можна вказати через:після IP адресу, наприклад192.168.1.103:2100
- Після встановлення всіх вищевказаних налаштувань натискаєте
СТВОРИТИ
- В пункті
Оберіть банквибираєте "Ощадбанк"
- В пункті
Оберіть інтерфейс підключенняпотрібно обрати:
COM- у випадку підключення терміналу через USB порт.Ethernet- у випадку підключення терміналу через мережу.
- Після вибору потрібного інтерфейсу потрібно вказати дані для підключення.
- Якщо було обрано
COM, потрібно вказати назву COM порту в форматіCOM№де № - номер порту та швидкість. Стандартно швидкість на терміналах встановлюється максимальна(115200), але якщо банк встановив іншу, можна її вказати. - Якщо було обрано
Ethernetпотрібно вказати IP адресу терміналу. Порт буде встановлено за замовчуванням залежно від обраного банку, у випадку якщо порт терміналу відрізняється від стандартного його можна вказати через:після IP адресу, наприклад192.168.1.103:2100
- Після встановлення всіх вищевказаних налаштувань натискаєте
СТВОРИТИ
- В пункті
Оберіть банквибираєте "Райффайзенбанк"
- В пункті
Оберіть інтерфейс підключенняпотрібно обрати:
COM- у випадку підключення терміналу через USB або COM порт.Ethernet- у випадку підключення терміналу через мережу.
- Після вибору потрібного інтерфейсу потрібно вказати дані для підключення.
- Якщо було обрано
COM, потрібно вказати назву COM порту в форматіCOM№де № - номер порту та швидкість. Швидкість роботи COM порту можна залишити 115200. - Якщо було обрано
Ethernetпотрібно вказати IP адресу терміналу. Порт буде встановлено за замовчуванням залежно від обраного банку, у випадку якщо порт терміналу відрізняється від стандартного його можна вказати через:після IP адресу, наприклад192.168.1.103:2100
- Після встановлення всіх вищевказаних налаштувань натискаєте
СТВОРИТИ
- В пункті
Оберіть банквибираєте "Укрсиббанк"
- В пункті
Оберіть інтерфейс підключенняпотрібно обрати:
COM- у випадку підключення терміналу через USB порт.Ethernet- у випадку підключення терміналу через мережу.
- Після вибору потрібного інтерфейсу потрібно вказати дані для підключення.
- Якщо було обрано
COM, потрібно вказати назву COM порту в форматіCOM№де № - номер порту та швидкість. Стандартно швидкість на терміналах встановлюється максимальна(115200), але якщо банк встановив іншу, можна її вказати. - Якщо було обрано
Ethernetпотрібно вказати IP адресу терміналу. Порт буде встановлено за замовчуванням залежно від обраного банку, у випадку якщо порт терміналу відрізняється від стандартного його можна вказати через:після IP адресу, наприклад192.168.1.103:2100
- Після встановлення всіх вищевказаних налаштувань натискаєте
СТВОРИТИ
- В пункті
Оберіть банквибираєте "Банк Восток"
- В пункті
Оберіть інтерфейс підключенняпотрібно обрати:
COM- у випадку підключення терміналу через USB порт.Ethernet- у випадку підключення терміналу через мережу.
- Після вибору потрібного інтерфейсу потрібно вказати дані для підключення.
- Якщо було обрано
COM, потрібно вказати назву COM порту в форматіCOM№де № - номер порту та швидкість. Стандартно швидкість на терміналах встановлюється максимальна(115200), але якщо банк встановив іншу, можна її вказати. - Якщо було обрано
Ethernetпотрібно вказати IP адресу терміналу. Порт буде встановлено за замовчуванням залежно від обраного банку, у випадку якщо порт терміналу відрізняється від стандартного його можна вказати через:після IP адресу, наприклад192.168.1.103:2100
- Після встановлення всіх вищевказаних налаштувань натискаєте
СТВОРИТИ
- Після додавання пристрою відкриється сторінка створеного терміналу
- Для перевірки коректності підключення терміналу можна натиснути "Перевірити зв'язок з терміналом". Буде виконано спробу з'єднатись з терміналом.
Якщо термінал налаштовано коректно, внизу екрану відобразиться повідомлення:
Зв'язок з терміналом встановлено
У разі помилки - потрібно перевірити коректність введених даних.
Якщо перевірка зв'язку виконана успішно - налаштування завершено і термінал готовий до роботи.
¶ Робота з помилками
В даному розділі описано можливі помилки при налаштування та роботі з терміналами та способи їх вирішення.
¶ Помилки при підключення/налаштуванні терміналу
Помилка підключення по ip адресу та порту або помилка отримання відповіді від терміналу:
Ощадбанк,Укрсиббанк,Райффайзенбанк,Банк Восток
Неможливо встановити з'єднання з терміналом по інтерфейсу Ethernet (192.168.1.103)
В дужках буде ip адреса яка виставлена в налаштуваннях терміналу в ДМ.
Рішення: При отриманні даної помилки потрібно перевірити коректність введення IP адреси, у випадку якщо адреса коректна, але помилка повторюється - звернутись в банк для уточнення деталей.
Приватбанк
Так як у випадку роботи з терміналами Приватбанку бібліотека знаходиться в терміналі, помилки будуть відрізнятись:
- У випадку якщо термінал недоступний по IP адресу та порту:
Помилка при з'єднанні за вказаною адресою: 192.168.1.103
Буде ip адреса яка виставлена в налаштуваннях терміналу в ДМ.
Рішення: При отриманні даної помилки потрібно перевірити коректність введення IP адреси, для android терміналів PAX A930 має бути запущено Касове суміщення та обрано тип підключення WI-FI або LAN. Скоріше за все адрес або порт вказано некоректно.
Якщо все перевірено, але помилка повторюється, за деталями та вирішенням помилки рекомендовано звернутись в Приватбанк.
- У випадку якщо термінал доступний по IP адресу, але не готовий/не може приймати запити або зайнятий виконанням іншого запиту:
Таймаут при перевірці зв'язку з терміналом
Рішення: При отриманні даної помилки потрібно перевірити щоб на терміналі відображалось не меню а саме головний екран і щоб термінал не виконував інших оплат/запитів, для android терміналів PAX A930 має бути запущено Касове суміщення та обрано тип підключення WI-FI або LAN.
Якщо все перевірено, але помилка повторюється, за деталями та вирішенням помилки рекомендовано звернутись в Приватбанк.
Некоректно вказано COM порт або порт відсутній в системі:
Ощадбанк,Укрсиббанк,Райффайзенбанк,Банк Восток
Неможливо встановити з'єднання з терміналом по інтерфейсу COM (COM4)
В дужках буде назва COM порту яка виставлена в налаштуваннях терміналу в ДМ.
Рішення: При отриманні даної помилки потрібно перевірити коректність введення COM порту, у випадку номер порту вказано коректно, але помилка повторюється - звернутись в банк для уточнення деталей.
Приватбанк
Так як у випадку роботи з терміналами Приватбанку бібліотека знаходиться в терміналі, помилки будуть відрізнятись:
- У випадку якщо COM порт відсутній в системі або порт зайняла/відкрила інша програма:
Неможливо відкрити СОМ порт. Порт відсутній в системі або зайнятий.
Рішення: При отриманні даної помилки потрібно перевірити коректність введення COM порту та перевірити що закрито всі програми що можуть використовувати порт на якому працює термінал (наприклад емулятор каси від Приватбанку). для android терміналів PAX A930 має бути запущено Касове суміщення та обрано тип підключення USB. Також по USB може працювати лише мобільний термінал. Стаціонарний роботу по USB не підтримує.
Якщо все перевірено, але помилка повторюється, за деталями та вирішенням помилки рекомендовано звернутись в Приватбанк.
- У випадку якщо COM наявний в системі але термінал не відповідає на запити:
Таймаут при перевірці зв'язку з терміналом
Рішення: При отриманні даної помилки потрібно перевірити щоб на терміналі відображалось не меню а саме головний екран і щоб термінал не виконував інших оплат/запитів, для android терміналів PAX A930 має бути запущено Касове суміщення та обрано тип підключення USB. Також по USB може працювати лише мобільний термінал. Стаціонарний роботу по USB не підтримує.
Якщо все перевірено, але помилка повторюється, за деталями та вирішенням помилки рекомендовано звернутись в Приватбанк.
¶ Помилки при роботі з терміналом
Опис всіх можливих помилок можна знайти за посиланням: