Генерация QR для криптоплатежей в мобильном приложении

Реализация QR-кода для приёма криптоплатежей в мобильном приложении

Представьте: пользователь сканирует ваш QR, но кошелёк выдаёт «неизвестная валюта» или не подставляет сумму. Причина — неверный URI-формат или неподходящий уровень коррекции ошибок. Мы настраивали генерацию QR для десятков криптокошельков и знаем, как избежать этих проблем. Корректный URI (BIP-21, EIP-681) и правильный Error Correction Level — ключ к бесшовной оплате. Без них пользователь вводит данные вручную, растёт число ошибок и снижается конверсия. Свяжитесь с нами — мы поможем внедрить надёжное решение под ваш стек.

Используем проверенные стеки: Swift + CoreImage на iOS, Kotlin + ZXing на Android. CoreImage генерирует QR быстрее (на 30% по тестам), но ZXing даёт больше контроля над модулями — это особенно важно при нестандартных размерах. Выбор зависит от задачи: если нужна скорость — CoreImage, если кастомизация — ZXing.

Почему URI-формат определяет успех платежа?

Стандартные URI (BIP-21, EIP-681) распознаются большинством кошельков. Если опустить параметр amount или указать его в неверных единицах (например, сатоши вместо биткоинов), плательщику придётся вводить сумму вручную. Это увеличивает риск ошибки и снижает конверсию.

BIP-21 — стандарт формата URI для Bitcoin. EIP-681 — стандарт для Ethereum.

URI-форматы для разных блокчейнов

Для Solana требуется указать mint токена; если не указан, принимается SOL. Это важно учесть при мультичейн-реализации.

EIP-681 для ERC-20 — нотация неочевидная: сначала адрес контракта токена, потом метод transfer с получателем и суммой. Многие кошельки поддерживают упрощённый формат: ethereum:0xRecipient?value=X&contractAddress=0xToken.

Какой уровень коррекции QR выбрать?

Выбор уровня коррекции — компромисс между устойчивостью к повреждениям и плотностью данных. Для мобильных приложений с брендированием мы рекомендуем уровень Q (25%). Он даёт в 1,5 раза большую устойчивость, чем M, при незначительном увеличении размера.

Без логотипа достаточно M (15%) — он обеспечивает хорошую читаемость при малых углах сканирования. Но при добавлении логотипа без повышения коррекции до Q читаемость падает на 40%.

Генерация QR с правильными параметрами

// iOS — генерация QR через CoreImage с нужным уровнем коррекции
import CoreImage.CIFilterBuiltins

func generateQRCode(from string: String, size: CGFloat = 300) -> UIImage {
    let filter = CIFilter.qrCodeGenerator()
    filter.message = Data(string.utf8)
    filter.correctionLevel = "Q" // 25% error correction — для логотипа поверх QR

    let transform = CGAffineTransform(scaleX: size / filter.outputImage!.extent.width,
                                       y: size / filter.outputImage!.extent.height)
    let scaledImage = filter.outputImage!.transformed(by: transform)

    // Интерполяция nearest neighbor для чёткости
    let context = CIContext()
    let cgImage = context.createCGImage(scaledImage, from: scaledImage.extent)!
    return UIImage(cgImage: cgImage)
}

// Android — ZXing с кастомным размером
import com.google.zxing.BarcodeFormat
import com.google.zxing.EncodeHintType
import com.google.zxing.qrcode.QRCodeWriter
import com.google.zxing.qrcode.decoder.ErrorCorrectionLevel

val hints = mapOf(
    EncodeHintType.ERROR_CORRECTION to ErrorCorrectionLevel.Q,
    EncodeHintType.MARGIN to 1,
    EncodeHintType.CHARACTER_SET to "UTF-8"
)
val bitMatrix = QRCodeWriter().encode(uri, BarcodeFormat.QR_CODE, 512, 512, hints)

Динамическая сумма и выбор токена

Если в приложении есть поле ввода суммы перед генерацией QR — URI обновляется при каждом изменении суммы. Для ERC-20 важно учесть decimals при формировании value:

// Android — расчёт value для USDC (6 decimals)
val humanAmount = BigDecimal("100.50") // введено пользователем
val decimals = 6
val rawAmount = humanAmount.movePointRight(decimals).toBigInteger() // 100500000
val uri = "ethereum:${usdcContractAddress}@1/transfer?address=${recipientAddress}&uint256=$rawAmount"

Ошибка в decimals — одна из частых причин неверного перевода. Для USDC (6 decimals) сумма 100.50 USDC превращается в 100500000 единиц. Для ETH (18 decimals) — 100500000000000000000 wei.

Брендинг поверх QR

Логотип приложения в центре QR — стандартная практика. Центральная зона до 30% площади — безопасно при уровне коррекции Q. Логотип должен быть белым квадратом с иконкой, чтобы не нарушать контрастность модулей QR.

Что делать при проблемах со сканированием?

Если QR не считывается, проверьте уровень коррекции (должен быть Q или H при логотипе), контраст между модулями и фоном, а также размер логотипа (не более 30% площади). Убедитесь, что URI соответствует стандарту для выбранного блокчейна.

Как мы реализуем крипто-QR под ключ?

Наш процесс включает:

1. Анализ — выбор блокчейнов, токенов, требований к брендированию.
2. Проектирование — подготовка URI-форматов, выбор библиотек генерации.
3. Реализация — код на Swift / Kotlin с учётом динамической суммы и error correction.
4. Тестирование — сканирование на 10+ популярных кошельках (Trust Wallet, MetaMask, Coinbase).
5. Деплой — интеграция с App Store / Google Play, настройка App Distribution.

Сроки: от 1 дня (один блокчейн, без логотипа) до 10 дней (мультичейн, брендирование, выбор токенов). Стоимость интеграции под ключ рассчитывается индивидуально — свяжитесь с нами для оценки проекта.

Что входит в результат

• Генерация QR с корректным URI для каждого блокчейна.
• Динамическое обновление суммы и выбор токена.
• Брендирование QR логотипом с уровнем коррекции Q.
• Кнопки «Копировать адрес» и «Поделиться QR».
• Исходный код с комментариями и документация.
• Поддержка после релиза (1 месяц). Стоимость поддержки включена в базовый пакет.

Почему стоит доверить эту задачу нам?

Мы занимаемся мобильной разработкой более 5 лет, реализовали более 30 проектов с криптовалютными платежами. Гарантируем совместимость с актуальными версиями кошельков и магазинов приложений. Опыт с прохождением App Store Review Guidelines (Section 4.2, 5.1) и Google Play Console — ваше приложение не отклонят из-за реализации QR.

Закажите реализацию — мы подготовим всё за 3–10 дней. Получите консультацию по вашему проекту прямо сейчас.

Платежи в мобильных приложениях: In-App Purchase, StoreKit 2, Google Billing, Stripe, RevenueCat

В каждом нашем проекте по монетизации приложения мы балансируем между политиками App Store и Google Play, требованиями PCI DSS и логикой верификации покупок на бэкенде. Неправильно сделанная система платежей — это не просто баг, это финансовые потери и возможный бан приложения. За 7 лет мы разобрали более 50 кейсов интеграции платёжных SDK — от простой Stripe-формы до распределённого биллинга с собственными серверными вебхуками.

In-App Purchase: две платформы, два разных API

Если приложение продаёт цифровой контент или подписки — Apple и Google требуют использовать их платёжные системы. Обойти это нельзя: нарушение правил 3.1.1 App Store или Google Play Developer Policy приводит к удалению приложения. Физические товары и сервисы, оказываемые офлайн, — другая история.

StoreKit 2 (iOS 15+)

StoreKit 2 — полная переработка исходного StoreKit с async/await API. Product.products(for:), product.purchase(), Transaction.currentEntitlements — читаемо и предсказуемо по сравнению с очередью транзакций через SKPaymentTransactionObserver.

Самое важное изменение: транзакции в StoreKit 2 подписаны JWS (JSON Web Signature) и верифицируются локально без серверного roundtrip. Transaction.verificationResult возвращает .verified(Transaction) или .unverified(Transaction, VerificationError). Это не значит, что сервер не нужен — он нужен для хранения статуса подписки, но локальная верификация убирает задержку при старте.

StoreKit.AppTransaction — верификация самого факта загрузки приложения из App Store. Нужна для приложений с платным скачиванием или бессрочными покупками, не подписками.

Сложное место в StoreKit 2 — обработка renewalState для подписок: .subscribed, .expired, .inBillingRetryPeriod, .inGracePeriod, .revoked. Состояние inGracePeriod означает, что Apple пытается возобновить оплату (до 16 дней) — в это время нужно продолжать давать доступ. Не обработаешь — потеряешь лояльных пользователей, у которых временно не прошла карта. По опыту, около 5% подписок попадают в billing retry, и автоматическое восстановление доступа возвращает до 80% из них.

Google Play Billing Library (v6+)

Google Billing — сложнее StoreKit по количеству сценариев. BillingClient с PurchasesUpdatedListener, queryProductDetailsAsync, launchBillingFlow, queryPurchasesAsync — обязательно вызывать при каждом старте приложения, не полагаться на PurchasesUpdatedListener как единственный источник правды.

Подтверждение покупки: acknowledgePurchase() для non-consumables и подписок, consumePurchase() для consumables. Если не вызвать acknowledge в течение 3 дней — Google автоматически сделает возврат. Это гарантированная потеря денег, если забыть про acknowledge на бэкенде после верификации.

ProductDetails с SubscriptionOfferDetails — в Billing v5+ структура оферт усложнилась: один продукт может иметь несколько basePlanId и offerId (пробный период, скидка для новых пользователей, retention-оффер). BillingFlowParams.SubscriptionUpdateParams для апгрейда/даунгрейда подписки с prorationMode.

Почему серверная верификация обязательна?

Никогда не доверяйте только клиентскому коду при разблокировке платного контента. Клиентская верификация обходится модификацией приложения.

Для IAP минимальная схема: приложение получает receiptData (iOS) или purchaseToken (Android), отправляет на бэкенд, бэкенд верифицирует через Apple App Store Server API / Google Play Developer API, сохраняет статус в БД, отдаёт ответ клиенту. RevenueCat делает это за вас — но если у вас кастомный бэкенд, нужно реализовать самостоятельно.

Webhook-и важнее, чем кажется. Пользователь может отменить подписку через настройки телефона, не через приложение — приложение не получит об этом событие в реальном времени. Только webhook от Apple/Google (или RevenueCat) позволяет своевременно обновить статус. Мы используем проверку подписи входящих запросов через Apple's signedPayload и Google's DeveloperNotification.

Как RevenueCat упрощает интеграцию?

Поддерживать StoreKit 2 и Google Billing одновременно, с учётом промо-кодов, оферт, восстановления покупок и серверной верификации — это несколько месяцев разработки. RevenueCat закрывает большую часть этого слоя.

RevenueCat — не просто SDK для платежей. Это:

• Единый API для iOS и Android (и Stripe для веба)
• Серверная верификация и хранение статусов подписок
• Webhooks на события (покупка, возобновление, отмена, billing issue)
• Аналитика по когортам, MRR, churn
• A/B тестирование оферт через Experiments

Purchases.configure(withAPIKey:) при старте, Purchases.shared.getCustomerInfo() для получения текущих entitlements — минимальный интегрируемый слой. Purchases.shared.purchase(package:) вместо прямого вызова StoreKit/Billing.

В документации RevenueCat сказано: «RevenueCat handles receipt validation on the server side, reducing client-side complexity and preventing fraudulent purchases.»

Ограничения RevenueCat: платный (бесплатно до $2.5k MRR, дальше процент от дохода), не подходит для очень сложных flow с несколькими storefront-ами или кастомными bundle-ами. Однако для типового SaaS-приложения экономия на собственной разработке составляет $15–30 тыс. — интеграция окупается за 2 месяца.

Stripe в мобильных приложениях

Stripe — для оплаты физических товаров, услуг, B2B-платежей где IAP не требуется политикой платформы.

Stripe iOS SDK и Android SDK — PaymentSheet для готового UI оплаты, PaymentSheetFlowController для кастомного UI с сохранёнными картами. Payment Intent создаётся на сервере, client secret передаётся в приложение — карточные данные никогда не проходят через ваш сервер, только через Stripe.

Apple Pay и Google Pay через Stripe: PKPaymentRequest (iOS) и GooglePayLauncher (Android) уже интегрированы в Stripe SDK. Конверсия у Apple Pay даёт в 1.3–2 раза выше результат, чем формы с ручным вводом карты — это цифры, которые мы подтвердили на десятке проектов.

Сохранённые карты через SetupIntent + Customer API — пользователь платит в один тап при повторном визите. Compliance: PCI DSS SAQ A — самый лёгкий уровень compliance, потому что Stripe Tokenization убирает нужду хранить карточные данные на своей стороне. Согласно PCI DSS, передача токенов освобождает от необходимости сертификации уровня 1.

3DS2 (Strong Customer Authentication) — обязателен для платежей в ЕС по PSD2. Stripe обрабатывает автоматически через PaymentIntent.confirmPayment, но нужно корректно обработать .requiresAction статус и вернуть пользователя в нужный экран после аутентификации.

Что входит в работу (deliverables)

Процесс и сроки

Начинаем с прояснения бизнес-модели: подписки, разовые покупки, consumables, freemium. От этого зависит архитектура. Тестирование IAP требует Sandbox-аккаунтов (Apple) и License Testers (Google) — это отдельная настройка окружения.

Sandbox Apple ведёт себя не так, как production: подписки возобновляются каждые 5 минут вместо месяца, inGracePeriod работает по-другому. Обязательно тестировать сценарии: истечение триала, отмена, billing retry, refund.

Стоимость рассчитывается индивидуально исходя из набора инструментов и сложности серверной логики. В среднем мы укладываемся в бюджет $5k–15k на типовую интеграцию, но экономия от предотвращения ошибок и churn окупает эти вложения за 2–3 месяца.

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