Интеграция Сбер Pay QR и InSales

Что такое Сбер Pay QR

Сбер Pay QR — это оплата по QR-коду через приложение СберБанк Онлайн и Систему Быстрых Платежей (СБП).

Принимаются карты Сбербанка и карты банков-участников СБП. Покупатель сканирует QR-код или переходит по ссылке, оплачивает в приложении банка.

Как это работает

На мобильном устройстве

Покупатель выбирает "Сбер Pay QR" на странице оплаты. Нажимает кнопку, переходит по ссылке в приложение СберБанк Онлайн. Оплачивает заказ.

На компьютере

Покупатель видит QR-код на экране. Сканирует его камерой телефона через приложение СберБанк Онлайн. Подтверждает оплату в приложении.

Уникальный QR для каждого заказа

Каждый QR-код создается индивидуально. Содержит сумму транзакции, номер заказа, информацию о продавце. После оплаты QR-код становится неактивным.

Процесс подключения

Для работы с Сбер Pay QR нужно пройти регистрацию в личном кабинете разработчика Сбербанка и получить доступ к API.

Этапы подключения

Регистрация в личном кабинете разработчика: auth.developer.sber.ru
Заключение соглашения с Сбербанком
Заполнение Анкеты продукта QR СБП
Переход в режим "Организации" после привязки договора
Создание приложения и получение сертификата
Получение учетных данных: ClientId и ClientSecret
Подписка на тариф "QR для Продавца" API v3.0

Важно: безопасность учетных данных

ClientId и ClientSecret — секретные ключи. Храните их на сервере, никогда не передавайте в коде страницы. Если ключи попадут в открытый доступ, злоумышленники смогут создавать платежи от вашего имени.

Техническая реализация

Внешний сервис оплаты

Создали внешний способ оплаты в InSales. Платежи обрабатываются через серверное приложение — ключи API не попадают в браузер.

Учет статуса СБП

В заказах InSales добавили поля для хранения:

ID платежа от Сбербанка
Статус оплаты (создан, оплачен, отменен, возврат)
Ссылка на QR-код
Время создания платежа

Webhook для уведомлений

Настроили webhook — Сбербанк отправляет уведомления о статусе платежа. Когда покупатель оплачивает, сервер получает уведомление и обновляет статус заказа в InSales.

Это работает, даже если покупатель не вернулся на сайт после оплаты.

Обработка возвратов и отмен

Система реагирует на все изменения статуса:

Создан — платеж инициирован, ожидаем оплату
Оплачен — деньги получены, заказ в работу
Отменен — покупатель отменил платеж
Возврат — деньги возвращены покупателю

MemberID для операций

MemberID — идентификатор точки продаж в системе Сбербанка. Используется для подключения сервиса уведомлений и проведения операций.

API Сбербанка

Используем API v3.0 "QR для Продавца". Основные методы:

Создание платежа

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

Проверка статуса

Метод возвращает текущий статус платежа. Используем для проверки, оплатил ли покупатель заказ.

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

Метод для возврата денег покупателю. Можно вернуть полную сумму или частично.

Безопасность

Все операции с API выполняются на сервере
ClientId и ClientSecret хранятся в защищенном окружении
В коде страницы нет секретных ключей
Webhook подписывается цифровой подписью для проверки подлинности
QR-коды одноразовые — после оплаты становятся неактивными

Результат

Покупатели оплачивают через привычное приложение СберБанк Онлайн
Работает на компьютере (сканирование QR) и на телефоне (переход по ссылке)
Поддержка карт Сбербанка и банков-участников СБП
Автоматическое обновление статуса заказа после оплаты
Обработка возвратов и отмен через API
Безопасное хранение ключей на сервере