שילוב שער תשלומים SberPay באפליקציות מובייל

שילוב שער תשלומים של SberPay באפליקציות מובייל

לעתים קרובות אנו נתקלים במצבים שבהם לאחר שילוב SberPay, המשתמש מאשר את התשלום באפליקציית SberBank Online, אך האפליקציה אינה מקבלת קריאה חוזרת (callback) — ה-deeplink נכשל, או שאפליקציית SberBank אינה מותקנת. ללא מנגנון גיבוי (fallback), התשלום נתקע, והסטטוס נבדק רק דרך השרת. מאמר זה מכסה פתרונות מוכחים ל-iOS ואנדרואיד עם deeplinks, גיבוי ובדיקת סטטוס אסינכרונית.

אינטגרציה ישירה דרך Sberbank Acquiring נותנת פי 3 יותר שליטה על סטטוסי התשלום בהשוואה לאגרגטורים, אך דורשת הגדרה קפדנית. דרך אגרגטורים, SberPay מתחבר פי 2 מהר יותר אם ה-SDK כבר נמצא בפרויקט. בנוסף, חיסכון בעמלות יכול להגיע עד 30%, ושיעור ההצלחה הוא 98% כאשר ה-deeplink והגיבוי מטופלים כראוי. לדוגמה, לקוח קמעונאי עם הכנסה חודשית של $100,000 חסך $5,000 בחודש על ידי מעבר ל-acquiring ישיר.

בחירה בין אגרגטור ל-Acquiring ישיר

דרך אגרגטור: אם כבר יש לכם YooKassa, CloudPayments או Robokassa, ניתן להפעיל את SberPay כ-paymentMethodType נוסף ללא אינטגרציה נפרדת. לדוגמה, YooKassa תומך ב-sberbank כסוג שיטת תשלום, וה-SDK פותח אוטומטית את ה-deeplink ל-SberBank Online.

דרך Sberbank Acquiring ישירות: דורש רישום סוחר נפרד מול Sberbank, חיבור לסביבת הבדיקות 3dsec.sberbank.ru, ועבודה ישירה עם REST API. אינטגרציה ישירה מפחיתה את העמלה בעד 30% בהשוואה לאגרגטורים, מה שמתרגם לחיסכון חודשי של $5,000 עבור פרויקט עם הכנסה של $100,000.

מדוע החזרת Deeplink אינה אמינה?

החזרת deeplink היא מקור מידע לא אמין. המשתמש עלול לסגור את האפליקציה לפני ההפניה, לבטל את התשלום ב-SberBank Online, או שמתרחשת תקלת רשת ברגע החזרה. לכן, אנו תמיד מיישמים בדיקת סטטוס בצד השרת דרך getOrderStatusExtended עם סקירה תקופתית (לדוגמה, כל 5 שניות עד 30 שניות). בהתבסס על הסטטוס שהתקבל (0 — נרשם, 1 — שולם, 2 — בוטל), אנו מעדכנים את ממשק המשתמש של האפליקציה.

מה אם אפליקציית SberBank אינה מותקנת? טיפול בגיבוי

לאינטגרציה ישירה, עליכם ליישם גיבוי. אם 0 (אנדרואיד) או 1 (iOS) מחזירים false, פתחו את 2 בדפדפן. תהליך הדפדפן מוביל לגרסת האינטרנט של SberPay, שבה המשתמש יכול לאמת את זהותו דרך Sber 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)
}

טיפול נכון בחזרה מ-SberBank Online

לאחר אישור התשלום ב-SberBank Online, המערכת מפנה אל resolveActivity שציינתם במהלך רישום ההזמנה. עבור iOS, השתמשו ב-Universal Links או URL Schemes; עבור אנדרואיד, הגדירו 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=...