Интеграция платежного шлюза СберPay в мобильное приложение

Интеграция платежного шлюза СберPay в мобильное приложение

Мы часто сталкиваемся с ситуацией, когда после интеграции СберPay пользователь подтверждает оплату в СберБанк Онлайн, но приложение не получает callback — деплинк не срабатывает, или приложение СберБанк не установлено. Без fallback-механизма платёж зависает, а статус проверяется только через сервер. В этой статье — проверенные решения для iOS и Android с деплинками, fallback и асинхронной проверкой.

Прямая интеграция через Сбербанк Эквайринг даёт в 3 раза больше контроля над статусами платежей по сравнению с агрегаторами, но требует тщательной настройки. Через агрегаторы СберPay подключается в 2 раза быстрее, если SDK уже в проекте. Дополнительно, экономия на комиссиях при прямой интеграции может достигать 30%, а доля успешных платежей — 98% при корректной обработке deeplink и fallback.

Какой способ интеграции выбрать: агрегатор или прямой эквайринг?

Через агрегатор. Если у вас уже есть ЮKassa, CloudPayments или Robokassa — СберPay можно включить как дополнительный paymentMethodType без отдельной интеграции. ЮKassa, например, поддерживает sberbank как тип метода оплаты, и SDK сам открывает диплинк в СберБанк Онлайн.

Через Сбербанк Эквайринг напрямую. Нужна отдельная регистрация мерчанта в Сбербанке, подключение к тестовой среде 3dsec.sberbank.ru и прямая работа с REST API.

Почему нельзя полагаться только на deeplink-возврат?

Deeplink-возврат — ненадёжный источник истины. Пользователь может закрыть приложение до редиректа, отменить платёж в самом СберБанк Онлайн, или произойдёт сбой сети в момент возврата. Поэтому мы всегда реализуем серверную проверку статуса через getOrderStatusExtended с периодическим поллингом (например, каждые 5 секунд до 30 секунд). На основе полученного статуса (0 — зарегистрирован, 1 — оплачен, 2 — отменён) обновляем UI приложения.

Что делать, если приложение СберБанк не установлено?

При прямой интеграции нужно обязательно реализовать fallback. Если resolveActivity (Android) или canOpenURL (iOS) возвращает false — открываем formUrl в браузере. Браузерный flow ведёт на веб-версию СберPay, где пользователь может авторизоваться через Сбер ID.

// Android — fallback через браузер val sberPayUri = Uri.parse(formUrl) val intent = Intent(Intent.ACTION_VIEW, sberPayUri) if (intent.resolveActivity(packageManager) != null) { startActivity(intent) } else { openInBrowser(formUrl) // fallback } 

// iOS — fallback через SFSafariViewController if let url = URL(string: formUrl), UIApplication.shared.canOpenURL(url) { UIApplication.shared.open(url) } else { presentSafari(url: formUrl) } 

Как правильно обработать возврат из СберБанк Онлайн?

После подтверждения платежа в СберБанк Онлайн система редиректит на returnUrl, который вы указали при регистрации заказа. В iOS нужен Universal Link или URL Scheme, в Android — Intent Filter с правильным scheme и host.

<!-- AndroidManifest.xml --> <intent-filter> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="yourapp" android:host="payment" android:pathPrefix="/result" /> </intent-filter> 

func handlePaymentCallback(url: URL) { guard let components = URLComponents(url: url, resolvingAgainstBaseURL: false) else { return } if let orderId = components.queryItems?.first(where: { $0.name == "orderId" })?.value { checkOrderStatus(orderId: orderId) } } 

GET https://securepayments.sberbank.ru/payment/rest/getOrderStatusExtended.do ?orderId=uuid-order-id&userName=...&password=...