Описание сервиса
Функциональность сервиса реализуется набором 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/registry — запрос реестра операций.
Дополнительные ресурсы (реализованы как отдельные API)
- /qr/order/notify/v1/notify — получение уведомлений об оплате заказа (об изменении статуса заказа на "Оплачено").
Использование ресурсов в сценариях оплаты
| Сценарии оплаты | /v3/creation | /v3/status | /v3/revocation | /v3/cancel | /v3/registry | /v3/notify |
|---|---|---|---|---|---|---|
| QR-код продавца (SberPay QR) | + | + | + | + | + | + |
| QR-код продавца (Сервисы других банков) | + | + | + | + | + | + |
| QR-код продавца (СБП) | + | + | + | + | + | - |
Варианты реализации сценариев
| Описание метода | Сценарий оплаты | URL | Инициатор | Потребитель | Синхронный |
|---|---|---|---|---|---|
| Создание заказа | 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-код СБП | /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-код СБП | /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-код СБП | /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-код СБП | /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-код Продавца | /oauth:https://mc.api.sberbank.ru:443/prod/tokens/v3/oauth /notify:<Endpoint партнера для проксирования вызова + /notify>* scope:auth://qr/order.notify _____________________________ * Партнер должен реализовать на своей стороне метод /notify, на который будут приходить уведомления, и передать endpoint в СБЕР для проксирования вызова | Сбербанк | Клиент | Да |