PayMaster (API v2)

Для использования модуля оплаты PayMaster выполните настройку на стороне платёжной системы и подключите модуль в BILLmanager.

Поддержка способов оплаты
Банковские карты	Наличные	Электронные кошельки	Мобильные платежи	Интернет-банкинг

Mastercard, Visa, Мир, Unionpay
Поддерживаемые возможности
Поддержка ФЗ-54	Возврат платежей	Рекуррентные платежи		Подписки

Особенности работы

№ 54-ФЗ устанавливает требование о наличии в чеке наименований оплаченных товаров и услуг. Чтобы чеки формировались корректно в соответствии с законом, установите модуль Онлайн-кассы.
Поддерживается тестовый режим работы.

Настройка на стороне платёжной системы

На стороне PayMaster укажите данные:

Тип подписи — должен совпадать с выбранным в BILLmanager.
Секретный ключ — секретный ключ на стороне PayMaster.
Payment notification — POST. Адрес вида https://<адрес BILLmanager>/mancgi/pmasresult
Invoice Confirmation — не выполнять никаких действий.
Success redirect — https://<адрес BILLmanager>/billmgr?func=payment.success
Failure redirect — https://<адрес BILLmanager>/billmgr?func=payment.fail
Разрешена замена URL — опция должна быть включена.
Пользователь должен вернуться на сайт — опция должна быть отключена. В противном случае, если клиент откажется от перенаправления на сайт продавца, данные о платеже не будут переданы в BILLmanager.
Повторно отправлять Payment Notification при сбоях — опция должна быть включена.

Если вы планируете использовать рекуррентные платежи, настройте подпись Direct.

Настройка на стороне BILLmanager

Установка модуля производится из последней доступной версии продукта и влечёт за собой обновление платформы BILLmanager, так как версия модуля не может быть выше версии платформы.

Чтобы создать модуль оплаты, перейдите в раздел Провайдер → Методы оплаты → кнопка Создать:

Выбор модуля оплаты: "PayMaster".
Настройка интеграции:
1. Если у вас нет учётной записи Paymaster, активируйте опцию Создать нового клиента. Перейдите по ссылке и создайте нового клиента.
2. Укажите данные для интеграции:
  1. Идентификатор магазина — идентификатор учетной записи, под которым компания зарегистрирована в системе Paymaster.
  2. API-токен — секретный ключ для аутентификации запросов.
  3. Метод оплаты — укажите разрешённый метод оплаты. По умолчанию подключён метод Банковские карты.
  4. Тестовый режим — установите флажок, чтобы проверить работоспособность платёжного модуля. Paymaster не будет списывать деньги с карты за тестовые платежи.
  5. Получать уведомления от платёжной системы — чтобы активировать опцию, установите флажок и в поле Адрес уведомлений укажите URL-адрес, на который будут приходить уведомления.
  6. Рекуррентные платежи — включить использование рекуррентных платежей. Рекуррентные платежи в BILLmanager используются для автоматического пополнения лицевого счёта и для создания подписок.
  7. Страница возврата при автоплатеже в обработке — страница, которая откроется у клиента после того, как статус автоплатежа изменится на "обрабатывается".
  8. Разрешить возврат платежей — установите флажок, чтобы разрешить полный или частичный возврат платежей, совершённых с помощью Paymaster.
Настройка метода оплаты. Настройте внутренние (в пределах BILLmanager) параметры метода оплаты.
Подробнее см. шаг 3 в статье Настройка методов оплаты.

Возврат платежа

Настройка на стороне платежной системы

Войдите в ваш аккаунт PayMaster. В разделе "Пользователи" создайте нового пользователя со способом входа "Автоматический доступ". Пользователям должна быть назначена роль Операционист (получение статуса платежа и списка платежей) или Бухгалтер (Операционист + возврат платежа + список возвратов + подтверждение и отмена удержаний).

Настройка на стороне BILLmanager

В настройках метода оплаты включите опцию Разрешить возврат платежей. В качестве логина и пароля укажите данные ранее созданного пользователя.

Дополнительная информация

Модуль оплаты PayMaster записывает сведения о своей работе в лог-файлы:

/usr/local/mgr5/var/pmpaymasterv2.log — лог-файл настройки модуля оплаты, автоматических платежей и возвратов средств;
/usr/local/mgr5/var/paymasterv2payment.log — лог-файл оплаты;
/usr/local/mgr5/var/paymasterv2recurring.log — лог-файл активации сохранённых способов оплаты и автоматических платежей;
/usr/local/mgr5/var/paymasterv2notification.log — лог-файл проверки статуса платежей, сохранённых способов оплаты и автоматических платежей при получении уведомлений от PayMaster.