Модуль Sberbank (АО "Сбербанк")

Назначение модуля

Модуль биллинга Sberbank предназначен для оплаты картами через процессинг АО "Сбербанка".

Модуль работает по защищенному протоколу https с использованием шифрования SSL, что исключает возможность перехвата информации и нарушения целостности данных третьими лицами.

Настройка модуля

Установите модуль на сервер, обновите клиент. Затем создайте экземпляр модуля. Создайте в редакторе конфигурации модуля новую конфигурацию, пропишите необходимые параметры. После этого сохраните конфигурацию и сделайте её активной.

images/download/attachments/43385713/sberbank_config.png

В настройках Личного кабинета на сайте АО "Сбербанка" необходимо прописать Callback URL (merchant-url}) для оповещения о статусах транзакций, в формате

http[s]://host[:port]/bgbilling/sberbank/<код_модуля>

Модуль имеет несколько встроенных задач для планировщика: для периодических автоплатежей (необходимо настроить если используются периодические автоплатежи) и проверка статуса транзакций (рекомендуется настроить для периодичской проверки статуса платежей, необработанных по каким либо причинам другими способами)

Оплата через Личный кабинет

Если у клиента подключен экземпляр модуля в дереве договора, то он может осуществлять оплату через шлюз АО "Сбербанк", используя личный web-интерфейс.

В личном кабинете на странице отображается история платежей, совершенных клиентом:

images/download/attachments/43385713/sberbank_web.png

Над таблицей с историей платежей расположена форма для совершения нового платежа. Чтобы осуществить платеж, необходимо заполнить обязательные поля Сумма. Далее необходимо нажать кнопку Оплатить и подтвердить. После подтверждения клиент попадает на страницу c формой ввода реквизитов карты на сайте Сбербанка.

После оплаты (или отмены), клиент будет перенаправлен на страницу, указанную в конфигурации модуля в параметре sberbank.rest.return.url .

Мониторинг платежей

В клиенте билинга есть возможность отслеживать историю платежей по каждому абоненту. Для этого необходимо выбрать модуль Sberbank в дереве параметров договора. Здесь присутствует фильтр по статусу платежей с указанием периода, когда производилась оплата.

images/download/attachments/43385713/sberbank_contract.png

Для просмотра ВСЕХ платежей, проведенных с использованием модуля Sberbank, существует глобальный монитор транзакций в параметрах данного модуля биллинга (Модули -> Модуль Sberbank). На открывшейся вкладке у Вас есть возможность просмотреть все платежи, совершенные вашими абонентами за указанный временной период. Также можно установить фильтр платежей по имени договора, по статусу.

Настройка рекурентных платежей (автоплатежи)

Модуль поддерживает автоплатежи. Для активации этой возможности, первое что нужно сделать, это связаться с сотрудниками Сбербанка для того что бы они настроили неоходимые параметры со своей стороны и предоставили вам дополнительные данные для настройки в биллинге. После получения необходимых данных внесите их в конфигурацию модуля.

Модуль поддерживает три режима работы (каждый режим может включается/выключатся независимо от других ):

1) Еженедельные платежи, клиенты через ЛК могут задать день недели и сумму, которая будет автоматически списываться с их карты.

2) Ежемесячные платежи, аналогично первому режиму, клиент задает день месяца и сумму.

Эти режимы не зависят от текущего состояния баланса клиентов, в указаный момент модуль будет пытаться пополнить баланс на заданную сумму. Есть возможность подменить сумму заданную клиентом, с помощью обработки соответствующего события. Для работы данных режимов должна быть настроена задача планировщика (частота запуска, раз в сутки)

3) Автоматический режим, при выборе этого режима, момент списания и сумма задаются скриптом по алгоритму провайдера (скрипт кидает событие с данными, какой договор и на какую сумму необходимо пополнить). В данном режиме также возможно выполнить автоплатеж из АРМа(админки биллинга) в ручном режиме.

Алгоритм работы автоплатежей:

Для активации автоплатежа клиент в ЛК задает параметры автоплатежа, после чего сервер биллинга посылает запрос регистрации (order.do) на сервер Сбербанка в запрос добавляется параметр clientId сигнализируюший о том что нужно создать связку для дальнейшего использования при автоплатежах. В ответ на этот запрос возращается URL на который нужно перенаправить клиента для совершения платежа. После перехода клиента по указаному URL, ввода данных карты и совершения оплаты, клиент возращается в ЛК. При возращение в ЛК биллинг посылает запрос статуса (getOrderStatus.do) платежа на сервер Сбербанка. В ответе на этот запрос, если платеж завершился удачно и в запросе регистрации присутствовал параметр clientId, должны присутствовать параметры clientId и bindingId. Параметр bindingId и есть связка, которую надо использовать при автоплатежах, это связка сохраняется в БД в таблице sberbank_autopayment_<mid> в поле access_token.