Генерация 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 дней. Получите консультацию по вашему проекту прямо сейчас.