Документация BILLmanager 6

Сбербанк

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

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

Mastercard,
Visa
Мир.
Терминалы,
банкоматы,
кассы банка,
системы приёма платежей.
WebMoney,
ЮMoney.
Билайн,
Мегафон
МТС,
Теле2.
Сбербанк Онлайн.
Поддерживаемые возможности
Поддержка ФЗ-54

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

Рекуррентные платежи

Подписки

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Логирование

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

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