Интеграция системы ЕРИП в мобильное приложение

Пользователи из Беларуси часто отказываются от оплаты картой из-за комиссий или недоверия к вводу реквизитов. ЕРИП (Единое расчётно-информационное пространство) — местная межбанковская система, где платёж происходит без передачи карточных данных. Пользователь видит счёт в приложении, оплачивает через любой банк и возвращается. Но как встроить это в мобильное приложение на iOS или Android, не ломая UX? Мы интегрировали ЕРИП для 30+ проектов, и знаем все подводные камни.

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

Как работает ЕРИП в мобильном приложении?

Ваше приложение создаёт счёт в ЕРИП через API, получает номер счёта (QR-код или числовой код), пользователь оплачивает в своём банковском приложении. Система уведомляет ваш сервер о факте оплаты через callback. Два варианта подключения:

• Прямое подключение к ЕРИП через НКФО «ЕРИПС» — требует договора и сертификата.
• Через агрегатора — Webpay, iPay, bePaid — они принимают оплату через ЕРИП и предоставляют более простой API.

Какие способы интеграции ЕРИП существуют?

Для большинства проектов оптимален агрегатор. Он сокращает время интеграции в 3 раза по сравнению с прямым подключением и не требует сертификатов. Рассмотрим интеграцию через bePaid.

Интеграция через bePaid

bePaid — белорусский платёжный шлюз с поддержкой ЕРИП API. Наиболее удобный вариант для мобильных приложений. Агрегатор позволяет сократить время интеграции в 3 раза по сравнению с прямым подключением.

Серверная часть: создание транзакции с ЕРИП

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"] } } } } 

Ответ содержит checkout_url — ссылка на страницу bePaid с QR-кодом ЕРИП.

Мобильный клиент: отображение QR-кода

Два варианта:

• WebView с checkout_url (через SFSafariViewController или Chrome Custom Tabs)
• Нативный экран с генерацией QR (через ZXing на Android, 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) 

Как отследить статус оплаты?

ЕРИП — асинхронная система. Пользователь может оплатить через 5 минут или через 2 часа. Два подхода:

• Webhook (рекомендуется) — агрегатор отправляет POST на ваш сервер при оплате. Сервер отправляет Push-уведомление пользователю.
• Polling — клиент периодически запрашивает статус. Webhook лучше Polling в 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 } } } } 

Прямое подключение к ЕРИП для крупных проектов

При прямом подключении используется SOAP API ЕРИПС. Требует заключения договора с НКФО «ЕРИПС», получения сертификата и настройки XML-подписи запросов. Технически сложнее, но даёт больше контроля. Подходит для мерчантов с высоким оборотом.

Типичные проблемы и их решение

• Webhook не дошёл — реализуйте повторные попытки (3-5 раз с экспоненциальной задержкой) и периодическую сверку статусов через API агрегатора. Это решает 95% случаев.
• QR не сканируется банковским приложением — используйте строгий формат данных от НКФО «ЕРИПС»: префикс SYSTEM_ERIP, разделитель |, обязательные поля. Произвольный формат не сработает.
• Пользователь оплатил, но не получил push — проверьте подключение к FCM/APNs, а также callback от агрегатора — возможно, он пришёл, но не был обработан.

Что входит в работу

• Подключение к ЕРИП через агрегатора или напрямую
• Серверный endpoint для создания ЕРИП-счёта
• Нативный экран с QR-кодом или WebView с checkout страницей
• Webhook обработчик для получения статуса оплаты
• Push-уведомление пользователю после успешной оплаты
• Документация и рекомендации по тестированию

Сроки

Интеграция через агрегатора с нативным QR-экраном занимает 3–5 дней. Стоимость рассчитывается индивидуально после анализа требований и выбора агрегатора. Закажите интеграцию — получите консультацию и оценку сроков. Свяжитесь с нами.