Интернет-эквайринг напрямую от банка — Сбербанка, Т-Банка (Тинькофф) или Альфа-Банка — часто выгоднее агрегатора по ставке, но требует аккуратной настройки на стороне 1С-Битрикс. У каждого банка свой API, свои реквизиты доступа и свои нюансы фискализации, хотя логика подключения в модуле sale общая. Разбираем, что общего и что различается.
Эквайринг банка против агрегатора
При прямом интернет-эквайринге вы заключаете договор непосредственно с банком, и он обслуживает приём карт. В отличие от агрегатора (ЮKassa, Робокасса), деньги приходят напрямую на расчётный счёт, а ставка обычно ниже. Взамен вы получаете чуть более сложную интеграцию и поддержку от банка, а не от единого сервиса.
В 1С-Битрикс для каждого банка есть свой обработчик платёжной системы в модуле sale:
- Сбербанк — обработчик
sberbank(шлюз Сбербанк Эквайринг / RBS). - Т-Банк (Тинькофф) — обработчик
tinkoff, API с токеном подписи. - Альфа-Банк — обработчик
alfabank(шлюз на платформе RBS, близок к сбербанковскому).
Реквизиты доступа по банкам
Набор данных для настройки различается. Ниже — что запросить у банка перед началом работ:
| Банк | Реквизиты доступа | Особенность API |
|---|---|---|
| Сбербанк | Логин и пароль API-пользователя | Платформа RBS, отдельный тестовый шлюз |
| Т-Банк (Тинькофф) | Terminal Key и Secret Key (пароль) | Подпись Token по SHA-256 |
| Альфа-Банк | Логин и пароль API-пользователя | Платформа RBS, схож со Сбербанком |
Настройка обработчика в Битрикс
Логика одинаковая для всех трёх банков: Магазин → Платёжные системы → Добавить, выбираем нужный обработчик и заполняем реквизиты доступа. Общие шаги:
- Указываем логин/пароль (Сбер, Альфа) или Terminal Key + Secret Key (Т-Банк).
- Выбираем стадийность платежа — одностадийный (сразу списание) или двухстадийный (холдирование + подтверждение).
- Настраиваем фискализацию: ставку НДС, признаки предмета и способа расчёта.
- Включаем тестовый режим / тестовый шлюз на время отладки.
Callback и подтверждение оплаты
После оплаты банк уведомляет сайт о результате. Механика зависит от банка:
- Сбербанк / Альфа-Банк: статус заказа проверяется запросом
getOrderStatusпо идентификатору заказа банка (orderId), плюс можно настроить callback-уведомления. - Т-Банк (Тинькофф): банк шлёт нотификацию на указанный Notification URL, подпись проверяется по Token.
URL для приёма уведомлений в Битрикс традиционно указывает на обработчик:
https://ваш-домен.ru/bitrix/tools/sale_ps_result.php
Модуль сверяет сумму и статус, после чего помечает заказ оплаченным. Если callback не настроен или недоступен извне, оплаты будут «зависать» до ручной проверки статуса.
Двухстадийные платежи и возвраты
Двухстадийная схема (preauth) полезна, когда товар нужно сначала зарезервировать, а списать деньги только при отгрузке. Первая стадия — холдирование суммы на карте, вторая — подтверждение (списание) или отмена (разблокировка).
| Операция | Что происходит |
|---|---|
| Холд (авторизация) | Сумма блокируется на карте, но не списывается |
| Подтверждение | Заблокированная сумма списывается магазину |
| Отмена холда | Блокировка снимается, покупатель ничего не платит |
| Возврат | Списанные деньги возвращаются на карту |
В Битрикс возврат оформляется в карточке заказа — модуль отправляет банку запрос на возврат. При фискализации обязательно пробивается корректирующий чек «возврат прихода». Обратите внимание: у банков есть предельный срок холда, после которого блокировка снимается автоматически.
Фискализация 54-ФЗ при прямом эквайринге
Важный нюанс: прямой эквайринг банка — это только приём денег. Банк не обязан пробивать фискальный чек за вас, как это делает агрегатор. Значит, чеки чаще всего формирует ваша сторона.
- Чек пробивается через кассовую подсистему Битрикс (
Магазин → Настройки → Кассы ККМ) и подключённый ОФД. - Т-Банк умеет фискализировать на своей стороне, если передавать состав чека в запросе — это упрощает жизнь.
- Сбербанк и Альфа обычно требуют собственной кассы или отдельного фискального сервиса.
Итог
Подключение прямого эквайринга Сбербанка, Т-Банка и Альфа-Банка к 1С-Битрикс идёт через штатные обработчики модуля sale, но различается реквизитами доступа, адресами шлюзов и механикой уведомлений. Ключевые точки внимания — правильный шлюз (тест/бой), callback, стадийность платежа и схема фискализации по 54-ФЗ.
Мы в B2Bsite подключаем банковский эквайринг под ключ: настраиваем API-доступ, callback, двухстадийные платежи, возвраты и чеки, сверяем оплаты с 1С и сдаём связку после прогона реальных операций. Поможем выбрать банк с лучшей ставкой и корректно всё интегрировать.
Частые вопросы
Что выгоднее — прямой эквайринг банка или агрегатор?
Как правило, прямой эквайринг банка даёт более низкую ставку и деньги напрямую на расчётный счёт, но интеграция чуть сложнее. Агрегатор проще подключить и он часто сам фискализирует чеки. Выбор зависит от оборота и требований к скорости запуска.
Какие реквизиты нужны для подключения Т-Банка?
Для Т-Банка (Тинькофф) нужны Terminal Key и Secret Key из личного кабинета. На их основе формируется подпись Token по алгоритму SHA-256, которой авторизуются запросы к API.
Чем отличается настройка Сбербанка и Альфа-Банка?
Оба банка используют платформу RBS, поэтому логика близка: логин и пароль API-пользователя, проверка статуса через getOrderStatus. Различаются адреса шлюзов и реквизиты, поэтому настройки нельзя переносить один в один.
Что такое двухстадийный платёж и когда он нужен?
Это схема, где сумма сначала блокируется на карте (холд), а списывается только после подтверждения. Она удобна, когда нужно зарезервировать заказ и списать деньги лишь при отгрузке или подтверждении наличия товара.
Кто пробивает чек при прямом эквайринге?
Обычно ваша сторона: банк принимает деньги, а фискальный чек формирует кассовая подсистема Битрикс через ваш ОФД. Т-Банк умеет фискализировать сам, если передать ему состав чека.
Почему оплата в банке прошла, а заказ в Битрикс не оплачен?
Скорее всего не настроен или недоступен callback/Notification URL, либо модуль не смог проверить статус заказа. Проверьте доступность sale_ps_result.php извне и корректность подписи уведомления.
Нужно ли отдельно переключать тестовый и боевой режим?
Да. У Сбербанка и Альфа-Банка тестовый и боевой шлюзы имеют разные адреса API, поэтому при запуске недостаточно сменить логин — нужно переключить и URL шлюза, и снять тестовый режим.
Поможем с настройкой и поддержкой Интеграции и связки систем
Поможем с настройкой, доработкой и поддержкой Интеграции и связки систем.