===== АКТУАЛЬНАЯ ИНСТРУКЦИЯ ПО ССЫЛКЕ =====
===Модуль WebMoney интеграции с Кассир в части сценария оплаты по QR кодам, возвращаемым с сервера WebMoney===
Платежная система WebMoney предоставляет возможность оплачивать покупки как шлюз через 4 платежные системы: СБП, WebMoney, WeChat, Alipay.
=====Сценарий оплаты=====
1) Клиент сообщает кассиру, что он желает оплатить покупку через QR код шлюза WebMoney и наименование платежной системы
2) Кассир выбирает соответствующий тип оплаты из предварительно заведенных через стандартный интерфейс
3) QR код полученный от сервера WebMoney - ФР распечатывает на чековой ленте или показывается на экране клиента.
4) Кассир передает клиенту распечатанный QR код (или выводится на экране клиента), клиент оплачивает его через приложение, соответствующее указанному типу оплаты
5) В это время программа Кассир в цикле опрашивает сервер WebMoney на предмет завершенного статуса транзакции. Если возвращается успешный статус, то покупка считается оплаченной, чек закрывается. Если возвращается ошибочный статус или истекает время ожидания оплаты, то на экран выводится ошибка и чек остается открытым
=====Настройка=====
====Настройка видов оплат Кассир 5====
Для добавления нового вида оплаты нужно выполнить команды: Настройка - закладка «Дополнительные» - кнопка «Настройка видов оплат».
В реквизите «Номер оплаты в ККМ» нужно указать значение от 2 до 13.
Названия видов оплат в ККМ задаются через драйвер ККМ.
Для ККМ Штрих-М: Настройка - закладка «Оборудование» - кнопка «Настройка ККМ» - В табличной части нажать кнопку «…» - кнопка «Настройка свойств» - кнопка «Таблицы» - выбрать «Наименования типов оплаты» - нажать «Открыть…» - задать соответсвующие наименования.
====Настройка платежной системы====
Для того, чтобы организовать оплату через одну из них нужно предварительно через стандартный интерфейс Кассир завести тип оплаты для каждого из желаемых типов (отдельно для СБП, отдельно для WebMoney и т.д.)
В настройке типов безналичных оплат выбрать модуль интеграции WebMoney, нажать настройки и там указать:
Режим работы: Оплата по qr чеку
Номер агента: согласно переданным данным от WebMoney
WMID: не имеет значения в данном сценарии, можно оставить 0
Номер POS: согласно переданным данным от WebMoney. От WebMoney также будет передан сертификат в формате pfx. Его нужно переименовать в <Номер POS>.pfx и положить в ту же директорию, что и модуль интеграции (WebMoneyPayManClient.dll)
Ключ агента: согласно переданным данным от WebMoney
CrsId: согласно переданным данным от WebMoney, либо оставить 0
Пароль сертификата: согласно переданным данным от WebMoney
Время ожидания ответа (сек): здесь задается общее время на проведение всей операции. Стоит обратить внимание, что время должно быть достаточно большим, чтобы кассир успел передать клиенту распечатанный qr код, а клиент его оплатить в приложении. Такая операция вряд ли займет менее 2 минут (120 секунд) в лучшем случае
Кол-во допустимых ошибок при запросе статуса (раз): здесь нужно указать сколько раз подряд допустим возврат технической ошибки от сервера WebMoney при опросе статуса оплаты. Технической ошибкой считается сбой связи, возврат HTTP кода отличного от 200 от сервера WebMoney и т.п. Возврат ошибочного статуса платежа не является технической ошибкой. Как только поступает хотя бы один ожидаемый ответ на запрос статуса платежа, счетчик сбрасывается и начинается заново. Интервал между запросами статуса составляет 5 секунд
Адрес сервера: здесь задается адрес сервера WebMoney (без дополнительного адреса сервиса)
Например если общая строка доступа выглядит как https://dev.runpay.com/PosIntegration2/ApiService.svc, то в адресе сервера нужно указать https://dev.runpay.com (без слеша в конце)
Адрес сервиса: здесь задается адрес сервиса на сервере WebMoney (без самого адреса сервера)
Например если общая строка доступа выглядит как https://dev.runpay.com/PosIntegration2/ApiService.svc, то в адресе сервиса нужно указать /PosIntegration2/ApiService.svc (слеш в начале важен)
Для настройки видов оплат нужно нажать кнопку Настроить виды оплат
В открывшемся окне будет таблица с 4 строками, по 1 на каждый поддерживаемый шлюзом WebMoney вид оплаты. В колонке Номер типа оплаты Кассира нужно указать Код (а не номер оплаты в ККМ) предварительно заведенного типа оплаты, соответствующий указанному в строке типу оплаты WebMoney.
После настройки видов оплат нужно нажать «Сохранить».
После завершения всех настроек нужно нажать «Сохранить» в форме настроек.
Файл с настройками типов оплат будет сохранен под именем WebMoneyPaymentTypes.txt и должен лежать в той же директории, что и модуль WebMoneyPayManClient.dll. Файл допускается редактировать в любом текстовом редакторе при условии сохранения формата.
Файл с настройками модуля интеграции будет сохранен под именем WebMoneySettings.txt и должен лежать в той же директории, что и модуль WebMoneyPayManClient.dll. Файл допускается редактировать в любом текстовом редакторе при условии сохранения формата.
После правильного указания настроек и типов оплат запросы будет отправляться на указанный адрес сервера WebMoney, с указанными параметрами
Таким образом для правильной работы модуля нужны 3 дополнительных файла с настройками и сертификатом в директории модуля WebMoneyPayManClient.dll:
<Номер POS>.pfx – сертификат торговой точки
WebMoneySettings.txt – настройки модуля интеграции
WebMoneyPaymentTypes.txt – настройки связки типов оплат Кассир с типами оплат модуля интеграции\\