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

Сбербанк

Для использования модуля оплаты Сбербанк зарегистрируйтесь в платёжной системе и настройте модуль оплаты на стороне 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 — лог-файл получения ответа от платёжной системы.