Инструменты пользователя
Это старая версия документа!
Актуальный драйвер для работы с WebMoney
Платежная система WebMoney предоставляет возможность оплачивать покупки как шлюз через СБП.
Сценарий оплаты
1) Клиент сообщает кассиру, что он желает оплатить покупку через СПБ шлюза WebMoney
2) Кассир выбирает соответствующий тип оплаты из предварительно заведенных через стандартный интерфейс
3) ФР распечатывает на чековой ленте QR код полученный от сервера WebMoney.
4) Кассир передает клиенту распечатанный QR код, клиент оплачивает его через приложение, соответствующее указанному типу оплаты
5) В это время программа Кассир в цикле опрашивает сервер WebMoney на предмет завершенного статуса транзакции. Если возвращается успешный статус, то покупка считается оплаченной, чек закрывается. Если возвращается ошибочный статус или истекает время ожидания оплаты, то на экран выводится ошибка и чек остается открытым
Настройка
Для вывода QR-кода требуется разархивировать (или выбрать при установке/обновлении или через мастер настроек) обработку из архива ExtFiles\LogicalModules\WebMoney.zip.
Настройка видов оплат Кассир 5
Для добавления нового вида оплаты нужно выполнить команды: Настройка - закладка «Дополнительные» - кнопка «Настройка видов оплат».
В реквизите «Номер оплаты в ККМ» нужно указать значение от 2 до 13.
Названия видов оплат в ККМ задаются через драйвер ККМ.
Для ККМ Штрих-М: Настройка - закладка «Оборудование» - кнопка «Настройка ККМ» - В табличной части нажать кнопку «…» - кнопка «Настройка свойств» - кнопка «Таблицы» - выбрать «Наименования типов оплаты» - нажать «Открыть…» - задать соответсвующие наименования.
На закладке LogicalModules/WebMoney нужно выбрать желаемый способ показа QR-кода покупателю:
Способ вывода QR кода для покупателя - «Чековая лента», «Экран покупателя», «Чековая лента и экран покупателя».
Настройка платежной системы
В настройке типов безналичных оплат выбрать модуль интеграции 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://paymaster.ru/qpay/ApiService.svc, то в адресе сервера нужно указать https://paymaster.ru (без слеша в конце)
Адрес сервиса: здесь задается адрес сервиса на сервере WebMoney (без самого адреса сервера)
Например если общая строка доступа выглядит как https://paymaster.ru/qpay/ApiService.sv, то в адресе сервиса нужно указать /qpay/ApiService.sv (слеш в начале важен)
Для настройки видов оплат нужно нажать кнопку Настроить виды оплат
В открывшемся окне будет таблица с 4 строками, по 1 на каждый поддерживаемый шлюзом WebMoney вид оплаты.
В колонке Номер типа оплаты Кассира нужно указать Код (а не номер оплаты в ККМ) предварительно заведенного типа оплаты, соответствующий указанному в строке типу оплаты WebMoney.
После настройки видов оплат нужно нажать «Сохранить».
После завершения всех настроек нужно нажать «Сохранить» в форме настроек.
Файл с настройками типов оплат будет сохранен под именем WebMoneyPaymentTypes.txt и должен лежать в той же директории, что и модуль WebMoneyPayManClient.dll. Файл допускается редактировать в любом текстовом редакторе при условии сохранения формата.
Файл с настройками модуля интеграции будет сохранен под именем WebMoneySettings.txt и должен лежать в той же директории, что и модуль WebMoneyPayManClient.dll. Файл допускается редактировать в любом текстовом редакторе при условии сохранения формата.
После правильного указания настроек и типов оплат запросы будет отправляться на указанный адрес сервера WebMoney, с указанными параметрами
Таким образом для правильной работы модуля нужны 3 дополнительных файла с настройками и сертификатом в директории модуля WebMoneyPayManClient.dll:
<Номер POS>.pfx – сертификат торговой точки
WebMoneySettings.txt – настройки модуля интеграции
WebMoneyPaymentTypes.txt – настройки связки типов оплат Кассир с типами оплат модуля интеграции
