<< Click to Display Table of Contents >> Navigation:  Додаткові функції > Підключення банківського терміналу > Інструкції підключення банківських терміналів > InpasEcrCom

Інструкція з підключення POS-терміналів за протоколом InpasEcrCom

Технологія підключення банківського термінала за протоколом InpasEcrCom використовується для підключення терміналів Міжнародного Резервного банку (МР Банк - колишній Сбербанк Україна) (на прикладі Verifon VX 520). Також за інформацією від розробника за цим протоколом працюють термінали банків: ТАСКОМБАНК, АЙБОКС БАНК, АЛЬФА-БАНК (тільки термінали 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

 

Налаштування підключення термінала

Підключення термінала можливе як по COM/USB так і по Ethernet (для терміналів МР-Банка порт за замовчуванням 5555, так встановлено в їх емуляторі каси). При використанні підключення по COM/USB при встановленні драйвера за замовчуванням термінал підключається на порт COM9 (Мал. 1).

Мал. 1

 

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

 

Перевірка підключення термінала за допомогою емулятора каси InpasEcrComTest

Для перевірки термінала за допомогою цього емулятора слід запустити файл InpasEcrComTest.exe, який надається банком разом з драйверами та бібліотекою (Мал. 2).

Мал. 2

 

Налаштування підключення виконується натисканням спеціальної кнопки. У відкритій формі вибирається тип підключення та вводяться необхідні параметри. Параметр Контролювати сигнал не є обов'язковим, його можна залишити порожнім. Особливістю роботи термінала за цим протоколом є те, що у випадку поєднання термінала з ПК, термінал, можливо, не буде працювати в ручному режимі. Тобто всі основні команди для виконання операцій повинні генеруватися програмою. Після введення параметрів слід натиснути кнопку Підключити. У випадку успішного підключення вікно емулятора каси виглядатиме наступним чином (Мал. 3).

Мал. 3

 

Важливо. Можлива ситуація, коли термінал не переведений банком у режим роботи з касою. У цьому випадку всі подальші операції, що виконуються на емуляторі, можуть повертати помилку Е:0005:0005, а термінал візуально не буде реагувати на викликані операції. Підтвердженням такої ситуації також може бути той факт, що буде доступна робота термінала в ручному режимі. Якщо включено режим роботи з касою, то на екрані термінала повинна відображатись надпис ОЧІКУВАННЯ ККМ, а можливість ручної роботи буде заблокована (не обов'язково). Перед тим, як буде продовжено налаштування роботи з касою, банком повинен бути включений відповідний режим роботи термінала.

Для виконання операцій Оплата, Возврат та Відміна слід вибрати тип операції Звичайні операції DC4, а для операції Закриття дня - Адміністративні операції.

Параметр Ім'я торговця це аналог номера мерчанта для інших протоколів, можна залишити порожнім.

 

Підключення термінала Verifone в Торгсофт (на прикладі термінала від МР Банка)

Форма налаштування банківського термінала (Мал. 4).

Мал. 4

 

Вибирається відповідний протокол (можна спочатку вибрати тип термінала і протокол підставиться автоматично), вводиться номер COM-порту (або IP і порт). Значення поля Тайм-аут для цього протоколу встановлюється в секундах. Це час в секундах, протягом якого буде здійснюватися спроба підключення термінала. Рекомендується не залишати для цього поля значення, рівне 0 (бажано залишити 1-5 сек). Параметр Робочий каталог містить шлях до каталогу, в якому буде зберігатися лог роботи термінала, а також має знаходитися файл налаштувань pinpad.ini. Це текстовий файл, який створюється вручну і повинен містити таку інформацію:

[Connection]

PinpadLog=1

[Tag06]

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

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

Параметр SuccsessCode - це перелік успішних кодів результату операції. У наведеному прикладі — це успішні коди за замовчуванням. Значення успішних кодів відповіді у процесингових систем (банків) можуть бути різними, тому в кожному конкретному випадку їх слід дізнатися в банку і занести у вигляді рядка з роздільником кома.Ведення логу має особливість. Для кожної операції термінала створюється свій файл логу з ім'ям InpasEcrComLog_ЧЧ_ММ_СС.txt, де ЧЧ_ММ_СС — час виконання операції. Логи зберігаються протягом всього сеансу роботи Торгсофт. При відкритті нового сеансу Торгсофт при виконанні першої операції на терміналі всі "старі" логи будуть видалятися.Форма налаштування мерчанта (операцій) банківського термінала (Мал. 5).

Мал. 5

 

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

Форма налаштування додаткових операцій банківського термінала (Мал. 6).

Мал. 6

 

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

Важливо! Цей протокол має дві особливості при виконанні операції Повернення:

•При виконанні повернення потрібно на терміналі ввести Номер касира та Пароль касира. Цю інформацію повинен надати банк.

•Необхідним параметром для повернення є Код авторизації. Щоб його не вводити вручну з чека (а спеціально він не зберігається) значення цього параметра зберігається в полі, в якому зберігається RRN. У фінансовому документі це виглядає наступним чином (Мал. 7).

Мал. 7

 

Формат значення поля: RRN_Код авторизації. На виведення інформації в чек це не впливає.

Мал. 8

Важливо! Для цього протоколу в довіднику Валюта має бути вказаний міжнародний код валюти (Мал. 9), з якою виконується операція на банківському терміналі.

Мал. 9