Подключение эквайринг терминалов по протоколу INPAS
В этой статье рассказываем, как подключить интегрируемый терминал или пин-пад, работающий по протоколу INPAS, к программе GBS.Market. Работа с терминалами по протоколу INPAS реализована через службу DC Service, которая является частью Dual Connector 2.0. Взаимосвязь со службой происходит путем web-запросов.
По протоколу INPAS работают терминалы (пин-пады) Verifone, IRAS, PAX, на которые установлено ПО (прошивка) UNIPOS Terminal SmartSale от компании Inpas.
Информация Это технически сложная статья. Если вы не уверены, что справитесь самостоятельно — закажите настройку на платной основе, заполнив заявку.
Важно! Установку драйверов для эквайринг-терминала рекомендуется выполнять силами технических специалистов банка.
Терминал должен быть совместим с протоколом INPAS и работать через DualConnector 2.0. Может потребоваться обновление встроенного ПО терминала.
Важно В процессе установки Dual Connector возможно возникновение ошибок. Для их решения ознакомьтесь с разделом «Возможные ошибки» данной статьи.
Скачать установщик
Установка Dual Connector
Начало установки
Скачанный файл установщика можно найти в папке “Загрузки”. Он может выглядеть так:
Запустите скачанный файл, дважды кликнув на него. После запуска вы увидите окно, как на скриншоте ниже. Нажмите “Выборочная установка”, чтобы продолжить.
На следующей странице необходимо выбрать вариант Dual Connector 2.0 и отключить опцию DC Proxy.
При необходимости вы можете изменить путь установки.
Нажмите “Установить”, чтобы продолжить. Начнется процесс установки.
Оставьте заявку на банковское обслуживание и получите 2 месяца лицензии на GBS.Market в подарок!
Установка Java
Важно Отсутствие подключения к интернету может привести к появлению ошибки в процессе установки Java.
В процессе установки будет установлена платформа Java, если ранее на компьютере она не была установлена.
Нажмите Install, чтобы завершить установку Java.
Установка .Net Framework
Важно В некоторых случаях необходимо скопировать файл установки .Net Framework для корректного завершения установки Dual Connector. В противном случае это приведет к ошибке установки.
Важно Запускать установщик .net Framework 3.5 отдельно не требуется. Необходимо выполнить действия, описанные ниже
На некоторых версиях ОС Windows может потребоваться установка .Net Framework 3.5. Необходимо установку фреймворка выполнить не отдельно, а вкупе с Dual Connector 2.0.
Скачайте файл установки .Net Framework 3.5 по ссылке . Скачанный файл должен иметь имя dotnetfx35.exe. Переименуйте его, если имя отличается.
Скопируйте файл dotnetfx35.exe в ту же папку (директорию), где находится файл установки Dual Connector 2.0. В итоге это должно выглядеть, как на скриншоте.
После копирования файла dotnetfx35.exe, необходимо повторно запустить установщик Dual Connector 2.0. В процесс установки вы увидите сообщение о необходимости установить .Net Framework. Нажмите “Установить этот компонент”.
В случае успешной установки .Net Framework 3.5 вы увидите сообщение. Нажмите “Закрыть”, чтобы продолжить установку Dual Connector 2.0.
Завершение установки
В случае успешной установки вы увидите окно с соответствующим сообщением. Включите опцию “Запустить DC Control” и нажмите “Завершить”, чтобы закрыть установщик и перейти к процессу настройки подключения и проверки связи.
Dual Connector 2 [Win10] не успешно
DualConnector2 использует сервис под Виндоус для управления банковским терминалом по USB.
На самом деле установка и подключение банковских терминалов от ИНПАС под Windows не тривиальное занятие. Поэтому обращаем внимание на все нюансы. Устанавливаем DualConnector 2 под Windows 10-64.
Пробуем подключить банковский терминал PAX SP30 (протокол ИНПАС) к компьютеру с операционной системой Windows.
Ссылку на документацию (2022г. ) можно найти на сайте inpas.ru — новый репозиторий для распространения ПО https://owncloud.itgrp.ru/index.php/s/x1qolROTa79MN71. качаем оттуда все себе на компьютер и начинаем разбираться (под Windows).
Со слов поддержки Инпас они устанавливают 1.3.10.1 на новые ОС (Win10) и 1.3.3 на старые Win7.
Выбор типа установки Автоматическая установка устанавливает Dual Connector 1 (почему-то). И в каталоге C:Program Files (x86)INPASDualConnector мы не видим папки Service. При этом программка DC Control запускает нормально, Проверки связи с терминалом и хостом проходят, но оплаты нет и терминал зависает.
Таким рбразом Dual Connector 1 у нас НЕ принимает оплаты, более того виснет и требуется перезапуск терминала.
Мы скачиваем DualConnector (Common Connectors Installer) 1.3.10.1.rar.
Распаковываем и установщик ПО имеет название Common Connectors Installer.exe (почему-то без цифровой подписи) и версия 1.5.1.9 (не путайте с версией самого DualConnector 1.3.10.1).
Запускаем установку Common Connectors Installer.exe (наверное лучше от имени Администратора). Выбираем выборочная установка:
Выбираем закладку Dual Connector 2.x :
Тут важно понимать, что вы выберите слева, то и установится, то есть либо Dual Connector, либо Smart Connector.
После установки появляется новый сервис Dual Connector Service, но внимание — он не будет запущен, хотя тип старта будет выставлен у него автозапуск. То есть надо перезагрузить ПК или стартануть сервис вручную.
Теперь как ни странно несколько слов об удалении, а именно о полном сносе DualConnector.
Может так случится , как у нас например , что запуск деинсталлятора не приводит к желаемым результатам.
А именно деинсталлятор сначала не доходит до конца, зависает, приходится перезагружать систему.
Потом деинсталлятор сам после старта системы запускается, завершает удаление, пишет что все успешно, но файлы из каталога
C:Program Files (x86)INPASDualConnector
не удаляются и сервис «Dual Connector Service for UNIPOS» не завершается.
Повторная перезагрузка системы не помогает. То есть сервис как висел так и висит. А вот в Панели управления / программы нашего inpas уже нет.
Вот это косячокс. При этом вы можете даже не подозревать об этом и установить новую версию и думать, что все сделали правильно.
Естественно в этой ситуации первым делом останавливаем сервис, удаляем из C:Program Files все, что связано с Инпасом. И далее устанавливаем новую версию.
Можно сразу обратится в логам сервиса, там много полезной информации для отладки, они находятся здесь:
C:Program Files (x86)INPASDualConnectorServicelog
Забегая вперед сразу надо сказать , что (со слов «адекватной» поддержки АльфаБанка, до которой дозванивались пол дня) смогли уточнить, что под Windows нужен:
1. DualConnector 2.0, Proxi DC галочку при установке ставим.
2. Драйвера USBDriver_V2.28_XXXX (в свойствах 2.9.9.1)
и все больше ничего.
Драйвера USB есть для DualConnector и еще «обычные» для PAX и Verifone и еще NewLand.
Установка DualConnector создает каталог C:Program Files (x86)INPASDualConnector с таким примерно содержанием (папки Service почему-то нет, а на самом деле должна быть):
Далее надо обратить внимание на то, что в системе должен появиться и работать «Dual Connector Service for UNIPOS» сервис :
То, что папка Service не создается при установке связано с тем, что не устанавливается либо Java либо NetFrameWork.
Для проверки работы первое, что можно попробовать это консольную программку DC Console.exe (bat-ники с примерами ее использования находится в каталоге test).
Через DC Console.exe в принципе можно проверить все операции на банковском терминале.
Также использование DC Console.exe можно вмонтировать в свою программу.
Там же есть программа с графическим интерфейсом DC Control.exe, где также можно проверить основные команды.
Логи обмена можно посмотреть также в каталоге C:Program Files (x86)INPASDualConnector, там будет примерно такой файл — DualConnector20220413.log.
Далее в руководстве программиста есть пример на С++ с вызовами методов из библиотеки DualConnector.dll, но как обычно у поставщиков банковских терминалов нет заголовочных файлов к dll. И вобщем-то не понятно в результате как этим пользоваться.
Из руководства : «DualConnector» представляет из себя «.Net библиотеку», реализующую интерфейс обмена с терминалом по протоколу SA. Сам протокол SA нам найти не удалось.
Надо сказать, что Inpas библиотеки DualConnector2 сделаны с применением Java и Net3.5, а значит все это безобразие надо тащить с собой и устанавливать на Windows.
После переустановки драйвера USB (USB Drivers 1.0.0.3.exe с офиц. сайта 2022г.) появилась ошибка ERRORLEVEL = 13.
Может показаться, что USBVID_1234&PID_0101 левый (для разработчиков), но это не так похоже, VID_1234 в интернете проходит по теме инпас.
На данном промежуточном этапе испытываем трудности:
Принимаем оплату 100.00 через консольную программу DC Console.exe — получаем ответ Z3 (обрыв связи , переход в оффлайн) и терминал зависает приходится перегружать.
Со слов поддержки Инпас ошибка Z3 это когда терминал не может связаться с банковским сервером, то есть терминал по USB VCOM связывается с сервисом в Виндоус и далее не может по TCP IP никак достучаться до сервера банка в интернете.
В итоге клиенту устанавливает сотрудник Альфабанка как-то драйвера и у клиента все работает. К сожалению клиент забрал свой терминал и как и какие драйвера надо устанавливать мы не смогли понять точно. Но по факту работать из kkmserver сервиса с банковским терминалом и кассой Атол оказалось можно.
Самое интересное, что у нас появилась возможность попробовать подключить другой терминал Pax SP30 на том же компе под тем же Виндоус и ситуация повторяется. А именно: все тесты, отчеты проходят кроме оплаты , карта считывается нормально, но происходит отмена и на экране «нет связи с ккм». Версия 2.0.10.500.
Зачем нужен SmartConnector можно посмотреть здесь Smart Connector.
Более подробно о причинах подвисания можно посмотреть здесь
Разбираемся почему не работает USB драйвер.
Плагин INPAS
INPAS – плагин позволяет подключить платежные терминалы от компании «INPAS» в приложении Касса Розница 3.0х через утилиту DualConnector.
Установка
Для установки плагина в приложении «Касса Розница» 3.0х Desktop:
- В разделе Меню кликнуть на значок
- В разделе БИФИТ Касса перейти в раздел Доступно
- В списке плагинов найти необходимый плагин и нажать кнопку Установить
- После установки плагина, перезапустить приложение
Настройка DualСonnector
После установки плагина выполните следующие действия:
- Скачайте и установите драйвер для вашей модели платежного терминала
- Установите DualConnector
- После установки DualConnector запустите DC Control (Будет предложено запустить автоматически после установки DualConnector или запустите вручную файл DC Control.exe расположенный в C:\Program Files (x86)\INPAS\DualConnector)
- Во вкладке XML Generator укажите:
- Тип соединения
- Номер COM-порта
- Скорость обмена (по умолчанию 115200)
- Нажмите Сохранить
Важно!
Банковские библиотеки Dual Connector устанавливает сотрудник банка, который настраивает банковский терминал.Подключение плагина в приложении
- Запустите и авторизуйтесь в приложении Касса Розница
- Перейдите в подраздел Настройки → Платежные терминалы
- Нажмите кнопку
- Выберите плагин INPAS
- В поле Идентификатор терминала введите номер терминала (номер терминала можно получить у банка)
- Установите Таймаут ожидания ответа (мин) (По умолчанию 3 минуты)
- Укажите путь до банковской библиотеки в поле Директория с банковским ПО (по умолчанию путь C:\Program Files (x86)\INPAS\DualConnector)
- Нажмите кнопку Проверить, затем нажмите Сохранить
Прием оплаты
После подключения платежного терминала в приложении можно совершить продажу и принять оплату по банковской карте:
- В приложении Касса Розница Desktop перейдите в раздел Касса
- Добавьте товары в чек
- Нажмите кнопку Оплатить
- В окне Оплата:
- Выберите Тип оплаты → Безналичными
- Укажите систему налогообложения
- Распечатается банковский слип чек (чек, который подтверждает получение оплаты)
- Фискальный чек (содержит в себе информацию о товарных позициях и их количестве и фискальные данные)
