Инструменты пользователя

Инструменты сайта


sbp:sbp

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
sbp:sbp [2022/01/28 15:15]
dzayonchkovskiy
sbp:sbp [2023/03/22 14:07] (текущий)
prohorov
Строка 1: Строка 1:
-[[https://cloud.mail.ru/public/ruM6/64zfrz2ib|Актуальный драйвер для работы с WebMoney]] \\ +<del>[[https://kkm.solutions/images/PAY/PayMaster.zip|Актуальный драйвер для работы с WebMoney]] \\</del> 
-Платежная система WebMoney предоставляет возможность оплачивать покупки как шлюз через СБП.\\+Актуальный драйвер скачивать тут: https://disk.yandex.ru/d/UGzX3T2WjYBthg\\ 
 + 
 +==== Модуль PayMaster (WebMoney) интеграции с Кассир в части сценария оплаты по QR кодам, возвращаемым с сервера PayMaster (WebMoney) ==== 
 +Платежный агрегатор PayMaster (WebMoney) предоставляет возможность оплачивать покупки через «Систему Быстрых Платежей» (СБП)\\
  
 **Сценарий оплаты**\\ **Сценарий оплаты**\\
-1) Клиент сообщает кассиру, что он желает оплатить покупку через СПБ шлюза WebMoney\\ +1) Клиент сообщает кассиру, что он желает оплатить покупку через «СБП»\\ 
-2) Кассир выбирает соответствующий тип оплаты из предварительно заведенных через стандартный интерфейс\\ +2) Кассир выбирает соответствующий тип оплаты из предварительно заведенных через стандартный интерфейс – «СБП»\\ 
-3) ФР распечатывает на чековой ленте QR код полученный от сервера WebMoney.\\ +3) QR код полученный от сервера PayMaster - ФР распечатывает на чековой ленте или показывается на экране клиента.\\ 
-4) Кассир передает клиенту распечатанный QR код, клиент оплачивает его через приложениесоответствующее указанному типу оплаты\\ +4) Кассир передает клиенту распечатанный QR код (или показывается на экране клиента), клиент оплачивает его через мобильное приложение своего банка\\ 
-5) В это время программа Кассир в цикле опрашивает сервер WebMoney на предмет завершенного статуса транзакции. Если возвращается успешный статус, то покупка считается оплаченной, чек закрывается. Если возвращается ошибочный статус или истекает время ожидания оплаты, то на экран выводится ошибка и чек остается открытым\\+5) В это время программа Кассир в цикле опрашивает сервер PayMaster (WebMoneyна предмет завершенного статуса транзакции. Если возвращается успешный статус, то покупка считается оплаченной, чек закрывается. Если возвращается ошибочный статус или истекает время ожидания оплаты, то на экран выводится ошибка и чек остается открытым\\
  
 **Настройка**\\ **Настройка**\\
 +Установить .net framework 4.8\\
 Для вывода QR-кода требуется разархивировать (или выбрать при установке/обновлении или через мастер настроек) обработку из архива ExtFiles\LogicalModules\WebMoney.zip.\\ Для вывода QR-кода требуется разархивировать (или выбрать при установке/обновлении или через мастер настроек) обработку из архива ExtFiles\LogicalModules\WebMoney.zip.\\
 Настройка видов оплат Кассир 5\\ Настройка видов оплат Кассир 5\\
Строка 19: Строка 23:
 На закладке LogicalModules/WebMoney нужно выбрать желаемый способ показа QR-кода покупателю:\\ На закладке LogicalModules/WebMoney нужно выбрать желаемый способ показа QR-кода покупателю:\\
 **Способ вывода QR кода для покупателя** - "Чековая лента", "Экран покупателя", "Чековая лента и экран покупателя". **Способ вывода QR кода для покупателя** - "Чековая лента", "Экран покупателя", "Чековая лента и экран покупателя".
 +
 +**Лог СБП**\\
 +Файл лога записывается в \ExtFiles\ShtrihPayMan.Modules\WebMoney имя файла WebMoneyClient.log \\
  
 **Настройка платежной системы**\\ **Настройка платежной системы**\\
 +Для того, чтобы организовать оплату через одну из них нужно предварительно через стандартный интерфейс Кассир завести тип оплаты для каждого из желаемых типов (отдельно для СБП, отдельно для Wechat Pay и т.д.)\\
 +
 В настройке типов безналичных оплат выбрать модуль интеграции WebMoney, нажать настройки и там указать: В настройке типов безналичных оплат выбрать модуль интеграции WebMoney, нажать настройки и там указать:
  
Строка 26: Строка 35:
  
 **Режим работы**: Оплата по статическому qr коду\\ **Режим работы**: Оплата по статическому qr коду\\
-**Номер агента**: согласно переданным данным от WebMoney\\ +**Номер агента**: 5350\\ 
-**WMID**: не имеет значения в данном сценарии, можно оставить 0\\ +**WMID**: 0\\ 
-**Номер POS**: согласно переданным данным от WebMoney. От WebMoney также будет передан сертификат в формате pfx.\\ Его нужно переименовать в <Номер POS>.pfx и положить в ту же директорию, что и модуль интеграции (WebMoneyPayManClient.dll)\\ +**Номер POS**: согласно переданным данным из личного кабинета от PayMaster\\ 
-**Ключ агента**: согласно переданным данным от WebMoney\\ +**Ключ агента**: согласно данным из личного кабинета PayMaster\\ 
-**CrsId**: согласно переданным данным от WebMoney, либо оставить 0\\ +**CrsId**: 0\\ 
-**Пароль сертификата**: согласно переданным данным от WebMoney\\+**Пароль сертификата**: Не требуется\\ 
 +**Номер ККМ**: если подключено 1 юр.лицо, то вводится номер кассы (POSa), что указан в Настройка - Касса поле Номер кассы. Описание настройки нескольких юр.лиц далее в данной инструкции.\\ 
 Время ожидания ответа (сек): здесь задается общее время на проведение всей операции. Стоит обратить внимание, что время должно быть достаточно большим, чтобы кассир успел передать клиенту распечатанный qr код, а клиент его оплатить в приложении. Такая операция вряд ли займет менее 2 минут (120 секунд) в лучшем случае\\ Время ожидания ответа (сек): здесь задается общее время на проведение всей операции. Стоит обратить внимание, что время должно быть достаточно большим, чтобы кассир успел передать клиенту распечатанный qr код, а клиент его оплатить в приложении. Такая операция вряд ли займет менее 2 минут (120 секунд) в лучшем случае\\
-Кол-во допустимых ошибок при запросе статуса (раз): здесь нужно указать сколько раз подряд допустим возврат технической ошибки от сервера WebMoney при опросе статуса оплаты. Технической ошибкой считается сбой связи, возврат HTTP кода отличного от 200 от сервера WebMoney и т.п. Возврат ошибочного статуса платежа не является технической ошибкой. Как только поступает хотя бы один ожидаемый ответ на запрос статуса платежа, счетчик сбрасывается и начинается заново. Интервал между запросами статуса составляет 5 секунд\\ +Кол-во допустимых ошибок при запросе статуса (раз): здесь нужно указать сколько раз подряд допустим возврат технической ошибки от сервера PayMaster при опросе статуса оплаты. Технической ошибкой считается сбой связи, возврат HTTP кода отличного от 200 от сервера PayMaster и т.п. Возврат ошибочного статуса платежа не является технической ошибкой. Как только поступает хотя бы один ожидаемый ответ на запрос статуса платежа, счетчик сбрасывается и начинается заново. Интервал между запросами статуса составляет 5 секунд\\ 
-**Адрес сервера**: здесь задается адрес сервера WebMoney (без дополнительного адреса сервиса)\\ +**Адрес сервера**: здесь задается адрес сервера PayMaster (без дополнительного адреса сервиса)\\ 
-Например если общая строка доступа выглядит как https://paymaster.ru/qpay/ApiService.svc, то в адресе сервера нужно указать https://paymaster.ru (без слеша в конце)\\+Например если общая строка доступа выглядит как https://paymaster.ru/qpay/ApiService.svc, то в адресе сервера нужно указать hhttps://paymaster.ru (без слеша в конце)\\
 **Адрес сервиса**: здесь задается адрес сервиса на сервере WebMoney (без самого адреса сервера)\\ **Адрес сервиса**: здесь задается адрес сервиса на сервере WebMoney (без самого адреса сервера)\\
-Например если общая строка доступа выглядит как https://paymaster.ru/qpay/ApiService.sv, то в адресе сервиса нужно указать /qpay/ApiService.sv (слеш в начале важен)\\+Например если общая строка доступа выглядит как https://paymaster.ru/qpay/ApiService.svc, то в адресе сервиса нужно /qpay/ApiService.svc (слеш в начале важен)\\
  
 {{:менеджер_оплат:настройка:модули:wm2.jpg?400|}}\\ {{:менеджер_оплат:настройка:модули:wm2.jpg?400|}}\\
  
 Для настройки видов оплат нужно нажать кнопку Настроить виды оплат\\ Для настройки видов оплат нужно нажать кнопку Настроить виды оплат\\
-В открывшемся окне будет таблица с 4 строками, по 1 на каждый поддерживаемый шлюзом WebMoney вид оплаты.\\ +В открывшемся окне будет таблица с 4 строками, по 1 на каждый поддерживаемый шлюзом PayMaster вид оплаты.\\ 
-В колонке **Номер типа оплаты Кассира** нужно указать Код (а не номер оплаты в ККМ) предварительно заведенного типа оплаты, соответствующий указанному в строке типу оплаты WebMoney.\\+В колонке **Номер типа оплаты Кассира** нужно указать Код (а не номер оплаты в ККМ) предварительно заведенного типа оплаты, соответствующий указанному в строке типу оплаты PayMaster.\\
 После настройки видов оплат нужно нажать «Сохранить».\\ После настройки видов оплат нужно нажать «Сохранить».\\
 После завершения всех настроек нужно нажать «Сохранить» в форме настроек.\\ После завершения всех настроек нужно нажать «Сохранить» в форме настроек.\\
Строка 55: Строка 65:
 Файл с настройками модуля интеграции будет сохранен под именем WebMoneySettings.txt и должен лежать в той же директории, что и модуль WebMoneyPayManClient.dll. Файл допускается редактировать в любом текстовом редакторе при условии сохранения формата.\\ Файл с настройками модуля интеграции будет сохранен под именем WebMoneySettings.txt и должен лежать в той же директории, что и модуль WebMoneyPayManClient.dll. Файл допускается редактировать в любом текстовом редакторе при условии сохранения формата.\\
  
-После правильного указания настроек и типов оплат запросы будет отправляться на указанный адрес сервера WebMoney, с указанными параметрами\\+После правильного указания настроек и типов оплат запросы будет отправляться на указанный адрес сервера PayMaster, с указанными параметрами\\
  
-Таким образом для правильной работы модуля нужны дополнительных файла с настройками и сертификатом в директории модуля WebMoneyPayManClient.dll:\\ +Таким образом для правильной работы модуля нужны дополнительных файла с настройками в директории модуля WebMoneyPayManClient.dll:\\
-<Номер POS>.pfx – сертификат торговой точки\\+
 WebMoneySettings.txt – настройки модуля интеграции\\ WebMoneySettings.txt – настройки модуля интеграции\\
 WebMoneyPaymentTypes.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" в настройках кассира  
sbp/sbp.1643382937.txt.gz · Последнее изменение: 2022/01/28 15:15 — dzayonchkovskiy