Документация BILLmanager 6 Startup, Advanced
Режим фокусировки

Сбербанк

Это документация неподдерживаемого продукта BILLmanager 6 Startup и BILLmanager 6 Advanced. Она не обновляется и может быть неактуальна. Документация для актуальной версии BILLmanager находится в разделе BILLmanager 6.

Для использования модуля оплаты Сбербанк зарегистрируйтесь в платёжной системе и настройте модуль оплаты на стороне BILLmanager. Чтобы зарегистрироваться в качестве продавца в Сбербанке, обратитесь в его службу технической поддержки. 

Поддержка способов оплаты
Банковские картыНаличныеЭлектронные кошелькиМобильные платежиИнтернет-банкинг
Mastercard,
Visa
Мир.
Терминалы,
банкоматы,
кассы банка,
системы приёма платежей.
QIWI Wallet,
WebMoney,
ЮMoney.
Билайн,
Мегафон
МТС,
Теле2.
Сбербанк Онлайн.
Поддерживаемые возможности
Поддержка ФЗ-54
Возврат платежей
Рекуррентные платежи
Подписки
Обратите внимание!
№ 54-ФЗ устанавливает требование о наличии в чеке наименований оплаченных товаров и услуг. Чтобы чеки формировались корректно в соответствии с законом вы должны установить модуль Онлайн-кассы. 
Обратите внимание!
Если на стороне платёжной системы для подключения по API установлен пароль по умолчанию, то его необходимо изменить для успешной настройки интеграции.

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

Модуль оплаты подключается в разделе Провайдер → Методы оплаты. Мастер подключения состоит из трёх шагов:

Шаг 1. Выберите модуль оплаты "Сбербанк".

Шаг 2. Укажите информацию, необходимую для интеграции с платёжной системой.

Шаг 3. Укажите внутренние (в пределах BILLmanager) параметры метода оплаты.

Настройка интеграции

Опция Клиент в платежной системе предлагает использовать существующий аккаунт на стороне платёжной системы или создать новый. При выборе значения "Использовать существующего" укажите на форме данные для интеграции:

  • Логин — логин продавца (провайдера услуг) для подключения к API платёжной системы;
  • Пароль — пароль продавца; 
  • Секретный ключ — ключ (токен) для возврата клиента в биллинговую платформу после оплаты. Для этого используется callback URL: "<URL BILLmanager>/mancgi/sbresult". Чтобы получить токен, обратитесь в техническую поддержку Сбербанка и сообщите ваш callback URL. В BILLmanager для callback-уведомлений используется симметричное шифрование;
  • Двухстадийная оплата — опция для активации двухстадийной оплаты. Такой способ требует от клиента дополнительное подтверждение списания средств с его карты. Чтобы использовать этот способ оплаты, обратитесь в техническую поддержку Сбербанка; 
  • Тестовый режим — опция для работы с платёжным модулем в тестовом режиме. В этом режиме не происходит списание средств и все платежи выполняются успешно. Подключение происходит не к основному API Сбербанка securepayments.sberbank.ru, а к тестовому API 3dsec.sberbank.ru. Подробнее о тестовом режиме см. в статье документации "Сбербанка" Порядок подключения к платёжному шлюзу.
  • Рекуррентные платежи — флаг разрешает использование рекуррентных платежей. Рекуррентные платежи в BILLmanager используются для автоматического пополнения лицевого счёта и для создания подписок.

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

    Если флаг активен, то укажите:

    • Страница возврата при успешном автоплатеже — страница, на которую будет перенаправлен плательщик при успешном автоплатеже. Используйте страницу BILLmanager https://domain.com/billmgr?func=payment.recurring.success или произвольную;
    • Страница возврата при неудачном автоплатеже — cтраница, на которую будет перенаправлен плательщик при неудачном автоплатеже. Используйте страницу BILLmanager https://domain.com/billmgr?func=payment.recurring.fail или произвольную.

      Пояснения
  • Если у вас подключён модуль Онлайн-кассы, укажите Способ отправки чеков:
    • не отправлять чеки;
    • отправка чеков платежной системой. По умолчанию, при отправке чеков через платёжную систему BILLmanager использует общую систему налогообложения (ОСНО). При включении опции "Использовать СНО метода оплаты" BILLmanager выбирает налоговую ставку, указанную в личном кабинете Сбербанка;
    • отправка через онлайн-кассу.

Выбор значения "Создать нового" отображает ссылку на форму регистрации в системе Сбербанк.

Перенаправление после оплаты

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

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

Отключение блока Фактический адрес при оплате

Чтобы при оплате блок Фактический адрес отображался в усечённом варианте измените порядок совершения оплаты: Провайдер → Глобальные настройки → Работа с плательщиками → активируйте опцию Метод оплаты, выбор плательщика.

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

Для возврата платежей активируйте соответствующий флаг в настройках метода оплаты: Провайдер → Методы оплаты → Изменить → блок Возврат и отмена платежей → флаг разрешить возврат платежей. 

Логирование

Логи взаимодействия биллинговой платформы со Сбербанк записываются в файлы:

  • /usr/local/mgr5/var/pmsberbank.log — лог-файл настройки модуля оплаты;
  • /usr/local/mgr5/var/sbpayment.log — лог-файл оплаты;
  • /usr/local/mgr5/var/sbresult.log — лог-файл получения ответа от платёжной системы.