Штрих-М: Документация

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
<del>[[https://kkm.solutions/images/PAY/PayMaster.zip|Актуальный драйвер для работы с WebMoney]] \\</del>
Актуальный драйвер скачивать тут: https://disk.yandex.ru/d/UGzX3T2WjYBthg\\

==== Модуль PayMaster (WebMoney) интеграции с Кассир в части сценария оплаты по QR кодам, возвращаемым с сервера PayMaster (WebMoney) ====
Платежный агрегатор PayMaster (WebMoney) предоставляет возможность оплачивать покупки через «Систему Быстрых Платежей» (СБП)\\

**Сценарий оплаты**\\
1) Клиент сообщает кассиру, что он желает оплатить покупку через «СБП»\\
2) Кассир выбирает соответствующий тип оплаты из предварительно заведенных через стандартный интерфейс – «СБП»\\
3) QR код полученный от сервера PayMaster - ФР распечатывает на чековой ленте или показывается на экране клиента.\\
4) Кассир передает клиенту распечатанный QR код (или показывается на экране клиента), клиент оплачивает его через мобильное приложение своего банка\\
5) В это время программа Кассир в цикле опрашивает сервер PayMaster (WebMoney) на предмет завершенного статуса транзакции. Если возвращается успешный статус, то покупка считается оплаченной, чек закрывается. Если возвращается ошибочный статус или истекает время ожидания оплаты, то на экран выводится ошибка и чек остается открытым\\

**Настройка**\\
Установить .net framework 4.8\\
Для вывода QR-кода требуется разархивировать (или выбрать при установке/обновлении или через мастер настроек) обработку из архива ExtFiles\LogicalModules\WebMoney.zip.\\
Настройка видов оплат Кассир 5\\
Для добавления нового вида оплаты нужно выполнить команды: Настройка - закладка «Дополнительные» - кнопка «Настройка видов оплат».\\
В реквизите «Номер оплаты в ККМ» нужно указать значение от 2 до 13.\\
Названия видов оплат в ККМ задаются через драйвер ККМ.\\
Для ККМ Штрих-М: Настройка - закладка «Оборудование» - кнопка «Настройка ККМ» - В табличной части нажать кнопку «…» - кнопка «Настройка свойств» - кнопка «Таблицы» - выбрать «Наименования типов оплаты» - нажать «Открыть…» - задать соответсвующие наименования.\\
\\
На закладке LogicalModules/WebMoney нужно выбрать желаемый способ показа QR-кода покупателю:\\
**Способ вывода QR кода для покупателя** - "Чековая лента", "Экран покупателя", "Чековая лента и экран покупателя".

**Лог СБП**\\
Файл лога записывается в \ExtFiles\ShtrihPayMan.Modules\WebMoney имя файла WebMoneyClient.log \\

**Настройка платежной системы**\\
Для того, чтобы организовать оплату через одну из них нужно предварительно через стандартный интерфейс Кассир завести тип оплаты для каждого из желаемых типов (отдельно для СБП, отдельно для Wechat Pay и т.д.)\\

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

{{:менеджер_оплат:настройка:wm1.jpg?400|}}\\

**Режим работы**: Оплата по статическому qr коду\\
**Номер агента**: 5350\\
**WMID**: 0\\
**Номер POS**: согласно переданным данным из личного кабинета от PayMaster\\
**Ключ агента**: согласно данным из личного кабинета PayMaster\\
**CrsId**: 0\\
**Пароль сертификата**: Не требуется\\
**Номер ККМ**: если подключено 1 юр.лицо, то вводится номер кассы (POSa), что указан в Настройка - Касса поле Номер кассы. Описание настройки нескольких юр.лиц далее в данной инструкции.\\ 
Время ожидания ответа (сек): здесь задается общее время на проведение всей операции. Стоит обратить внимание, что время должно быть достаточно большим, чтобы кассир успел передать клиенту распечатанный qr код, а клиент его оплатить в приложении. Такая операция вряд ли займет менее 2 минут (120 секунд) в лучшем случае\\
Кол-во допустимых ошибок при запросе статуса (раз): здесь нужно указать сколько раз подряд допустим возврат технической ошибки от сервера PayMaster при опросе статуса оплаты. Технической ошибкой считается сбой связи, возврат HTTP кода отличного от 200 от сервера PayMaster и т.п. Возврат ошибочного статуса платежа не является технической ошибкой. Как только поступает хотя бы один ожидаемый ответ на запрос статуса платежа, счетчик сбрасывается и начинается заново. Интервал между запросами статуса составляет 5 секунд\\
**Адрес сервера**: здесь задается адрес сервера PayMaster (без дополнительного адреса сервиса)\\
Например если общая строка доступа выглядит как https://paymaster.ru/qpay/ApiService.svc, то в адресе сервера нужно указать hhttps://paymaster.ru (без слеша в конце)\\
**Адрес сервиса**: здесь задается адрес сервиса на сервере WebMoney (без самого адреса сервера)\\
Например если общая строка доступа выглядит как https://paymaster.ru/qpay/ApiService.svc, то в адресе сервиса нужно /qpay/ApiService.svc (слеш в начале важен)\\

{{:менеджер_оплат:настройка:модули:wm2.jpg?400|}}\\

Для настройки видов оплат нужно нажать кнопку Настроить виды оплат\\
В открывшемся окне будет таблица с 4 строками, по 1 на каждый поддерживаемый шлюзом PayMaster вид оплаты.\\
В колонке **Номер типа оплаты Кассира** нужно указать Код (а не номер оплаты в ККМ) предварительно заведенного типа оплаты, соответствующий указанному в строке типу оплаты PayMaster.\\
После настройки видов оплат нужно нажать «Сохранить».\\
После завершения всех настроек нужно нажать «Сохранить» в форме настроек.\\


{{:менеджер_оплат:настройка:модули:wm4.jpg?200}} {{:менеджер_оплат:настройка:модули:wm3.jpg?600|}}\\


Файл с настройками типов оплат будет сохранен под именем WebMoneyPaymentTypes.txt и должен лежать в той же директории, что и модуль WebMoneyPayManClient.dll. Файл допускается редактировать в любом текстовом редакторе при условии сохранения формата.\\

Файл с настройками модуля интеграции будет сохранен под именем WebMoneySettings.txt и должен лежать в той же директории, что и модуль WebMoneyPayManClient.dll. Файл допускается редактировать в любом текстовом редакторе при условии сохранения формата.\\

После правильного указания настроек и типов оплат запросы будет отправляться на указанный адрес сервера PayMaster, с указанными параметрами\\

Таким образом для правильной работы модуля нужны 2 дополнительных файла с настройками в директории модуля WebMoneyPayManClient.dll:\\
WebMoneySettings.txt – настройки модуля интеграции\\
WebMoneyPaymentTypes.txt – настройки связки типов оплат Кассир с типами оплат модуля интеграции\\
\\
**ВАЖНО!** если используется 1 ФР, то флаг "Разрешить работу с несколькими ФР" необходимо СНЯТЬ.\\
\\
**Настройка на несколько юр.лиц**\\
В настройках процессинга вебмани добавить несколько настроек для подключений (для добавления новой настройки нажать +, для редактирования *, для удаления - )\\
В поле Номер ККМ вводится номер ККМ из справочника ККМ (Оборудование - Настройка ККМ) 
{{ :sbp:сбп_2юр.jpg?200 |}}
В настройках секций поле Банковский номер кассы, должен быть равен значению в поле Номер ККМ в настройках вебмани\\
{{ :sbp:сбп_настройкаккм.jpg?400 |}}
\\
**FAQ**\\
1. на ОС win 8.1 ( в отличии от win 7) в каталоге плагина webmoney должна быть библиотека System.Net.Http.dll (можно взять из netframework 4)\\ 
2. Если не создаётся файл reqnum, изменить путь к базе БД ( к папке webmoney) путь должен содержать только латиницу\\
3. Установить Microsoft Visual C++, есть вероятность, что без её установки не будет ставиться флаг при выборе процессинга "Webmoney" в настройках кассира