SberPay
SberPay — это быстрый способ оплаты для клиентов СБЕРа. Оплата происходит в мобильном банке СБЕРа.
- Принимать платежи через SberPay можно на мобильных устройствах и десктопах.
- Регистрация в СБЕРе происходит автоматически при создании магазина. Если способ оплаты не отображается в личном кабинете интернет-эквайринга — магазин находится на регистрации или перерегистрации в эквайринге СБЕРа или не подходит для проведения оплат по SberPay по правилам СБЕРа.
Требования к интеграции и дизайну кнопки определяет СБЕР:
Принимать платежи через SberPay можно двумя способами:
- Одностадийный платеж — мерчант списывает деньги за покупку сразу после завершения оплаты.
- Двухстадийный платеж — сначала мерчант блокирует деньги за покупку на карте покупателя и только потом списывает их.
Холдировать деньги на карте покупателя можно на срок до 30 дней.
Например, покупатель оплатил товар 1 марта, и его банк заморозил деньги на счете. Подтвердить платеж нужно в течение 30 дней, включая день авторизации — до 30 марта включительно. После этого срока деньги на счете покупателя могут быть расхолдированы и покупатель может их потратить — подтвердить списание не получится.
Одностадийный платеж
Вызовите метод Инициировать платеж.
В зависимости от устройства покупателя, вызовите один из методов:
- мобильное устройство — Получить ссылку с обязательной передачей параметра
"paymentMethod":"SBERPAY"
для редиректа покупателя в мобильное приложение СБЕРа; - десктоп — Зарегистрировать QR с обязательной передачей параметра
"paymentMethod":"SBERPAY"
для генерации QR-кода для оплаты.
- мобильное устройство — Получить ссылку с обязательной передачей параметра
Дождитесь оплаты покупателем.
- При успешном сценарии операция перейдет в статус
CONFIRMED
, и покупатель будет перенаправлен на страницуSuccessURL
. - При неуспешном — в статус
REJECTED
, и покупатель будет перенаправлен на страницуFailURL
. Перечень кодов ошибок.
- При успешном сценарии операция перейдет в статус
Двухстадийный платеж
- Вызовите метод Инициировать платеж.
- В зависимости от устройства покупателя, вызовите один из методов:
- мобильное устройство — Получить ссылку с обязательной передачей параметра
"paymentMethod":"SBERPAY"
для редиректа покупателя в мобильное приложение СБЕРа; - десктоп — Зарегистрировать QR с обязательной передачей параметра
"paymentMethod":"SBERPAY"
для генерации QR-кода для оплаты.
- мобильное устройство — Получить ссылку с обязательной передачей параметра
- Дождитесь оплаты покупателем.
- При успешном сценарии операция перейдет в статус
AUTHORIZED
, и покупатель будет перенаправлен на страницуSuccessURL
. - При неуспешном — в статус
REJECTED
, и покупатель будет перенаправлен на страницуFailURL
. Перечень кодов ошибок.
- При успешном сценарии операция перейдет в статус
- Вызовите метод Подтвердить списание c параметром
paymentId
для подтверждения платежа.- При успешном сценарии операция перейдет в статус
CONFIRMED
. - При неуспешном — в статус
REJECTED
, и покупатель будет перенаправлен на страницуFailURL
. Перечень кодов ошибок.
- При успешном сценарии операция перейдет в статус
Особенности проведения платежей
Метод Инициировать платеж
При отправке запроса:
- При подключении оплаты через SberPay обязательно передаются параметры устройства в объекте
deviseInfo
:"deviseInfo": {
"type": "Desktop",
"os": "iOs",
"webView": "true",
"browser": "Safari"
}
Метод Подтвердить списание
Из-за особенностей работы эквайринга СБЕРа и асинхронной обработки запросов на подтверждение:
- Подтвердить платежную сессию можно только один раз — либо частично, либо полностью.
- Если у сервисов партнера возникнут проблемы с производительностью, платеж может вернуться в статусе
CONFIRMING
. В этом случае статус будет обновляться каждые 20 секунд в течение двух минут и после этого перейдет вCONFIRMED
.
Метод Отменить платеж
Из-за особенностей работы эквайринга СБЕРа и асинхронной обработки запросов на подтверждение:
- Отменить платежную сессию можно только один раз и только на полную сумму платежа.
- Возврат можно делать несколько раз — как частично, так и полностью — пока не будет исчерпана сумма платежа.
- Если у сервисов партнера возникнут проблемы с производительностью, платеж может вернуться в статусе
REVERSING
илиREFUNDING
. В этом случае статус будет обновляться каждые 20 секунд в течение двух минут и после этого перейдет вREVERSED
илиREFUNDED
.