SberPay

SberPay — это быстрый способ оплаты для клиентов Сбера внутри мобильного приложения Сбера.

Принимать платежи через SberPay можно на мобильных устройствах и десктопах.
Регистрация в Сбере происходит автоматически при создании магазина. Если способ оплаты не отображается в личном кабинете интернет-эквайринга — магазин находится на регистрации или перерегистрации в эквайринге Сбера или не подходит для проведения оплат по SberPay по правилам Сбера.

Требования к интеграции и дизайну кнопки определяет Сбер:

Принимать платежи через SberPay можно двумя способами:

Одностадийный платеж — мерчант списывает деньги за покупку сразу после завершения оплаты.
Двухстадийный платеж — сначала мерчант блокирует деньги за покупку на карте покупателя и только потом списывает их.

Холдировать деньги на карте покупателя можно на срок до 30 дней.

Например, покупатель оплатил товар 1 марта, и его банк заморозил деньги на счете. Подтвердить платеж нужно в течение 30 дней, включая день авторизации — до 30 марта включительно. После этого срока деньги на счете покупателя могут быть расхолдированы и покупатель может их потратить — подтвердить списание не получится.

Одностадийный платеж

Вызовите метод Инициировать платеж. В объекте paymentMethod обязательно передайте параметр "name":"SBERPAY".
В зависимости от устройства покупателя, вызовите один из методов:
- Мобильное устройство — Получить ссылку. В объекте payment обязательно передайте параметр "name":"SBERPAY" для редиректа покупателя в мобильное приложение Т-Банка.
- Десктоп — Зарегистрировать QR. В объекте payment обязательно передайте параметр "name":"SBERPAY" для генерации QR-кода для оплаты.
Дождитесь оплаты покупателем.
- При успешном сценарии операция перейдет в статус CONFIRMED, и покупатель будет перенаправлен на страницу SuccessURL.
- При неуспешном — в статус REJECTED, и покупатель будет перенаправлен на страницу FailURL. Список кодов ошибок.

Двухстадийный платеж

Вызовите метод Инициировать платеж. В объекте paymentMethod обязательно передайте параметр "name":"SBERPAY".
В зависимости от устройства покупателя, вызовите один из методов:
- Мобильное устройство — Получить ссылку. В объекте payment обязательно передайте параметр "name":"SBERPAY" для редиректа покупателя в мобильное приложение Т-Банка.
- Десктоп — Зарегистрировать QR. В объекте payment обязательно передайте параметр "name":"SBERPAY" для генерации QR-кода для оплаты.
Дождитесь оплаты покупателем.
- При успешном сценарии операция перейдет в статус AUTHORIZED, и покупатель будет перенаправлен на страницу SuccessURL.
- При неуспешном — в статус REJECTED, и покупатель будет перенаправлен на страницу FailURL. Список кодов ошибок.
Вызовите метод Подтвердить списание c параметром paymentId для подтверждения платежа.
- При успешном сценарии операция перейдет в статус CONFIRMED.
- При неуспешном — в статус REJECTED, и покупатель будет перенаправлен на страницу FailURL. Список кодов ошибок.

Особенности проведения платежей

Метод Инициировать платеж

Отправка запроса

При подключении оплаты через SberPay в объекте fingerprint обязательно передаются параметры устройства:

"fingerprint": {
  "ip": "129.00.00.1",
  "os": "iOs",
  "isWebView": "true",
  "browser": "Safari"
 }

Метод Подтвердить списание

Из-за особенностей работы эквайринга Сбера и асинхронной обработки запросов на подтверждение:

Подтвердить платежную сессию можно только один раз — либо частично, либо полностью.
Если у сервисов партнера возникнут проблемы с производительностью, платеж может вернуться в статусе CONFIRMING. В этом случае статус будет обновляться каждые 20 секунд в течение двух минут и после этого перейдет в CONFIRMED.

Метод Отменить платеж

Из-за особенностей работы эквайринга Сбера и асинхронной обработки запросов на подтверждение:

Отменить платежную сессию можно только один раз и только на полную сумму платежа.
Возврат можно делать несколько раз: как частично, так и полностью — пока не будет исчерпана сумма платежа.
Если у сервисов партнера возникнут проблемы с производительностью, платеж может вернуться в статусе REVERSING или REFUNDING. В этом случае статус будет обновляться каждые 20 секунд в течение двух минут и после этого перейдет в REVERSED или REFUNDED.