¶ Загальна інформація перед початком налаштування
Для того щоб мати можливість прийняти оплату від клієнта банківською карткою за допомогою терміналу необіхдно отримати попередньо налаштований термінал у Приват банку, підключити даний термінал до застосунку Device Manager (далі ДМ) та встановити налаштування.
Підтримуються всі термінали Приватбанку що налаштовані на роботу з JSON протоколом, тому можна обрати будь яку модель із запропонованих Приватбанком на вибір. При підключенні терміналу може бути незначна різниця в налаштуваннях залежно від моделі.
Після підключення терміналу до застосунку можна проводити розрахунок з покупцями формуючи чеки як через вебкабінет Вчасно.Каса так і з вашої облікової системи яка уже працює з ПРРО Вчасно.Каса.
Для підключення потрібно обрати інтерфейс через який банківський термінал зможе отримувати інформацію для проведення розрахунків:
- По мережі (
Ethernet/wi-fi) - На терміналі банком має бути встановлено даний тип з'єднання. Додатково потрібно підключити термінал до маршрутизатора Ethernet кабелем, якщо термінал має відповідний порт, або підключити термінал до мережі wi-fi якщо термінал дозволяє підключення по wi-fi. USB- На терміналі банком має бути встановлено даний тип з'єднання.
Додатково потрібно підключити термінал до пристрою USB кабелем. Підключення по USB здійснюється через емуляцію в системі COM порту. Для підключення потрібна назва COM порту на якому підключено термінал.COM- На терміналі банком має бути встановлено даний тип з'єднання. Додатково потрібно підключити термінал до пристрою через кабель RS232.
За потреби банк може налаштувати на терміналі кілька торгівців (мерчантів). Тобто через один фізичний термінал можна проводити розрахунки по кількох ФОП або юр. особах.
Device Manager підтримує таку можливість роботи.
¶ Налаштування Android терміналу PAX A930
- Приватбанк надає на вибір (або за наявності) 2 типи терміналу
PAX A930
- Стаціонарний: Не має вбудованої батареї, працює тільки від живлення по мережі. Є можливість підключити за допомогою інтерфейсу
Ethernetтобто через кабель до маршрутизатора, або поWI-FI. ПоUSBданий тип терміналу не підключаєтсья. - Мобільний: Має вбудовану батарею та може працювати від живлення по мережі. Даний термінал можна підключати по
WI-FIабо поUSBза допомогоюUSB Type-Cкабелю.
- Для того щоб мати можливість підключити android термінал Приватбанку
PAX A930стаціонарної чи мобільної моделі необхідно налаштувати термінал на роботу з касовим суміщенням.
Це допоможуть зробити спеціалісти Приватбанку за зверненням, якщо на терміналі відсутній додатокКасове суміщення
Після встановлення налаштувань банком потрібно запуститиХ-балансна головному екрані терміналу, після чого з'явиться додатокКасове суміщення
¶ Налаштування касового суміщення
Якщо додаток Касове суміщення зявився на терміналі або, був доступним від початку, можна виконати підключення терміналу по потрібному інтерфейсу.
Інтерфейс на терміналі може відрізнятись від прикладів на фото залежно від того як термінал налаштує Приватбанк
Рекомендовано обрати саме WI-FI підключення так як цей спосіб найпростіший в налаштуванні і подальшій роботі.
-
Для підключення по
WI-FIпершочергово потрібно підключити термінал до мережі WI-FI, для цього потрібно відкрити панель сповіщень на терміналі, натиснути і потримати 1 секунду на значкуWI-FIпісля чого обрати вашу мережу і ввести пароль.
Приклад:
-
Наступним кроком натискаєте на значок "Налаштування" на цій же сторінці після підключення до мережі
WI-FI -
Буде відкрито сторінку додаткових налаштувань
WI-FI. тут же і буде ip адреса терміналу яка потрібна для підключення.
- Далі необхідно запустити додаток
Касове суміщеннята обратиWIFI підключення
- Після даних кроків на терміналі буде відображено наступну інформацію. Термінал можна підключати в додаток для роботи.
Важливо! Для того щоб термінал міг приймати запити на оплату має бути відкрито саме це вікно на терміналі та екран терміналу має бути увімкненим.
-
Для підключення по
USBпотрібно підключити термінал до пристроюUSB Type-Cкабелем. -
Після підключення необхідно запустити додаток
Касове суміщеннята обратиUSB підключення
-
Після даних кроків на терміналі буде відображено наступну інформацію. Термінал можна підключати в додаток для роботи.
Важливо! Для того щоб термінал міг приймати запити на оплату має бути відкрито саме це вікно на терміналі та екран терміналу має бути увімкненим.
-
Для підключення по
Ethernetпершочергово потрібно підключити термінал до маршрутизаора за допомогою кабелю. -
Після підключення необхідно запустити додаток
Касове суміщеннята обратиLAN підключення
-
Далі залежно від того чи потрібно налаштувати на терміналі статичний IP адрес потрібно або ввети необхідні дані в поля для присвоєння IP для терміналу або натиснути "DHCP", в такому випадку термінал отримає мережеві налаштування автоматично і буде готовий для підключення. Рекомендовано сае обрати
DHCP
-
Після даних кроків на терміналі буде відображено наступну інформацію. Термінал можна підключати в додаток для роботи.
Важливо! Для того щоб термінал міг приймати запити на оплату має бути відкрито саме це вікно на терміналі та екран терміналу має бути увімкненим.
¶ Підключення терміналу в додаток
-
Для створення терміналу як пристрою в додатку переходимо на сторінку підключення пристроїв.
За посиланням http://localhost:3939/dm/dashboard або можна перейти через інтерфейс ПРРО
-
Натискаємо
ДОДАТИ ПРИСТРІЙабоДОДАТИ НОВИЙ ПРИСТРІЙ
-
На першому кроці потрібно вказати, назву для терміналу (на власний розсуд, але назва терміналу має бути унікальна в розрізі всіх пристроїв включаючи створені ПРРО), обрати тип пристрою
Банківський терміналта натиснутиНАСТУПНИЙ КРОК
Назву терміналу наполегливо рекомендуємо вказувати без пробілів та спеціальних символів типу знаку табуляції(
\t) чи лапок.
- Далі необхідно встановити налаштування для вашого терміналу.
- В пункті
Оберіть банквибираєте "Приватбанк"
- В пункті
Оберіть інтерфейс підключенняпотрібно обрати:
Ethernet- у випадку підключення терміналу через мережу.COM- у випадку підключення терміналу через USB або COM порт.
- Після вибору потрібного інтерфейсу потрібно вказати дані для підключення, або натиснути кнопку "Пошук".
Після натиснення на кнопку"Пошук"або"Розширений пошук"додаток автоматично спробує знайти ваш термінал, та заповнить всі необхідні дані, якщо пристрій доступний.
Якщо пошук не знайшов ваш термінал - спробуйте вказати дані вручну:
Якщо було обрано інтерфейс Ethernet
Потрібно вказати IP адресу терміналу. Порт буде встановлено за замовчуванням 2000, у випадку якщо порт терміналу відрізняється від стандартного його можна вказати через : після IP адресу, наприклад 192.168.1.103:2100
Приклад перегляду IP адреси через сайт маршрутизатора tp-link(http://tplinkwifi.net/#networkMap) для стаціонарних терміналів. Можливо також здійснити пошук ІР адресу терміналу по МАС термінала в налаштуваннях роутера. МАС адрес може бути вказано на самому терміналі або можна уточнити у банку.
Якщо термінал відсутній в списку але ethernet кабель підключено - це означає що термінал не може працювати через Ethernet. Потрібно звернутись в банк для уточнення деталей і налаштування.
Як видно з фото вище даний термінал з MAC 54-F1-40-66-92-F2 має ip адресу 192.168.1.103 яку потрібно вказати в додатку.
Якщо було обрано інтерфейс COM
Потрібно вказати назву COM порту в форматі COM№ де № - номер порту та швидкість. Стандартно швидкість на терміналах встановлюється максимальна(115200), але якщо банк встановив іншу, можна її змінити.
Так як підключення по USB здійснюється через емуляцію COM порту аереглянути який COM зараз встановлено на терміналі можна через диспетчер пристроїв, вкладка "Порти COM і LPT" (приклад для терміналів Приватбанку моделі ingenico desk3200).
Якщо термінал відсутній в списку, але USB/COM кабель підключено до терміналу і вашого пристрою - це означає що термінал не може працювати через USB. Потрібно звернутись в банк для уточнення деталей і налаштування.
Як видно з фото вище даний термінал працює на порту COM9
- Після заповнення всіх вищевказаних полів натискаєте
СТВОРИТИ
Приклад заповнення для Ethernet:
Приклад заповнення для COM:
¶ Перевірка роботи терміналу
- Після створення терміналу відобразиться сторінка його налаштування.
Важливо!
Якщо у вас термінал Verifone лінійки VX (наприклад Verifone VX520) потрібно відкрити пункт Додаткові налаштування терміналу та увімкнути перемикач Очікування опрацювання терміналом попереднього запиту перед наступним.
Термінал повільно опрацьовує запити тому це налаштування підлаштує коректну роботу саме для таких терміналів.
Для терміналів інших моделей дане налаштування встанолювати не потрібно.
- Для перевірки коректності підключення терміналу можна натиснути "Перевірити зв'язок з терміналом". Буде виконано спробу з'єднатись з терміналом.
Якщо термінал налаштовано коректно, внизу екрану відобразиться повідомлення:
Зв'язок з терміналом встановлено
У разі помилки - потрібно перевірити коректність введених даних.
Якщо перевірка зв'язку виконана успішно - налаштування завершено і термінал готовий до роботи.
¶ Підключення до облікової системи
Після завершення налаштування терміналу в додатку можна підключити його для роботи:
- Якщо фіскалізація чеків здійснюється через вебкабінет Вчасно.Каса інформацію по його підключенню можна знайти за посиланням (
Крок 3. Синхронізація терміналу з кабінетом Вчасно Каса):
- Якщо фіскалізація чеків здійснюється через вашу облікову систему доступно 2 способи для роботи залежно від того як налаштована взаємодія розробниками облікової системи.
Через пакетний режим (підключення терміналу до 1С або до іншої облікової системи):
Інтеграція з терміналами через API: В даному випадку потрібно уточнити в розробників облікової системи які налаштування потрібно виконати.
¶ Робота з помилками
В даному розділі описано можливі помилки при налаштування та роботі з терміналами Приватбанку та способи їх вирішення.
¶ Помилки при підключення/налаштуванні терміналу
- У випадку якщо термінал недоступний по IP адресу та порту:
Помилка при з'єднанні за вказаною адресою: 192.168.1.103
Буде ip адреса яка виставлена в налаштуваннях терміналу в ДМ.
Рішення: При отриманні даної помилки потрібно перевірити коректність введення IP адреси, для android терміналів PAX A930 має бути запущено Касове суміщення та обрано тип підключення WI-FI або LAN. Скоріше за все адрес або порт вказано некоректно.
Якщо все перевірено, але помилка повторюється, за деталями та вирішенням помилки рекомендовано звернутись в Приватбанк.
- У випадку якщо термінал доступний по IP адресу, але не готовий/не може приймати запити або зайнятий виконанням іншого запиту:
Таймаут при перевірці зв'язку з терміналом
Рішення: При отриманні даної помилки потрібно перевірити щоб на терміналі відображалось не меню а саме головний екран і щоб термінал не виконував інших оплат/запитів, для android терміналів PAX A930 має бути запущено Касове суміщення та обрано тип підключення WI-FI або LAN.
Якщо все перевірено, але помилка повторюється, за деталями та вирішенням помилки рекомендовано звернутись в Приватбанк.
- У випадку якщо COM порт відсутній в системі або порт зайняла/відкрила інша програма:
Неможливо відкрити СОМ порт. Порт відсутній в системі або зайнятий.
Рішення: При отриманні даної помилки потрібно перевірити коректність введення COM порту та перевірити що закрито всі програми що можуть використовувати порт на якому працює термінал (наприклад емулятор каси від Приватбанку). Для android терміналів PAX A930 має бути запущено Касове суміщення та обрано тип підключення USB. Також по USB може працювати лише мобільний термінал. Стаціонарний роботу по USB не підтримує.
Якщо все перевірено, але помилка повторюється, за деталями та вирішенням помилки рекомендовано звернутись в Приватбанк.
- У випадку якщо COM наявний в системі але термінал не відповідає на запити:
Таймаут при перевірці зв'язку з терміналом
Рішення: При отриманні даної помилки потрібно перевірити щоб на терміналі відображалось не меню а саме головний екран і щоб термінал не виконував інших оплат/запитів, для android терміналів PAX A930 має бути запущено Касове суміщення та обрано тип підключення USB. Також по USB може працювати лише мобільний термінал. Стаціонарний роботу по USB не підтримує.
Якщо все перевірено, але помилка повторюється, за деталями та вирішенням помилки рекомендовано звернутись в Приватбанк.
¶ Помилки при проведенні операцій на терміналі
Опис всіх можливих помилок можна знайти за посиланням: