Перейти к содержаниюСправка

Банковский терминал INPAS

Как подключить к кассе банковский терминал INPAS: выбрать способ подключения, установить и настроить программу DualConnector, указать терминал в настройках кассы и проверить оплату.

Терминалами INPAS пользуются многие банки: Альфа-Банк, Т-Банк (Тинькофф), ВТБ, банк «Точка», банк «Санкт-Петербург», Промсвязьбанк (ПСБ), Газпромбанк (ГПБ), АК Барс Банк, МТС-банк, Московский кредитный банк (МКБ), Россельхозбанк (РСХБ), «Русский стандарт», «Уралсиб», РНКБ (Российский национальный коммерческий банк), Почта Банк. Настройка на кассе одинакова для терминала любого из них.

Общее описание

Терминал INPAS не подключается к кассе напрямую. Между ними работает программа INPAS DualConnector: она установлена на компьютере, к которому подключён терминал, принимает команды кассы и передаёт их терминалу. Касса может обращаться к DualConnector двумя способами — им соответствуют два типа терминала в настройках оборудования.

  • Тип терминала INPAS (DualConnector HTTP) Касса обращается к службе DualConnector напрямую по протоколу HTTP. Hardware Bridge не нужен. Работает на всех платформах, а не только в Windows: в браузере на любой операционной системе и в приложении кассы для Android. Нужен DualConnector версии 2.
  • Тип терминала INPAS (через бридж) Касса обращается к терминалу через VirtualPos Hardware Bridge. Только для кассового компьютера с Windows; в приложении кассы для Android этого типа нет. Нужен DualConnector версии 1.

Возможности у обоих способов одинаковые: оплата, возврат, отчёт терминала и сверка итогов при закрытии смены.

Выбирайте «DualConnector HTTP» Если Hardware Bridge на кассе не установлен, касса работает на планшете или компьютере не с Windows, либо вы подключаете терминал впервые: в этой цепочке меньше звеньев
Выбирайте «через бридж» Если Hardware Bridge уже установлен, например для фискального регистратора, а на компьютере стоит DualConnector версии 1 или нет Java

Порядок подключения

  1. Данные от банка Получите у банка ид терминала и убедитесь, что терминал настроен на работу с кассой.
  2. DualConnector Установите DualConnector на компьютер, к которому подключён терминал, и укажите в нём способ подключения терминала.
  3. Проверка связи Проведите проверочную операцию средствами DualConnector — без кассы.
  4. Настройка кассы Выберите тип терминала, укажите адрес и ид терминала.
  5. Пробная оплата Проведите оплату на небольшую сумму, возврат и закрытие смены.

Что запросить у банка

Терминал настраивает инженер банка или его сервисной организации. Попросите настроить и сообщить:

Режим работы с кассой Операцию запускает касса, а не кассир на терминале
Ид терминала (Terminal ID) Восемь символов. Его указывают в настройках кассы
Печать чеков Чек терминала должен передаваться кассе: «на кассе» или «на кассе или терминале». Иначе касса не сможет напечатать слип
Способ подключения USB (COM-порт) или Ethernet, для Ethernet — адрес и порт терминала
Версия протокола SA2 или SA3. Та же версия указывается в DualConnector

Установка DualConnector

DualConnector — программа компании INPAS; дистрибутив предоставляет банк или сервисная организация. В одном установщике Common Connectors Installer.exe находятся две версии: DualConnector 1 (библиотека) и DualConnector 2 (служба Dual Connector Service).

Операционная система Windows 7, 8, 10 или 11
.NET Framework Версия 4.0 или новее
Java Нужна только для DualConnector 2
Права Установка выполняется с правами администратора
  1. Запустите Common Connectors Installer.exe с правами администратора.
  2. Выберите режим установки:
    • для типа «INPAS (DualConnector HTTP)» — «Автоматическая установка DC 2.0»;
    • для типа «INPAS (через бридж)» — «Автоматическая установка DC 1.0».
  3. В конце установки согласитесь запустить программу настройки: DC Service Control для версии 2 или DC Control для версии 1.
  4. После установки DualConnector 2 перезагрузите компьютер. Служба Dual Connector Service запускается автоматически.

Если уже установлен DualConnector 2. Выбирайте тип «INPAS (DualConnector HTTP)»: Hardware Bridge для него не нужен. Через Hardware Bridge DualConnector 2 работает, только если при установке дополнительно выбрана компонента DC Proxy (режим «Выборочная установка»); INPAS не рекомендует устанавливать её без необходимости.

Если терминал подключён по USB, установите драйвер: в программе настройки откройте вкладку «USB драйвера», выберите оборудование и нажмите «Установить». После этого терминал виден в Windows как COM-порт.

Настройка DualConnector

Параметры подключения терминала

В DualConnector 2 параметры задаются в программе DC Service Control, вкладка «Настройки службы».

Тип соединения «COM/USB» или «Ethernet»
Номер порта COM-порт терминала — для COM/USB
Скорость 115200. При подключении по USB не меняйте
IP адрес и порт Адрес терминала — для Ethernet, например 192.168.1.50:1006
Тип протокола SA2 или SA3 — как настроено в терминале
Terminal ID Ид терминала, выданный банком
Автопоиск терминала по USB Включите, если номер COM-порта может меняться

Заполните поля, нажмите «Сохранить», затем «Выйти»: настройки применяются при выходе из программы, когда служба перезапускается.

В DualConnector 1 те же параметры задаются в программе DC Control, вкладка «XML Generator».

Проверка связи без кассы

До настройки кассы убедитесь, что DualConnector работает с терминалом. В программе настройки откройте вкладку «Проверка связи» и выполните «Проверка связи с терминалом», «Проверка связи с хостом», затем «Оплата» и «Отмена». Ид терминала и сумма задаются кнопкой «Изменить параметры».

Внимание. Операцию «Загрузка ключей» без согласования с банком не запускайте.

Если оплата не проходит в программе DualConnector, причина не в кассе: обратитесь в банк.

Настройка на кассе

  1. На кассе откройте Управление → Настройка оборудования, раздел «Банковский терминал».
  2. В поле «Тип терминала» выберите «INPAS (DualConnector HTTP)» или «INPAS (через бридж)». Появится поле «ID терминала INPAS».
  3. Заполните параметры.
Настройка терминала INPAS на кассе
Настройка терминала INPAS на кассе
  1. Нажмите «Сохранить». Касса перезагрузится.
ID терминала INPAS Ид терминала, выданный банком, например 00000001. Обязательное поле: без него оплата не начнётся. Можно ввести вручную или получить кнопкой «Определить»
IP-адрес сервера Для «DualConnector HTTP» — адрес компьютера с DualConnector, для «через бридж» — адрес компьютера со службой Hardware Bridge. Если это тот же компьютер, на котором открыта касса, — 127.0.0.1
Пустые строки перед отрезкой Сколько пустых строк протянуть после слипа перед отрезкой: от 0 до 9
Количество слипов Сколько копий слипа печатать: от 1 до 5

Порт в поле «IP-адрес сервера» можно не указывать — касса подставит стандартный: 9015 для «DualConnector HTTP» и 8080 для «через бридж». Если служба принимает запросы на другом порту, допишите его через двоеточие: 127.0.0.1:8093.

Изменять настройки оборудования может пользователь с правом pos.settings.update.

Кнопка «Определить»

Кнопка запрашивает ид у самого терминала и подставляет его в поле «ID терминала INPAS». Сохранять настройки перед нажатием не нужно: касса берёт тип терминала и адрес из формы. Полученный ид сохраняется кнопкой «Сохранить».

Внимание. Чтобы узнать ид, касса отправляет на терминал оплату на 10 копеек с заведомо неверным идом. Терминал отклоняет её и в ответе сообщает свой ид. Если терминал вместо отказа попросил карту, нажмите на нём «Отмена» и не прикладывайте карту, а ид введите вручную.

Касса ждёт ответа терминала до одной минуты. Если ид получить не удалось, появится сообщение «Не удалось определить ID терминала. Введите его вручную» с причиной. Ид можно узнать у банка или посмотреть в программе настройки DualConnector.

Дополнительно для типа «INPAS (через бридж)»

  • Нужна служба Hardware Bridge версии 135 или новее — как установить и обновить службу, см. VirtualPos Hardware Bridge.
  • COM-порт и скорость терминала на кассе не указываются: они берутся из настроек DualConnector.
  • Время ожидания операции — три минуты. Его можно изменить параметром inpas_timeout в файле настроек службы.

Дополнительно для типа «INPAS (DualConnector HTTP)»

  • Служба Dual Connector Service должна быть запущена. Порт службы задаётся параметром SERVERPORT в файле настроек DualConnector, по умолчанию 9015.
  • Если DualConnector установлен на другом компьютере, разрешите на нём входящие подключения к порту службы в брандмауэре Windows.
  • Браузер может запросить разрешение на подключение к устройствам в локальной сети — разрешите его. Подробнее — Связь с оборудованием.

Настройка из панели управления

Настроить терминал можно и без доступа к кассе — из карточки кассового места в панели управления, см. Кассовые места. В блоке «Настройки оборудования» показаны сохранённые настройки: тип терминала, ид терминала INPAS и адрес.

  1. Убедитесь, что касса запущена и на связи: настройки применяются на ней.
  2. В карточке кассового места нажмите «Настроить удаленно». Откроется окно с теми же полями, что и на кассе.
  3. В разделе «Банковский терминал» выберите тип терминала, укажите ид терминала и адрес.
  4. Нажмите «Сохранить». Панель управления сообщит, что сохранение прошло успешно, а касса перезагрузится с новыми настройками.
  • «IP-адрес сервера» указывается с точки зрения кассы: 127.0.0.1 — это компьютер кассы, а не компьютер администратора.
  • Кнопка «Определить» работает так же, как на кассе: ид у терминала запрашивает касса и передаёт его в панель управления. Панель ждёт ответа 10 секунд; если терминал отвечает дольше, появится ошибка «Timeout expired» — определите ид на самой кассе или введите его вручную.
  • Кассир во время настройки видит уведомление «Внимание! В данный момент проводится настройка терминала удаленным сотрудником».
  • Если касса не запущена, вместо окна настроек появится сообщение «Отсутствует связь с кассовым рабочим местом. Рабочее место не запущено или находится в режиме офлайн.»

Проверка

  1. Пробейте чек с оплатой картой на небольшую сумму. Терминал должен попросить карту, после оплаты касса печатает слип и чек.
  2. Оформите по этому чеку возврат.
  3. Закройте смену: касса покажет отчёт терминала, а на терминале выполнится сверка итогов.

Для типа «INPAS (через бридж)» связь с терминалом можно проверить и без кассы — откройте в браузере на кассовом компьютере адрес, подставив свой ид терминала:

http://127.0.0.1:8080/api.php?a=pinpad:inpas:TestConnection&encode=TEXT&p=%7B%22terminal_id%22%3A%2200000001%22%7D

Что касса делает с терминалом

Оплата Передаёт сумму на терминал и ждёт до трёх минут, пока покупатель приложит карту и введёт ПИН-код
Возврат При возврате по чеку, оплаченному картой, отправляет на терминал возврат на ту же сумму со ссылкой на исходную оплату
Отмена оплаты Если после оплаты картой чек напечатать не удалось, кассир может отменить операцию — см. Если чек не напечатался. На терминале INPAS отмена выполняется как возврат
Закрытие смены Запрашивает краткий отчёт терминала — он показан на шаге ввода безналичной выручки — и выполняет сверку итогов с банком, см. Смена и отчёты

Слип печатается на принтере кассы, только если терминал передал кассе текст чека. Если терминал печатает чеки сам, слип на кассе не печатается, а вместо отчёта терминала выводится строка «Терминал не передал образ отчета».

Ограничения. Касса работает с одним терминалом INPAS. Оплата по QR-коду через терминал INPAS не поддерживается — см. Оплата по QR-коду: СБП и Яндекс Пэй. Вопросы, которые терминал задаёт кассиру, показывает отдельная программа INPAS, если она установлена, а не касса.

Частые ошибки

Сообщение Причина Что делать
В настройках оборудования не задан ID терминала INPAS Не заполнено поле «ID терминала INPAS» Укажите ид терминала и сохраните настройки
Во входящих параметрах не найдено [terminal_id]. Укажите ID терминала INPAS в настройках оборудования кассы То же для типа «через бридж» Укажите ид терминала и сохраните настройки
Не удалось определить ID терминала. Введите его вручную. Ошибка: Нет связи с DualConnector … Служба Dual Connector Service не запущена либо неверно указан адрес или порт Запустите службу, сверьте адрес и порт. В сообщении показан адрес, по которому обращалась касса
Не удалось определить ID терминала. Введите его вручную. Ошибка: Нет связи с бриджем … Служба Hardware Bridge не запущена либо неверно указан адрес или порт Запустите службу, сверьте адрес и порт
Терминал не сообщил свой идентификатор Терминал не вернул ид в ответ на запрос Введите ид вручную
Внутренняя ошибка системы при оплате по банковской карте. Касса не получила ответа от DualConnector или Hardware Bridge Проверьте, что служба запущена, и адрес в настройках кассы
Необходимый для работы COM-объект [DualConnector.DCLink] не зарегистрирован в системе Тип «через бридж»: DualConnector не установлен, установлен DualConnector 2 без компоненты DC Proxy или его библиотека не зарегистрирована в Windows Установите DualConnector нужной версии. Если не помогло — см. ниже
Модель устройства [inpas] не зарегистрирована в системе Старая версия Hardware Bridge Обновите службу до версии 135 или новее
Нет связи с банковским терминалом DualConnector не видит терминал Проверьте кабель, COM-порт и драйвер USB, затем связь в программе настройки DualConnector
Банковский терминал занят другой операцией На терминале не завершена предыдущая операция Завершите или отмените её на терминале и повторите
Истекло время выполнения операции Операция не завершена за отведённое время Повторите оплату. Проверьте время ожидания в настройках DualConnector
Обмен с терминалом прерван Отмена на терминале, остановка службы или нет связи с банком Повторите операцию
Отклонено, Нет соединения, Операция прервана либо текст от банка Отказ терминала или банка Причину сообщает терминал. Повторите операцию или обратитесь в банк

Если библиотека DualConnector установлена, но Hardware Bridge её не находит, выйдите из Windows и войдите заново, затем зарегистрируйте библиотеку: откройте командную строку от имени администратора в папке установки DualConnector и выполните команду.

C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe DualConnector.dll /tlb

Для специалистов

Файл настроек DualConnector 2

Параметры службы хранятся в файле Service\config\Connector.xml в папке установки DualConnector — по умолчанию C:\Program Files (x86)\INPAS\DualConnector или C:\Program Files (x86)\INPAS\DualConnector 2.0. Пример для терминала на COM-порту:

<ROOT>
  <SERVERPORT>9015</SERVERPORT>
  <LOG_TYPE>ADVANCED</LOG_TYPE>
  <DEVICES_TYPE>TERMINAL</DEVICES_TYPE>
  <CONNECTION_TYPE>COM</CONNECTION_TYPE>
  <CONNECTION_PORT>COM5</CONNECTION_PORT>
  <CONNECTION_BAUDRATE>115200</CONNECTION_BAUDRATE>
  <EXCHANGE_TIMEOUT>180</EXCHANGE_TIMEOUT>
</ROOT>
SERVERPORT Порт службы. Его касса указывает в поле «IP-адрес сервера», если он отличается от 9015
CONNECTION_TYPE Способ подключения терминала: COM или IP
CONNECTION_PORT, CONNECTION_BAUDRATE COM-порт и скорость — для подключения по COM или USB
IPADDRESS Адрес и порт терминала — для подключения по сети
PROTOCOL Версия протокола: 2 или 3, должна совпадать с настройкой терминала
EXCHANGE_TIMEOUT Наибольшее время операции в секундах. Установите 180: столько же операцию ждёт касса
AUTO_SEARCH ON — искать COM-порт терминала автоматически
LOG_TYPE Подробность журнала: OFF, SYSTEM, ADVANCED, DEBUG, VERBOSE
LOG_PATH, LOG_CLEARTIME Папка журнала и срок его хранения в днях

Файл настроек DualConnector 1

Параметры хранятся в файле DualConnector.xml в папке установки, рядом с DualConnector.dll. Способ подключения терминала задаётся в разделе CONNECTION: TYPE — COM или IP, PORT и BAUDRATE — для COM-порта, IPADDR — для подключения по сети.

Журналы

DualConnector Папка из параметра LOG_PATH, по умолчанию — папка установки DualConnector. Для разбора ошибки установите подробность DEBUG
Hardware Bridge Папка logs службы — см. Логи
Облако VirtualPos Запросы кассы к терминалу и ответы на них — см. Технологические журналы кассового места

Связанные разделы