Описание сервиса
Функциональность сервиса реализуется набором API-ресурсов, описанных ниже.
Шлюз API: http://mc.api.sberbank.ru/:443
Для доступа спользуйте отечественные сертификатов, выданные УЦ Министерства цифрового развития, связи и массовых коммуникаций РФ.
Основные ресурсы
/qr/order/v3/creation — создание заказа и формирование динамического QR-кода под создаваемый заказ (по запросу клиента): QR код уже содержит сумму данного заказа,
/qr/order/v3/status — запрос статуса заказа: получение статуса оплаты и детализации по операциям,
/qr/order/v3/revocation — отмена неоплаченного заказа: покупатель не произвел оплату в установленное время (как правило на сайтах до 20 минут ожидания), либо выбрал другой способ оплаты,
/qr/order/v3/cancel — отмена/возврат финансовой операции,
/qr/order/v3/registry — запрос реестра операций.
Дополнительные ресурсы (реализованы как отдельные API)
/qr/bscanc/v1/pay — сканирование QR-кода Покупателя, отображаемого в мобильном приложении Сбербанк Онлайн, считывателем (ридером) и проведение операции покупки (BsсanC),
/qr/order/notify/v1/notify — получение уведомлений об оплате заказа (об изменении статуса заказа на "Оплачено").
Использование ресурсов в сценариях оплаты
| Сценарии оплаты | /v3/creation | /v3/status | /v3/revocation | /v3/cancel | /v3/registry | /v3/pay | /v3/notify |
|---|---|---|---|---|---|---|---|
| QR-код продавца (SberPay QR) | + | + | + | + | + | - | + |
| QR-код продавца (Плати QR от Сбера) | + | + | + | + | + | - | + |
| QR-код продавца (СБП) | + | + | + | + | + | - | - |
| QR-код покупателя (SberPay QR) | + | + | + | + | + | + | - |
Варианты реализации сценариев
| Описание метода | Сценарий оплаты | URL | Инициатор | Потребитель | Синхронный |
|---|---|---|---|---|---|
| Проведение платежа по QR ФЛ | QR-код Покупателя | /oauth:https://mc.api.sberbank.ru:443/prod/tokens/v3/oauth /pay:https://mc.api.sberbank.ru:443/prod/qr/bscanc/v1/pay scope:https://api.sberbank.ru/qr/order.pay | Клиент | Сбербанк | Да |
| Создание заказа | QR-код Продавца, QR-код СБП | /oauth:https://mc.api.sberbank.ru:443/prod/tokens/v3/oauth /creation:https://mc.api.sberbank.ru:443/prod/qr/order/v3/creation scope:https://api.sberbank.ru/qr/order.create | Клиент | Сбербанк | Да |
| Запрос статуса заказа | QR-код Покупателя, QR-код Продавца, QR-код СБП | /oauth:https://mc.api.sberbank.ru:443/prod/tokens/v3/oauth /status:https://mc.api.sberbank.ru:443/prod/qr/order/v3/status scope:https://api.sberbank.ru/qr/order.status | Клиент | Сбербанк | Да |
| Отмена сформированного заказа (до проведения финансовой операции) | QR-код Покупателя, QR-код Продавца, QR-код СБП | /oauth:https://mc.api.sberbank.ru:443/prod/tokens/v3/oauth /revocation:https://mc.api.sberbank.ru:443/prod/qr/order/v3/revocation scope:https://api.sberbank.ru/qr/order.revoke | Клиент | Сбербанк | Да |
| Отмена/возврат финансовой операции | QR-код Покупателя, QR-код Продавца, QR-код СБП | /oauth:https://mc.api.sberbank.ru:443/prod/tokens/v3/oauth /cancel:https://mc.api.sberbank.ru:443/prod/qr/order/v3/cancel scope:https://api.sberbank.ru/qr/order.cancel | Клиент | Сбербанк | Да |
| Запрос Реестра операций | QR-код Покупателя, QR-код Продавца, QR-код СБП | /oauth:https://mc.api.sberbank.ru:443/prod/tokens/v3/oauth /registry:https://mc.api.sberbank.ru:443/prod/qr/order/v3/registry scope:auth://qr/order.registry | Клиент | Сбербанк | Да |
| Исходящий сервис уведомления об оплате заказа | QR-код Покупателя, QR-код Продавца | /oauth:https://mc.api.sberbank.ru:443/prod/tokens/v3/oauth /notify:\<Endpoint партнера для проксирования вызова + /notify>* scope:auth://qr/order.notify _____________________________ * Партнер должен реализовать на своей стороне метод /notify, на который будут приходить уведомления, и передать endpoint в СБЕР для проксирования вызова | Сбербанк | Клиент | Да |