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

➢USB/COM (Рис. 2):

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

•Скорость СОМ-порта - из выпадающего списка выбрать необходимую скорость;

•Таймаут - время ожидания ответа (мс).

➢Ethernet (Рис. 3):

•IP-адрес;

•Порт.

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

Общие настройки (независимо от типа подключения):

•Использовать подтверждение кассы  - переключатель должен быть включен, если терминал настроен на работу с протоколом, требующим подтверждение от кассы;

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

После заполнения всех параметров нажимаем Записать .

По нажатию на кнопку Получить информацию о банковском терминале отображается информационное сообщение со списком мерчантов терминала (терминал должен быть подключен и включен в сеть).

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

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

Заполняются следующие параметры:

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

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

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

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

•Тип операции - тип операции, который выполняется с использованием данного мерчанта:

oОплата;

oВозврат;

oОплата/Возврат - выбирается в том случае, если операции возврата и оплаты выполняются с использованием одного мерчанта и не предполагают использование сервисов.

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

ВАЖНО! Если включается параметр Автоопределение номера мерчанта, то должно быть указано реально существующее для данного терминала наименование мерчанта, которое можно получить, воспользовавшись действием Получить информацию о терминале.

•Использовать сервис - должен быть включен, если операция выполняется с помощью сервиса (например, возврат для терминалов Приватбанка);

•Предварительное чтение карты при возврате отображается для типа операции Возврат или Оплата/возврат (по умолчанию включено). Если настройка отключена, то при возврате через банковский терминал предварительное чтение карты выполняться не будет. В этом случае проверка соответствия карты, которой был оплачен товар, карте, на которую выполняется возврат, будет выполняться в момент возврата самим терминалом. Отключать данную настройку рекомендуется в тех случаях, когда по какой-либо причине предварительное чтение карты банковским терминалом приводит к ошибке, из-за которой невозможно выполнить возврат.

•Параметры сервиса - если операция с мерчантом выполняется с использованием сервиса, то должны быть указаны параметры. Обычно это строковое значение. Если это операция возврата, то строка параметров сервиса обязательно должна содержать комбинацию символов "RRN"

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

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

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

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

Тип операции:  оплата/возврат

Использовать сервис - выключено

Автоопределение номера мерчанта - выключено

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

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

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

•Порт - 3000;

•Таймаут - время ожидания ответа (мс).

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

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

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

Заполняются следующие параметры:

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

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

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

•Тип операции - Оплата/возврат независимо от того, под каким номером этот мерчант отображается в информации по терминалу.

Для терминалов, работающих по протоколу WebSocket не поддерживается автоопределение номера мерчанта и работа с сервисами.

•Предварительное чтение карты при возврате отображается для типа операции Возврат или Оплата/возврат (по умолчанию включено). Если настройка отключена, то при возврате через банковский терминал предварительное чтение карты выполняться не будет. В этом случае проверка соответствия карты, которой был оплачен товар, карте, на которую выполняется возврат, будет выполняться в момент возврата самим терминалом. Отключать данную настройку рекомендуется в тех случаях, когда по какой-либо причине предварительное чтение карты банковским терминалом приводит к ошибке, из-за которой невозможно выполнить возврат.

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

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

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

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

Также необходимо выбрать Идентификатор транзакции (RRN или Номер чека). Если в качестве идентификатора транзакции выбран RRN, то в таблице Финансовый документ в поле RRN будет сохраняться RRN транзакции, иначе - Номер чека. Если был сохранен RRN,  то выполнить возврат по номеру чека будет невозможно и наоборот. Выбор идентификатора транзакции определяется параметрами настройки терминала, в частности тем, доступна на нем функция возврата товара или нет.

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

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

Заполняются следующие параметры:

•Код операции;

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

•Описание операции - служит для идентификации нужной операции при выборе;

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

oОплата;

oВозврат;

oОплата/Возврат.

Настройка Использовать CommandLineTool. Если включен данный переключатель, то взаимодействие с терминалом выполняется через утилиту командной строки CommandLineTool.exe, которая входит в состав программного обеспечения Arcus. В противном случае взаимодействие выполняется с использованием функций библиотеки Arccom.dll.

Для терминалов с протоколом ARCUS доступно действие Операции банковского терминала (Рис. 9).

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

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

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

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

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

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

•Запрашивать сумму - если включен, то при выполнении операции будет отображаться окно с запросом на ввод суммы, которая будет передана на терминал.

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

Выполнить любую из этих операций можно двумя способами:

1. В списке банковских терминалов выделить нужный терминал. Вызвать действие Операции банковского терминала (Рис. 9) и в открывшейся форме Операции банковского терминала выделить нужную операцию и нажать Выполнить операцию (Рис. 11).

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

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

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

Стоит отметить, что для выполнения действия Получить информацию о терминале для терминалов по протоколу ARCUS необходимо ввести код соответствующей операции из файла ops.ini.

Важно! В справочнике Валюта должна быть определена национальная валюта и заполнен соответствующий ей цифровой код

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

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

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

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

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

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

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

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

Нужно указать Расчетный счет, Описание операции. Тип операции по умолчанию Оплата_Возврат.

Предварительное чтение карты при возврате отображается для типа операции Возврат или Оплата/возврат (по умолчанию включено). Если настройка отключена, то при возврате через банковский терминал предварительное чтение карты выполняться не будет. В этом случае проверка соответствия карты, которой был оплачен товар, карте, на которую выполняется возврат, будет выполняться в момент возврата самим терминалом. Отключать данную настройку рекомендуется в тех случаях, когда по какой-либо причине предварительное чтение карты банковским терминалом приводит к ошибке, из-за которой невозможно выполнить возврат.

Для терминалов с протоколом PosApi доступно действие Операции банковского терминала (Рис. 9).

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

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

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

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

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

Необходимо выбрать Тип банковского терминала и сохранить по кнопке Записать (Рис. 17).

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

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

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

Заполняются следующие параметры:

•Код операции - можно узнать у банка или в документации по подключению банковского терминала. Номер операции «Оплата» должен быть установлен в 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-mini USB кабеля.

➢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)

В случае протокола InpasEcrCom вместо порядкового номера мерчанта (кода операции) вводится Имя торговца, который может содержать не только цифры, но и буквы. Список торговцев можно получить в банке. Поле можно оставить пустым, если в терминале зарегистрирован только торговец.

Следует указать Расчетный счет, Описание мерчанта и Тип операции (по умолчанию Оплата_Возврат).

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

По нажатию кнопки открывается одноименное окно (Рис. 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)