Подключение Сбербанк Онлайн (эквайринг)

Интернет-эквайринг Сбербанка — один из самых распространённых способов принимать оплату картами в российских магазинах на 1С-Битрикс. В платформе есть штатный обработчик, который работает через REST API банка, поэтому подключение сводится к получению доступа в личном кабинете эквайринга и аккуратной настройке платёжной системы. Ниже — маршрут, по которому мы обычно заводим приём карт через Сбербанк на проектах.

Что такое эквайринг Сбербанка и что нужно на старте

Интернет-эквайринг Сбербанка — это приём оплаты банковскими картами (Visa, Mastercard, «Мир») с переадресацией покупателя на защищённую платёжную страницу банка. Магазин не хранит и не обрабатывает данные карт — всё происходит на стороне Сбербанка, что снимает с сайта основную нагрузку по требованиям PCI DSS.

Взаимодействие идёт по REST-протоколу: Битрикс обращается к методам API банка (register.do для регистрации заказа, getOrderStatusExtended.do для проверки статуса), получает ссылку на форму оплаты и переводит на неё покупателя. После оплаты банк возвращает клиента обратно на сайт.

Чтобы начать, понадобится:

• заключённый договор интернет-эквайринга со Сбербанком и открытый расчётный счёт;
• доступ в личный кабинет эквайринга (кабинет мерчанта);
• созданный API-пользователь — отдельная учётная запись для программного доступа;
• редакция 1С-Битрикс с модулем Интернет-магазин (sale).

Шаг 1. Получение API-доступа в кабинете эквайринга

Настройка на стороне Битрикса бесполезна без корректных реквизитов доступа. Их выдаёт банк, а не студия. В личном кабинете эквайринга создаётся API-пользователь — логин для него по соглашению обычно оканчивается на -api (например, shop_id-api), а вход по нему возможен только программно, не через веб-интерфейс.

Вам потребуются два ключевых параметра:

• Логин API (userName) — имя API-пользователя;
• Пароль API (password) — пароль этой учётной записи.

Отдельно у Сбербанка существует два независимых контура: тестовый (шлюз 3dsec.sberbank.ru) и боевой (securepayments.sberbank.ru). Логины и пароли в них разные — тестовые реквизиты на продакшене не работают, и наоборот.

Шаг 2. Добавление платёжной системы в Битриксе

Перейдите в Магазин → Настройки → Платёжные системы и нажмите «Добавить платёжную систему». На вкладке параметров заполните базовые поля:

1. Название и код — например, «Оплата картой (Сбербанк)» и sberbank.
2. Обработчик — выберите из списка «Сбербанк» (в разных сборках может называться «Сбербанк: интернет-эквайринг»).
3. Тип плательщика — привяжите систему к нужным типам (обычно «Физическое лицо»).
4. Активность — включите после проверки.

Ниже, в блоке настроек обработчика, укажите реквизиты доступа:

Сумму заказа обработчик передаёт в банк в копейках — это делается автоматически, но об этом стоит помнить при разборе логов. Проверьте, что в свойствах заказа корректно проставлен email покупателя: он нужен для отправки чека и уведомлений банка.

Шаг 3. Одностадийная и двухстадийная оплата

Сбербанк поддерживает две схемы списания, и выбор влияет на бизнес-логику магазина.

• Одностадийная (метод register.do) — деньги списываются с карты сразу в момент оплаты. Подходит для товаров, которые всегда в наличии.
• Двухстадийная (registerPreAuth.do + deposit.do) — сначала на карте холдируется (блокируется) сумма, а фактическое списание происходит позже, когда вы подтверждаете заказ. Неподтверждённый холд автоматически разблокируется.

Двухстадийная схема удобна, когда наличие товара подтверждается вручную или зависит от остатков в 1С: вы не берёте деньги за то, что не сможете отгрузить. Режим включается в настройках обработчика отдельным параметром, но двухстадийную оплату нужно предварительно активировать на стороне банка — иначе холд-запросы вернут ошибку.

Шаг 4. Фискализация чеков по 54-ФЗ

Приём онлайн-оплаты обязывает пробивать кассовый чек по 54-ФЗ. Здесь есть два принципиально разных подхода, и их важно не смешивать.

• Чек на стороне Сбербанка. Если у вас подключён сервис фискализации от банка, Битрикс передаёт состав корзины в объекте orderBundle, и чек формирует банк со своей онлайн-кассой.
• Чек на стороне Битрикса. Магазин сам печатает чек через модуль «Кассы» (Магазин → Кассы → Список касс), подключённый к оператору фискальных данных (ОФД).

В обоих случаях у каждой позиции корзины должны быть корректно заданы ставка НДС и признак предмета/способа расчёта — иначе чек либо не пробьётся, либо уйдёт с неверными реквизитами. Настраивается это в Магазин → Настройки → Налоги и в параметрах кассы.

Шаг 5. Возвраты платежей

Эквайринг Сбербанка поддерживает полный и частичный возврат средств прямо из административной части. За это отвечает метод API refund.do, который обработчик вызывает при оформлении возврата по оплате в карточке заказа.

Технически возврат инициируется в разделе Магазин → Заказы: открываете заказ, переходите к оплате и оформляете возврат на нужную сумму. Битрикс отправляет запрос в банк, и при успехе деньги возвращаются на карту покупателя.

• Полный возврат отменяет весь платёж.
• Частичный возврат возвращает часть суммы — например, за одну позицию из заказа.

Если по платежу пробивался чек по 54-ФЗ, возврат должен сопровождаться чеком возврата прихода — учтите это в настройках кассы, чтобы фискальная отчётность оставалась корректной.

Шаг 6. Тестирование и диагностика ошибок

Перед запуском обязательно прогоните оплату на тестовом контуре (3dsec.sberbank.ru) с тестовыми реквизитами API. Банк предоставляет специальные тестовые карты, на которых можно сымитировать успешную оплату, отказ и прохождение 3-D Secure без реального списания.

Порядок проверки:

1. Оформите тестовый заказ и выберите платёжную систему Сбербанка.
2. Убедитесь, что происходит переадресация на форму оплаты банка.
3. Оплатите тестовой картой и проверьте, что заказ в Битриксе перешёл в статус «оплачен».
4. Проверьте возврат на возможность отмены платежа.

Если что-то не работает, диагностику начинайте с журнала обработчика: включите логирование в настройках платёжной системы — в лог пишутся запросы к API и ответы банка с кодами ошибок.

Итог

Подключение эквайринга Сбербанка в 1С-Битрикс — это последовательность: получить API-доступ в кабинете эквайринга, добавить платёжную систему с обработчиком «Сбербанк», прописать логин и пароль API, выбрать схему списания (одно- или двухстадийную), настроить фискализацию по 54-ФЗ и возвраты, а затем прогнать всё на тестовом контуре. Большинство проблем при запуске сводятся к путанице между тестовыми и боевыми реквизитами, невключённой двухстадийной оплате и задвоенным чекам.

Если магазин интегрирован с 1С, использует двухстадийные платежи или сложную фискализацию по нескольким кассам, настройку безопаснее доверить интеграторам. Мы в B2Bsite подключаем и отлаживаем платёжные системы на 1С-Битрикс, увязываем оплату с обменом заказами и остатками в 1С и следим, чтобы деньги, чеки и статусы заказов всегда сходились.