Для использования модуля оплаты SimplePay необходимо выполнить настройки на стороне платежной системы и подключить модуль в BILLmanager.
Настройка на стороне платежной систе
В личном кабинете системы SimplePay необходимо выполнить следующие настройки в разделе Торговые точки:
- Идентификатор торговой точки — идентификатор магазина, необходим для идентификации получателя платежа. Используется в настройках метода оплаты на стороне BILLmanager.
- URL торговой точки — URL адрес BILLmanager.
- Метод отправки запроса на Result URL — в качестве метода необходимо выбрать 'POST'.
- Секретный ключ точки — ключ для проверки подписей платежей. Используется в настройках метода оплаты на стороне BILLmanager.
- Секретный ключ для Result — ключ для проверки подписей платежей. Используется в настройках метода оплаты на стороне BILLmanager.
- Алгоритм хеширования подписи — в качестве алгоритма хеширования необходимо выбрать 'SHA256'.
- Тип API мерчанта — в качестве типа API мерчанта необходимо указать 'SimplePay'.
Поля Success URL, Fail URL, Result URL/e-mail заполнять не нужно, их значения передаются автоматически при совершении платежа.
Настройка на стороне BILLmanager
Подключение модуля оплаты выполняется в разделе Провайдер → Методы оплаты. Мастер подключения состоит из трех шагов:
- Шаг 1. Выбор метода оплаты. В качестве метода оплаты необходимо выбрать "SimplePay".
- Шаг 2. Настройка интеграции. Ввод информации, необходимой для интеграции с платежной системой.
- Шаг 3. Настройка метода оплаты. Настройка внутренних (в пределах BILLmanager) параметров метода оплаты.
Настройка интеграции
Идентификатор торговой точки — идентификатор торговой точки в SimplePay. Выдается при регистрации торговой точки.
Секретный ключ точки — секретный ключ точки в SimplePay. Выдается при регистрации торговой точки.
Секретный ключ для Result — секретный ключ для Result в SimplePay. Выдается при регистрации торговой точки.
Тестовый режим — опция включает использование тестового режима.
Рекуррентные платежи — опция включает использование рекуррентных платежей. При настройке автоплатежей со стороны клиента, будет автоматически выполнен платеж в 1 рубль. Это необходимо для подтверждения работоспособности банковской карты. По завершении процедуры активации рекуррентного платежа, он будет отменен. Рекуррентные платежи в BILLmanager используются для автоматического пополнения лицевого счёта и для создания подписок.
Дополнительная информация
Возврат платежей
Для возврата платежей необходимо активировать соответствующий флаг в настройках метода оплаты: Провайдер → Методы оплаты → кнопка Изменить.
Логирование
Логи взаимодействия биллинговой системы с SimplePay записываются в файлы:
- '/usr/local/mgr5/var/pmsimplepay.log' — лог файл настройки модуля оплаты и проведения возвратов и рекуррентных платежей.
- '/usr/local/mgr5/var/simplepaypayment.log' — лог файл оплаты.
- '/usr/local/mgr5/var/simplepayresult.log' — лог файл получения ответа от платежной системы.
- '/usr/local/mgr5/var/simplepayrecurring.log' — лог файл настройки рекуррентных платежей.
- '/usr/local/mgr5/var/simplepayrecurringresult.log' — лог файл получения ответа от платежной системы при настройке рекуррентных платежей.