Інтеграція платіжного шлюзу Сбер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=...