Реализация конвертации криптовалюты в фиат в мобильном приложении мерчанта

Реализация конвертации криптовалюты в фиат в мобильном приложении мерчанта

Мерчант принял оплату в USDT, а на следующий день обнаружил, что курс просел на 4% и деньги так и лежат на кошельке. Автоматическая конвертация в фиат сразу после подтверждения транзакции — не «nice to have», а требование бизнеса. Реализовать это в мобильном приложении сложнее, чем кажется: нужно синхронизировать события on-chain с конвертацией через CEX или процессинг, не теряя транзакцию при сбоях.

Архитектура конвертации

Два основных подхода — через платёжный процессинг (Coinbase Commerce, NOWPayments, CryptoCloud) и через прямую интеграцию с биржей (Binance API, Bybit API). У каждого своя логика на мобильном клиенте.

Через платёжный процессинг

NOWPayments и аналоги принимают крипту и автоматически конвертируют в фиат до момента вывода. Мобильный клиент делает POST /v1/payment с параметром payout_currency: "USD" — процессинг берёт на себя риск курсовой разницы. Приложению остаётся:

1. Запросить адрес для оплаты и сумму
2. Показать QR-код или Deep Link (bitcoin:addr?amount=0.001)
3. Polling статуса через GET /v1/payment/{id} каждые 15 секунд или WebSocket
4. Показать статус: waiting → confirming → confirmed → finished

Проблема polling — когда сеть биткоина перегружена, confirming может висеть 40+ минут. Пользователь закроет приложение. Нужен push-уведомление через FCM/APNs при смене статуса — бэкенд получает webhook от процессинга и рассылает push.

Через Binance API

Прямая интеграция: после получения крипты на кастодиальный кошелёк делаем POST /sapi/v1/convert/getQuote — получаем котировку, затем POST /sapi/v1/convert/acceptQuote. Квота действует 10 секунд. Если просрочена — повтор. На мобильном клиенте этот процесс скрыт за бэкендом; клиент видит только итоговый фиатный баланс.

// Пример отображения статуса конвертации (SwiftUI)
struct ConversionStatusView: View {
    @StateObject var viewModel: ConversionViewModel

    var body: some View {
        switch viewModel.status {
        case .waitingPayment(let address, let amount):
            QRCodeView(address: address, amount: amount)
        case .confirming(let confirmations, let required):
            ConfirmationProgressView(current: confirmations, required: required)
        case .converting:
            LoadingView(text: "Конвертируем в USD...")
        case .completed(let fiatAmount):
            SuccessView(amount: fiatAmount)
        case .failed(let error):
            ErrorView(error: error)
        }
    }
}

Работа с курсом и проскальзыванием

Пользователь видит «получите $99.50» — а по факту приходит $97.80 из-за проскальзывания при конвертации. Нужно явно показывать estimated_rate и locked_rate (если процессинг поддерживает lock курса на 15–20 минут). CryptoCloud поддерживает фиксацию курса; NOWPayments — нет.

Для отображения live-курса в приложении используем WebSocket от Binance wss://stream.binance.com:9443/ws/btcusdt@ticker или CoinGecko REST с кэшированием на 30 секунд.

Безопасность на мобильном клиенте

Приватные ключи кошельков — никогда на мобильном устройстве. Мобильный клиент общается только с собственным бэкендом. API-ключи к биржам — только на сервере, защищены через Vault или переменные окружения. На iOS используем Keychain для хранения сессионных токенов, на Android — EncryptedSharedPreferences из Jetpack Security.

Этапы и сроки

Аудит бизнес-требований → выбор процессинга или CEX → реализация серверного слоя конвертации → мобильный клиент с polling/WebSocket → push-уведомления → тестирование в Testnet/Sandbox.

3–5 дней для интеграции через готовый процессинг. 2–3 недели при прямой интеграции с биржей с обработкой ошибок и ретраями. Стоимость рассчитывается индивидуально после анализа требований.