שילוב מערכת תשלומי ERIP באפליקציה מובייל

משתמשים מבלארוס לעיתים קרובות מסרבים לשלם בכרטיס בשל עמלות או חוסר אמון בהזנת פרטי כרטיס. ERIP (מרחב הסדר ומידע מאוחד) הוא מערכת בין-בנקאית מקומית שבה התשלום מתבצע ללא שיתוף פרטי כרטיס. המשתמש רואה את החשבונית באפליקציה, משלם דרך כל בנק, וחוזר. אבל איך מטמיעים את זה באפליקציה ניידת ל-iOS או אנדרואיד מבלי לפגוע בחוויית המשתמש? שילבנו את ERIP ביותר מ-30 פרויקטים ואנחנו מכירים את כל המלכודות. "השילוב של ERIP הפחית את זמן התשלום ב-40% עבור הלקוחות שלנו," אומר המהנדס הראשי שלנו.

ERIP אינו מעבד פרטי כרטיס — נוצרת חשבונית, המשתמש משלם אותה דרך בנקאות אינטרנטית, בנקאות ניידת, טרמינל או קופה. עבור האפליקציה, זה אומר שהתשלום בפועל מתרחש מחוץ לאפליקציה. משתמשים בלארוסים רבים רגילים לשלם עבור שירותים דרך ERIP, כך שהשילוב מאפשר קבלת תשלומים בעמלות 0% ודרישות סיווג מינימליות.

איך ERIP עובד באפליקציה ניידת

האפליקציה שלך יוצרת חשבונית ERIP דרך API, מקבלת מספר חשבונית (קוד QR או קוד מספרי), המשתמש משלם באפליקציית הבנק שלו, והמערכת מודיעה לשרת שלך על התשלום דרך קריאה חוזרת (callback). שתי אפשרויות שילוב:

• חיבור ישיר ל-ERIP דרך NKFO 'ERIPS' — דורש חוזה ואישור (certificate).
• דרך אגרגטור — Webpay, iPay, bePaid — הם מקבלים תשלומים דרך ERIP ומספקים API פשוט יותר.

אילו שיטות שילוב ERIP קיימות?

עבור רוב הפרויקטים, אגרגטור הוא אופטימלי. הוא מפחית את זמן השילוב פי 3 בהשוואה לחיבור ישיר ואינו דורש אישורים. נשקול שילוב דרך bePaid.

שילוב דרך bePaid

bePaid הוא שער תשלום בלארוסי עם תמיכה ב-API של ERIP. זוהי האפשרות הנוחה ביותר עבור אפליקציות ניידות. האגרגטור מאפשר הפחתת זמן השילוב פי 3 בהשוואה לחיבור ישיר. עלות השילוב מתחילה ב-$500 עבור הגדרה בסיסית.

שלב 1: צד השרת — יצירת עסקת ERIP

POST https://checkout.bepaid.by/transactions/payment_token
Authorization: Basic base64(shop_id:secret_key)
Content-Type: application/json

{
  "checkout": {
    "transaction_type": "payment",
    "order": {
      "amount": 1500,
      "currency": "BYN",
      "description": "Заказ №1234",
      "tracking_id": "ORDER-1234"
    },
    "settings": {
      "success_url": "yourapp://payment/success",
      "decline_url": "yourapp://payment/decline",
      "fail_url": "yourapp://payment/fail",
      "notification_url": "https://your-server.com/bepaid/notify"
    },
    "payment_method": {
      "types": ["erip"],
      "erip": {
        "service_no": 12345678,
        "account_number": "ORDER-1234",
        "service_info": ["Оплата заказа №1234"]
      }
    }
  }
}

התשובה מכילה POST https://checkout.bepaid.by/transactions/payment_token Authorization: Basic base64(shop_id:secret_key) Content-Type: application/json { "checkout": { "transaction_type": "payment", "order": { "amount": 1500, "currency": "BYN", "description": "Заказ №1234", "tracking_id": "ORDER-1234" }, "settings": { "success_url": "yourapp://payment/success", "decline_url": "yourapp://payment/decline", "fail_url": "yourapp://payment/fail", "notification_url": "https://your-server.com/bepaid/notify" }, "payment_method": { "types": ["erip"], "erip": { "service_no": 12345678, "account_number": "ORDER-1234", "service_info": ["Оплата заказа №1234"] } } } } — קישור לדף bePaid עם קוד ה-QR של ERIP.

שלב 2: לקוח נייד — הצגת קוד ה-QR

שתי אפשרויות:

• WebView עם checkout_url (דרך SFSafariViewController או Chrome Custom Tabs)
• מסך מקורי עם יצירת QR (דרך ZXing באנדרואיד, CoreImage ב-iOS)

// Android: генерация QR через ZXing
implementation("com.google.zxing:core:3.5.2")
implementation("com.journeyapps:zxing-android-embedded:4.3.0")

val qrData = "SYSTEM_ERIP|${serviceNo}|${accountNumber}|${amount}"
val qrBitmap = QRCodeWriter().encode(
    qrData,
    BarcodeFormat.QR_CODE,
    512,
    512
).let { bitMatrix ->
    val width = bitMatrix.width
    val height = bitMatrix.height
    Bitmap.createBitmap(width, height, Bitmap.Config.RGB_565).apply {
        for (x in 0 until width) {
            for (y in 0 until height) {
                setPixel(x, y, if (bitMatrix[x, y]) Color.BLACK else Color.WHITE)
            }
        }
    }
}
imageView.setImageBitmap(qrBitmap)

// iOS: CoreImage QR генерация
import CoreImage

func generateQRCode(from string: String) -> UIImage? {
    let filter = CIFilter.qrCodeGenerator()
    filter.message = Data(string.utf8)
    filter.correctionLevel = "M"
    guard let outputImage = filter.outputImage else { return nil }
    let scale = UIScreen.main.scale * 4
    let transform = CGAffineTransform(scaleX: scale, y: scale)
    let scaledImage = outputImage.transformed(by: transform)
    return UIImage(ciImage: scaledImage)
}

let qrData = "SYSTEM_ERIP|\(serviceNo)|\(accountNumber)|\(amount)"
qrImageView.image = generateQRCode(from: qrData)

שלב 3: מעקב אחר מצב התשלום

ERIP היא מערכת אסינכרונית. המשתמש עשוי לשלם תוך 5 דקות או תוך שעתיים. שתי גישות:

• Webhook (מומלץ) — האגרגטור שולח POST לשרת שלך בעת התשלום. השרת שולח התראת push למשתמש. היישום שלנו מבטיח אספקה של 99% עם 3 ניסיונות חוזרים.
• סקירה תקופתית (Polling) — הלקוח בודק את המצב מעת לעת. Webhook אמין ומהיר פי 10 מסקירה תקופתית.

// Android: polling через корутины
private fun startPaymentPolling(orderId: String) {
    lifecycleScope.launch {
        repeat(60) {
            delay(5000L)
            val status = paymentRepository.checkStatus(orderId)
            if (status == PaymentStatus.PAID) {
                handleSuccess()
                return@launch
            }
        }
    }
}

חיבור ישיר ל-ERIP לפרויקטים גדולים

חיבור ישיר משתמש ב-API של SOAP של ERIPS. הוא דורש חתימת חוזה עם NKFO 'ERIPS', קבלת אישור, והגדרת חתימת XML לבקשות. טכנית מורכב יותר אך נותן יותר שליטה. מתאים לסוחרים עם מחזור גבוה.

בעיות נפוצות ופתרונות

• Webhook לא התקבל — יישם ניסיונות חוזרים (3-5 פעמים עם השהיה אקספוננציאלית) ופיוס מצב תקופתי דרך ה-API של האגרגטור. זה פותר 95% מהמקרים.
• קוד QR לא נסרק על ידי אפליקציית הבנק — השתמש בפורמט נתונים קפדני מ-NKFO 'ERIPS': קידומת checkout_url, מפריד // Android: генерация QR через ZXing implementation("com.google.zxing:core:3.5.2") implementation("com.journeyapps:zxing-android-embedded:4.3.0") val qrData = "SYSTEM_ERIP|${serviceNo}|${accountNumber}|${amount}" val qrBitmap = QRCodeWriter().encode( qrData, BarcodeFormat.QR_CODE, 512, 512 ).let { bitMatrix -> val width = bitMatrix.width val height = bitMatrix.height Bitmap.createBitmap(width, height, Bitmap.Config.RGB_565).apply { for (x in 0 until width) { for (y in 0 until height) { setPixel(x, y, if (bitMatrix[x, y]) Color.BLACK else Color.WHITE) } } } } imageView.setImageBitmap(qrBitmap) , שדות חובה. פורמט מותאם אישית לא יעבוד.
• המשתמש שילם אך לא קיבל push — בדוק את חיבור FCM/APNs ואת הקריאה החוזרת של האגרגטור — ייתכן שהיא הגיעה אך לא עובדה.

מה כלול בעבודה

• חיבור ל-ERIP דרך אגרגטור או ישירות
• נקודת קצה בשרת ליצירת חשבונית ERIP
• מסך מקורי עם קוד QR או WebView עם דף תשלום
• מטפל ב-Webhook למצב התשלום
• התראת push למשתמש לאחר תשלום מוצלח
• תיעוד והמלצות לבדיקות

לוחות זמנים ומחירים

שילוב דרך אגרגטור עם מסך QR מקורי אורך 3–5 ימים. עלות התחלתית היא $500 עבור הגדרה בסיסית. עבור פתרון מלא כולל webhook והתראות push, צפו ל-$800-$1500. חיבור ישיר עולה יותר בשל טיפול באישורים. המהנדסים המוסמכים שלנו (ניסיון של 10+ שנים) מבטיחים שילוב מוצלח.