Дополнительные функции > Интеграция с банковским терминалом > Инструкции по подключению банковских терминалов

Инструкция по настройке подключения с устройствами, поддерживающими протокол/приложение OschadPAY

Сопряжение механизма оплаты платежной картой в Торгсофт по протоколу OschadPAY предусматривает настройку подключения с устройствами, на которых установлено андроид-приложение "OschadPAY" (от Ощадбанка Украины). Эта программа может быть установлена как на POS-терминале на базе ОС Андроид, так и на смартфоне, поддерживающем технологию бесконтактной оплаты NFC (в этом случае смартфон выступает в роли банковского POS-терминала). Кроме смартфона необходимо, чтобы в рабочем каталоге Торгсофт (там, где находится exe-файл) находились файлы libeay32.dll и libssl32.dll.

Необходимо загрузить и установить на смартфон приложение OschadPAY, предварительно согласовав все вопросы с банком (договор, оформление личного кабинета и т.д.). Банк непосредственно или через личный кабинет должен предоставить пользователю Токен авторизации и Идентификатор клиента (ClientID). После настройки программы на смартфоне, убедившись, что все корректно работает, можно переходить к следующему этапу, а именно подключению в Торгсофт.

При добавлении банковского терминала (Настройки - Параметры- Дополнительные опции - Банковский терминал) в поле Тип банковского терминала выберите Смартфон(Ощадбанк) или протокол ОschadPAY (рисунок 1).

банковский терминал - ощад

Рисунок 1 - Добавление банковского терминала Смартфон(Ощадбанк)

Следует заполнить поля Токен авторизации и Идентификатор клиента. При первоначальной настройке, если Мерчант неизвестен, можно воспользоваться кнопкой Получить мерчант торговца кнопка Получение мерчанта торговца (возле соответствующего поля). Поле Каталог лога является обязательным для заполнения, в котором будет храниться файл лога работы терминала BankTerminalOschadPAY.log, а также файл ApiDirectiriesJSON.txt в формате JSON, который является API-справочником и используется для расшифровки кодов ошибок, возвращаемых терминалом. Этот файл создается в момент получения информации по терминалу и желательно его периодически обновлять.

При настройке операции банковского терминала нужно добавить один Тип операции - Оплата_Возврат (рисунок 2).

операция банк терминала - ощад

Рисунок 2 - Добавление операции банковского терминала для Ощадбанка

Идентификатор терминала - TerminalID можно получить, вызвав действие Получить информацию с терминала кнопка Получение мерчанта торговца в списке терминалов (рисунок 3).

получить информацию про банк терминал - ощад

Рисунок 3 - Получить информацию о терминале

Особенностью данного протокола является формат хранения информации о транзакции, который используется при возврате. Это строка вида:

517131169475_PXXYKlnMd7M6WQlWXTydLzIrKvP6oN3v_33488

которая является группой из 3-х данных, разделенных символом «_»:

•первая группа - это RRN транзакции (непосредственно для возврата необязательный);

•вторая группа - токен транзакции;

•третья группа - идентификатор кассира.

В таком виде данные хранятся в финансовом документе и используются для возврата. Такая особенность идентификации транзакции оплаты обусловливает ограничение для возврата - невозможно выполнить возврат в ручном режиме по чеку (даже если оно есть). Возврат из Торгсофт возможен исключительно по чеку реализации и связанному с ним финансовому документу.