Тип підключення:

➢USB/COM (Мал. 2):

•Номер СОМ-порту – номер СОМ-порту, до якого підключений банківський термінал;

•Швидкість СОМ-порту - зі списку вибрати необхідну швидкість;

•Таймаут – час очікування відповіді (мс).

➢Ethernet (Мал. 3):

•IP-адреса;

•Порт.

Мал. 3 (Версія програми  2022.0.5)

Загальні налаштування (незалежно від типу підключення):

•Використовувати підтвердження каси - перемикач повинен бути увімкнений, якщо термінал налаштований на роботу з протоколом, що вимагає підтвердження від каси;

•Ігнорувати підтвердження каси - доступний, якщо увімкнено перший. Рекомендується включати, якщо робота з Торгсофт здійснюється через RDP (у таких випадках, якщо не включено параметр "Ігнорувати підтвердження каси", оплата може проходити через термінал, але не проходити через Торгсофт).

Після заповнення всіх параметрів натискаємо Записати .

По натисканню на кнопку Отримати інформація про банківський термінал відображається інформаційне повідомлення зі списком мерчантів терміналу (термінал має бути підключений та включений до мережі).

Нижче таблиця Мерчант банківського терміналу містить список мерчантів, за якими виконуватимуться операції з використанням конкретного терміналу. Натиснувши кнопку Додати відкриється вікно Мерчант банківського терміналу (Мал. 4).

Мал. 4 (Версія програми  2022.0.5)

Заповнюються такі параметри:

•Номер мерчанта (при створенні нового мерчанта, якщо не було вказано номер мерчанта, йому автоматично буде надано значення 0. Встановлення мерчанта в 0 може бути необхідно в тому випадку, якщо під час роботи з терміналом виникає помилка "Карта не обслуговується").

•Розрахунковий рахунок - потрібно вказати розрахунковий рахунок, на який при проведенні оплати (повернення) система автоматично виконуватиме операцію на банківському терміналі;

•Опис мерчанта - служить для ідентифікації потрібного мерчанта при його виборі (якщо для одного розрахункового рахунку налаштовано кілька мерчантів для одного типу операцій, наприклад оплати - при оплаті на такий розрахунковий рахунок буде запропоновано список мерчантів, доступних для оплати для вибору);

•Найменування мерчанта – код мерчанта, зареєстрованого на терміналі. Список мерчантів можна отримати за допомогою дії Отримати інформацію про термінал у таблиці Банківський термінал. При цьому найменування мерчанта потрібно для автоматичного визначення номера мерчанта, якщо увімкнено параметр Автовизначення мерчанта.

•Тип операції - тип операції, який виконується з використанням цього мерчанта:

oОплата;

oПовернення;

oОплата/Повернення - вибирається у разі, якщо операції повернення і оплати виконуються з допомогою одного мерчанта і передбачає використання сервісів.

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

ВАЖЛИВО! Якщо вмикається параметр Автовизначення номера мерчанта, то має бути вказано найменування мерчанта, яке реально існує для даного терміналу, яке можна отримати, скориставшись дією Отримати інформацію про термінал.

•Використовувати сервіс - повинен бути увімкнений, якщо операція виконується за допомогою сервісу (наприклад, повернення для терміналів Приватбанку);

•Попереднє читання картки під час повернення відображається для типу операції Повернення або Оплата/повернення (за замовчуванням увімкнено). Якщо налаштування вимкнено, то при поверненні через банківський термінал попереднє читання картки виконуватись не буде. У цьому випадку перевірка відповідності картки, якою було оплачено товар, карті, на яку виконується повернення, виконуватиметься в момент повернення самим терміналом. Вимкнути це налаштування рекомендується в тих випадках, коли з будь-якої причини попереднє читання картки банківським терміналом призводить до помилки, через яку неможливо виконати повернення.

•Параметри сервісу - якщо операція з мерчантом виконується з використанням сервісу, повинні бути вказані параметри. Зазвичай це рядкове значення. Якщо це операція повернення, рядок параметрів сервісу обов'язково повинен містити комбінацію символів "RRN"

Приклад настройки мерчантів для терміналів ПриватБанку:

Приклад настройки терміналу іншого банку: (наприклад, Ощадбанку)

Номер мерчанта: 1

Опис мерчанта: довільний текст

Тип операції: оплата / повернення

Використовувати сервіс - вимкнено

Автовизначення номеру мерчанту - вимкнено

Технологія підключення банківського терміналу за протоколом WebSoket/JSON використовується для підключення терміналів PAX і Verifon, але також можна працювати з терміналами Ingenico (Мал. 5).

Мал. 5 (Версія програми  2022.0.5)

•IP хоста - IP комп'ютера, на якому запущено WebSocket сервер;

•Порт - 3000;

•Таймаут - час очікування відповіді (мс).

Підключення терміналів PAX по COM/USB виконується за допомогою спеціального кабелю, що надається банком (звичайний USB<->miniUSB для цієї мети не підходить. Роз'єм miniUSB терміналу є службовим і не призначений для підключення терміналу до ПК). Також слід встановити драйвер перехідник СОМ_USB для PAX. Для терміналів типу Ingenico підключення COM/USB виконується за допомогою звичайного кабелю, аналогічно тому, як це робиться для протоколу BPOS. Номер COM-порту визначається автоматично та його не потрібно вказувати.

Нижче таблиця Мерчант (операція) банківського терміналу містить список мерчантів, за якими виконуватимуться операції з використанням конкретного терміналу. Натиснувши кнопку Додати відкриється вікно Мерчант банківського термінала (Мал. 6).

Мал. 6 (Версія програми  2022.0.5)

Заповнюються такі параметри:

•Номер мерчанта слід вказувати Порядковий номер мерчанта = 0

•Розрахунковий рахунок - потрібно вказати розрахунковий рахунок, на який при проведенні оплати (повернення) система автоматично виконуватиме операцію на банківському терміналі;

•Опис мерчанта - служить для ідентифікації потрібного мерчанта при його виборі (якщо для одного розрахункового рахунку налаштовано кілька мерчантів для одного типу операцій, наприклад оплати - при оплаті на такий розрахунковий рахунок буде запропоновано список мерчантів, доступних для оплати для вибору);

•Тип операції - Оплата/повернення незалежно від того, під яким номером цей мерчант відображається в терміналі.

Для терміналів, що працюють за протоколом WebSocket, не підтримується автовизначення номера мерчанта та робота з сервісами.

•Попереднє читання картки під час повернення відображається для типу операції Повернення або Оплата/повернення (за замовчуванням увімкнено). Якщо налаштування вимкнено, то при поверненні через банківський термінал попереднє читання картки виконуватись не буде. У цьому випадку перевірка відповідності картки, якою було оплачено товар, карті, на яку виконується повернення, виконуватиметься в момент повернення самим терміналом. Вимкнути це налаштування рекомендується в тих випадках, коли з будь-якої причини попереднє читання картки банківським терміналом призводить до помилки, через яку неможливо виконати повернення.

При виконанні операцій Отримання інформації щодо банківського терміналу, Оплата та Повернення здійснюється логування. Лог являє собою інформацію, яка зберігається у файлі "trace.log" (не виключено, що назва може бути іншою), що зберігається в каталозі здійснюваного файлу WebSocket сервера (наприклад, genericDriverJsonUSB.exe). Лог пишеться в байтовому форматі. Можна конвертувати онлайн-конвертором за посиланням. Логування може допомогти при виявленні помилок, що виникають під час операції на банківському терміналі, при зверненні до банку.

Для підключення терміналу за цим протоколом потрібно, щоб на комп'ютері (локальному, до якого підключений термінал, або на сервері) було встановлено драйвер відповідного терміналу, а також програмне забезпечення ARCUS. Тип підключення (COM/USB або Ethernet) у цьому випадку не має значення. Особливістю підключення терміналів за цим протоколом є те, що параметри підключення прописуються в спеціальних файлах ini.

Необхідно вибрати Тип банківського терміналу, вибрати Версію протоколу Arcus (2.0 або 2.1), вказати Робочий каталог та заповнити поле Ім'я файлу чека (Мал. 7).

Мал. 7 (Версія програми  2022.0.5)

Також потрібно вибрати Ідентифікатор транзакції (RRN або Номер чека). Якщо в якості ідентифікатора транзакції вибрано RRN, то в таблиці Фінансовий документ у полі RRN зберігатиметься RRN транзакції, інакше - Номер чека. Якщо було збережено RRN, то виконати повернення за номером чека буде неможливо і навпаки. Вибір ідентифікатора транзакції визначається параметрами налаштування терміналу, зокрема, доступна на ньому функція повернення товару чи ні.

Нижче таблиця Мерчант банківського терміналу містить список мерчантів, за якими виконуватимуться операції з використанням конкретного терміналу. Натиснувши кнопку Додати відкриється вікно Операція банківського терміналу (Мал. 8).

Мал. 8 (Версія програми  2022.0.5)

Заповнюються такі параметри:

•Код операції;

•Розрахунковий рахунок - потрібно вказати розрахунковий рахунок, на який при проведенні оплати (повернення) система автоматично виконуватиме операцію на банківському терміналі;

•Опис операції - служить для ідентифікації необхідної операції під час вибору;

•Тип операції:

oОплата;

oПовернення;

oОплата/Повернення.

Налаштування Використовувати CommandLineTool. Якщо цей перемикач включений, то взаємодія з терміналом виконується через утиліту командного рядка CommandLineTool.exe, яка входить до складу програмного забезпечення Arcus. Інакше взаємодія виконується за допомогою функцій бібліотеки Arccom.dll.

Для терміналів з протоколом ARCUS доступна дія Операції банківського терміналу (Мал. 9).

Мал. 9 (Версія програми  2022.0.5)

Натисканням кнопки відкривається однойменне вікно (Мал. 10), де можна сформувати список операцій, які можуть викликатися для даного терміналу з Торгсофт крім операцій Оплата та Повернення.

Мал. 10 (Версія програми  2022.0.5)

Для додання операції тиснемо Додати та заповнюємо поля Код операції та Найменування операції. Код операції можна взяти з файлу ops.ini із папки встановленого програмного забезпечення ARCUS. Там знаходиться і найменування операції.

•Використовувати CommandLineTool - якщо увімкнено цей перемикач, то взаємодія з терміналом виконується через утиліту командного рядка CommandLineTool.exe, яка входить до складу програмного забезпечення Arcus. Інакше взаємодія виконується за допомогою функцій бібліотеки Arccom.dll.

•Передавати код валюти - якщо увімкнено цей перемикач, то при виконанні операції на термінал буде передано код національної валюти з довідника Валюта.

•Запитувати суму - якщо увімкнено, то при виконанні операції відображатиметься вікно із запитом на введення суми, яка буде передана на термінал.

•Запитувати RRN/Номер чека - якщо увімкнено, то при виконанні операції відображатиметься вікно із запитом на введення RRN або номери чека, які будуть передані на термінал.

Виконати будь-яку з цих операцій можна двома способами:

1. У списку банківських терміналів виділити потрібний термінал. Викликати дію Операції банківського терміналу (Мал. 9) та у формі Операції банківського терміналу, що відкрилася, виділити потрібну операцію і натиснути Виконати операцію (Мал. 11).

Мал. 11 (Версія програми  2022.0.5)

2. На формі Реалізація перейти в Додаткові дії та вибрати Банківський термінал (Мал. 12).

Мал. 12 (Версія програми  2022.0.5)

Варто зазначити, що для виконання дії Отримати інформацію про термінал для терміналів за протоколом ARCUS необхідно ввести код відповідної операції з файлу ops.ini.

Важливо! У довіднику Валюта має бути визначена національна валюта та заповнений відповідний їй цифровий код

Необхідно вибрати Тип банківського терміналу (Мал. 13):

•Verifone (РайффайзенБанк Аваль);

•Verifone (АльфаБанк).

Підключення терміналу можливе як за COM/USB так і за Ethernet (для терміналів Verifone Альфа-банку порт за замовчуванням 5001). При використанні з'єднання COM/USB при установці драйвера за замовчуванням термінал підключається на порт COM9. Підключення термінала Verifone через COM/USB виконується за допомогою звичайного USB/miniUSB кабелю.

Мал. 13 (Версія програми  2022.0.5)

Поля Таймаут та Робочий каталог є обов'язковими для заповнення.

Нижче таблиця Мерчант банківського терміналу містить список мерчантів, за якими виконуватимуться операції з використанням конкретного терміналу. Натиснувши кнопку Додати відкриється вікно Операція банківського терміналу (Мал. 14).

Мал. 14 (Версія програми  2022.0.5)

Потрібно вказати Розрахунковий рахунок, Опис операції. Тип операції за замовчуванням Оплата_Повернення.

Попереднє читання картки під час повернення відображається для типу операції Повернення або Оплата/повернення (за замовчуванням увімкнено). Якщо налаштування вимкнено, то при поверненні через банківський термінал попереднє читання картки виконуватись не буде. У цьому випадку перевірка відповідності картки, якою було оплачено товар, карті, на яку виконується повернення, виконуватиметься в момент повернення самим терміналом. Вимкнути це налаштування рекомендується в тих випадках, коли з будь-якої причини попереднє читання картки банківським терміналом призводить до помилки, через яку неможливо виконати повернення.

Для терміналів з протоколом PosApi доступна дія Операції банківського терміналу (Мал. 9).

За натисканням на кнопку відкривається однойменне вікно (Мал. 15), де можна сформувати список операцій, які можуть викликатися для даного терміналу з Торгсофт крім операцій Оплата_Повернення.

Мал. 15 (Версія програми  2022.0.5)

Важливо! В довіднику Валюта (Налаштування - Валюта) має бути визначена національна валюта та заповнений відповідний їй цифровий код. Для валюти "Гривня" це 980 (Мал. 16).

Мал. 16 (Версія програми  2022.0.5)

Технологія підключення банківського терміналу за протоколом UPOS використовується підключення терміналів Ощадбанку РФ. Для підключення терміналу за цим протоколом потрібно, щоб на локальному комп'ютері (до якого підключений термінал) було встановлено відповідний драйвер, а на комп'ютері з Торгсофт мають бути файли бібліотеки, зокрема SBRF.dll. Драйвери та бібліотеки надаються банком.

Необхідно вибрати Тип банківського терміналу та зберегти на кнопці Записати (Мал. 17).

Мал. 17 (Версія програми  2020.2.0)

Нижче таблиця Мерчант банківського терміналу містить список мерчантів, за якими виконуватимуться операції з використанням конкретного терміналу. Натиснувши кнопку Додати відкриється вікно Операція банківського терміналу (Мал. 18).

Мал. 18 (Версія програми  2022.0.5)

Заповнюються такі параметри:

•Код операції - можна дізнатися у банку або в документації з підключення банківського терміналу. Номер операції «Оплата» має бути встановлений у 4000, «Повернення» – 4002. Тип операції Оплата_Повернення» не підтримується. У разі потреби можуть бути додані додаткові операції до списку операцій для банківського терміналу. Для цього потрібно знати код відповідної операції (цю інформацію можна отримати у банку).

•Розрахунковий рахунок - потрібно вказати розрахунковий рахунок, на який при проведенні оплати (повернення) система автоматично виконуватиме операцію на банківському терміналі;

•Опис операції - служить для ідентифікації необхідної операції під час виборів;

•Тип операції:

oОплата;

oПовернення;

oОплата/Повернення - для цього типу не підтримується.

•Попереднє читання картки під час повернення відображається для типу операції Повернення або Оплата/повернення (за замовчуванням увімкнено). Якщо налаштування вимкнено, то при поверненні через банківський термінал попереднє читання картки виконуватись не буде. У цьому випадку перевірка відповідності картки, якою було оплачено товар, карті, на яку виконується повернення, виконуватиметься в момент повернення самим терміналом. Вимкнути це налаштування рекомендується в тих випадках, коли з будь-якої причини попереднє читання картки банківським терміналом призводить до помилки, через яку неможливо виконати повернення.

Для терміналів з протоколом UPOS доступна дія Операції банківського терміналу (Мал. 9). Аналогічно банківським терміналам, підключеним за протоколом ARCUS. Детальніше див. Мал. 10

З цим протоколом працюють термінали банків: Міжнародний резервний банк, АЙБОКС БАНК, АЛЬФА-БАНК (лише термінали PAX), МЕГАБАНК, ПРАВЕКС БАНК , Укрексімбанк , ОТП БАНК.  

Для підключення терміналу за цим протоколом потрібно, щоб на локальному комп'ютері (до якого підключений термінал) було встановлено відповідний драйвер, а на комп'ютері з Торгсофт має бути файл бібліотеки InpasEcrCom.dll. Драйвера та бібліотеки надаються банком. Також банком надається емулятор каси, за допомогою якого можна протестувати підключення та роботу терміналу. Бібліотека має бути зареєстрована, для чого в комплекті постачання має бути файл RegEcrCom.bat. Файл повинен знаходитися в тій же папці, що бібліотека.

Довідка. Щоб зареєструвати СОМ-об'єкт для WIN OS (для реєстрації) – у файлі RegEcrCom.bat розробник рекомендує замість %SystemRoot% прописати явний шлях

Приклад:

C:\Windows\Microsoft.NET\Framework\v4.0.30319\regasm C:\InpasEcrCom\InpasEcrCom.dll

/tlb:C:\InpasEcrCom\InpasEcrCom.tlb /codebase

В Торгсофт необхідно обрати відповідний Тип банківського терміналу (Мал. 19).

Мал. 19 (Версія програми  2022.0.10)

Тип підключення:

➢USB/COM:

•Номер СОМ-порту – номер СОМ-порту, до якого підключений банківський термінал (при встановленні драйвера за замовчанням СОМ9);

•Швидкість СОМ-порту - зі списку вибрати необхідну швидкість;

Підключення термінала Verifone через COM/USB виконується за допомогою звичайного USB<->miniUSBкабеля.

➢Ethernet:

•IP-адреса;

•Порт (для терміналів МР-Банка порт за замовчанням 5555).

➢Таймаут – це час у секундах, протягом якого будуть виконуватись спроби підключення терміналу. Рекомендується не залишати для цього поля значення, рівне 0 (бажано залишити 1-5 сек).

➢Робочий каталог шлях до каталогу, в якому зберігатиметься лог роботи терміналу, а також має знаходитись файл налаштувань pinpad.ini. Це текстовий файл, який створюється вручну та повинен містити таку інформацію:

[Connection]

PinpadLog=1

[Tag06]

SuccsessCode = 000,OK,OFF,Y1,Y2,Y3

*Параметр PinpadLog може приймати значення 1 або 0 і, відповідно, включає або вимикає режим ведення лога. Якщо встановлено 0 – лог вестись не буде.

*Параметр SuccsessCode – це перелік успішних кодів результату операції. У наведеному прикладі - це успішні коди за замовчуванням. Значення успішних кодів відповіді у процесингових систем (банків) можуть бути різні, тому в кожному конкретному випадку їх слід дізнатися у банку і занести у вигляді рядка з роздільником кома.

Нижче таблиця Мерчант банківського терміналу містить список мерчантів, за якими виконуватимуться операції з використанням конкретного терміналу. Натиснувши кнопку Додати відкриється вікно Операція банківського терміналу (Мал. 20).

Мал. 20 (Версія програми  2022.0.11)

У разі протоколу InpasEcrСom замість порядкового номера мерчанта (коду операції) вводиться Ім'я торговця, який може містити не лише цифри, а й літери. Список торговців можна отримати у банку. Поле можна залишити порожнім, якщо в терміналі зареєстровано лише один торговець.

Потрібно вказати Розрахунковий рахунок, Опис мерчанта та Тип операції (за замовчуванням Оплата_Повернення).

Для терміналів з протоколом InpasEcrСom доступна дія Операції банківського терміналу .

За натисканням на кнопку відкривається однойменне вікно (Мал. 21), де можна сформувати список операцій, які можуть викликатися для даного терміналу з Торгсофт крім операцій Оплата_Повернення.

Мал. 21 (Версія програми  2022.0.11)

Є можливість додати операції:

Закриття дня;

Скасування - служить для скасування операції поточного дня (до виконання операції Закриття дня). При виконанні операції потрібно ввести суму операції, що скасовується, та номер чека. Ця операція може бути корисною у разі, якщо оплата через банківський термінал пройшла, а в Торгсофт з якоїсь причини не зафіксувалася. Виконання даної операції не створює жодних фінансових документів та на облік руху грошових коштів у Торгсофт не впливає.

Важливо! В довіднику Валюта (Налаштування - Валюта) має бути визначена національна валюта та заповнений відповідний їй цифровий код. Для валюти "Гривня" це 980 (Мал. 16).

Технология подключения банковского терминала по протоколу InpasDualConnector_1 используется для подключения терминалов Сбербанка Казахстана (например, Verifon VX 520). Для подключение терминала по данному протоколу требуется, чтобы на локальном компьютере (к которому подключен терминал) был установлен соответствующий драйвер, а на компьютере с Торгсофт должно быть установлено ПО DualConnector. Драйвера и библиотеки, которые  предоставляются банком. ПО поставляется в виде архива.

Рис. 22 (Версия программы 2022.0.11)

Для подключения банковского терминала можно нажать кнопку Получить идентификатор терминала (Рис. 22) - используется для получения идентификатора терминала, если он заранее неизвестен. Перед выполнением данного действия терминал должен быть подключен и готов к работе. В случае успешного выполнения операции в поле будет записано полученное значение.

При необходимости можно проигнорировать параметры файла настроек и ввести вручную номер и скорость COM порта. Для этого следует установить переключатель Игнорировать файл настроек подключения и ввести нужные значения в поля СОМ порт и Скорость СОМ порта (Рис. 23).

Рис. 23 (Версия программы 2022.0.11)

Если поле Идентификатор терминала не было заполнено, то оно должно заполнится после выполнения операции Проверка связи с терминалом.

Ниже таблица Мерчант банковского терминала содержит список мерчантов, по которым будут выполняться операции с использованием конкретного терминала. Нажав кнопку Добавить откроется окно Операция банковского терминала (Рис. 24).

Рис. 24 (Версия программы 2022.0.11)

В случае протокола InpasDualConnector_1 доступен только один тип операции Оплата_Возврат.

Для терминалов с протоколом InpasDualConnector_1 доступно действие Операции банковского терминала.

По нажатию кнопки открывается одноименное окно, где можно сформировать список операций, которые могут вызываться для данного терминала (Рис. 25)

Рис. 25 (Версия программы 2022.0.11)

Есть возможность добавить операции:

•Закрытие дня;

•Отмена – служить для отмены операции текущего дня (до выполнения операции Закрытие дня). При выполнении операции необходимо ввести сумму отменяемой операции и номер чека. Эта операция может быть полезна в случае, если оплата через банковский терминал прошла, а в Торгсофт по какой-либо причине не зафиксировалась. Выполнение данной операции не создает никаких денежных документов и на учет движения денежных средств в Торгсофт не влияет;

•Тест соединения с хостом.

Важно! В справочнике Валюта (Настройки - Валюта) должна быть определена национальная валюта и заполнения соответствующего ей цифрового кода. Для валюты "Тенге" это 398 (Рис. 26).

Рис. 26 (Версия программы 2022.0.11)