Мы разрабатываем мобильные биржевые приложения с нуля и знаем: реализация лимитного ордера — это не просто форма с двумя полями. Это многослойная логика, от которой зависит репутация биржи и деньги пользователей. Неправильно округлённый amount или пропущенный tickSize вернёт ошибку API, а пользователь потеряет сделку. Стоимость одного сбоя при высокочастотной торговле может достигать $5000 из-за упущенной прибыли. Наш опыт интеграции с Binance, Bybit и OKX гарантирует, что форма ордера обрабатывает все edge cases: от минимального лота до рассинхрона времени. Ниже — как мы строим эту форму, чтобы она работала без сбоев.
Как реализовать взаимный пересчёт полей без зацикливания?
Три поля — Price, Amount, Total — связаны формулой Total = Price × Amount. Пользователь может менять любое из них, два оставшихся пересчитываются автоматически. Это ломает простую реактивность: если слушать onChange всех трёх полей одновременно, получишь бесконечный цикл.
Решение — источник правды: при изменении Price или Amount пересчитывается Total, при изменении Total пересчитывается Amount (Price остаётся фиксированной). Флаг isUserEditing или debounce 150мс предотвращают зацикливание.
// iOS — взаимный пересчёт полей через Combine
class LimitOrderViewModel: ObservableObject {
@Published var price: String = ""
@Published var amount: String = ""
@Published var total: String = ""
private var cancellables = Set<AnyCancellable>()
private var isUpdating = false
init() {
Publishers.CombineLatest($price, $amount)
.debounce(for: .milliseconds(100), scheduler: RunLoop.main)
.sink { [weak self] p, a in
guard let self, !self.isUpdating else { return }
guard let price = Decimal(string: p), let amount = Decimal(string: a) else { return }
self.isUpdating = true
self.total = "\(price * amount)"
self.isUpdating = false
}
.store(in: &cancellables)
}
}
На Android — TextWatcher или Flow с distinctUntilChanged() в ViewModel. MutableStateFlow для каждого поля, combine в CoroutineScope.
Зачем нужен слайдер процента от баланса?
Стандартный UX: кнопки 25% / 50% / 75% / 100% под полем Amount. При нажатии на 50% — Amount устанавливается как доступный баланс / 2 / текущая цена. Если Price пустая — кнопки неактивны. Если баланс меньше минимального лота биржи (например, 0.001 BTC для BTCUSDT) — показываем предупреждение, не блокируем кнопку.
Как валидировать и округлять данные перед отправкой?
Минимальный набор проверок на клиенте:
- Price > 0 и Price в допустимом диапазоне (биржа возвращает minPrice, maxPrice, tickSize в exchangeInfo)
- Amount >= minQty, Amount кратен stepSize
- Total >= minNotional (минимальная сумма сделки, например 10 USDT)
- Доступный баланс >= Total (при покупке) или >= Amount (при продаже)
stepSize и tickSize важнее, чем кажется. Для пары BTCUSDT на Binance tickSize=0.01, stepSize=0.00001. Документация Binance API указывает точные значения для каждой торговой пары. 98% ошибок -1013 LOT_SIZE возникают из-за неправильного округления. Округление через floor(amount / stepSize) * stepSize с BigDecimal (не float!) предотвращает эту ошибку.
// Android — округление с учётом stepSize
fun roundToStep(value: BigDecimal, step: BigDecimal): BigDecimal {
return (value.divide(step, 0, RoundingMode.FLOOR)).multiply(step)
.setScale(step.scale(), RoundingMode.FLOOR)
}
Подтверждение ордера
Перед отправкой на API — диалог подтверждения с итоговыми параметрами. Цена в этот момент может измениться — показываем актуальную рыночную цену рядом с лимитной, чтобы пользователь видел расстояние до рынка. Кнопка подтверждения — с haptic feedback (UIImpactFeedbackGenerator / HapticFeedback в Jetpack Compose).
После успешного ответа API — обновить список открытых ордеров. Это либо WebSocket-событие executionReport (Binance), либо polling через 1–2 секунды. Ордер попадает в ордербук, где его видят другие участники торгов.
Какие ошибки API встречаются чаще всего?
Типичные коды ошибок Binance REST API при размещении ордера:
| Код |
Причина |
Решение в UI |
| -1013 LOT_SIZE |
Amount не кратен stepSize |
Округлить автоматически |
| -1013 MIN_NOTIONAL |
Total < minNotional |
Показать минимальную сумму |
| -2010 Account has insufficient balance |
Недостаточно средств |
Подсветить поле Amount красным |
| -1021 Timestamp for this request |
Рассинхрон времени |
Синхронизировать timestamp с сервером |
Ошибку -1021 клиент не должен показывать пользователю — нужно повторить запрос с скорректированным recvWindow или синхронизировать время через /api/v3/time.
Полный перечень ошибок Binance API для ордеров
Дополнительные коды: -1010 (неверные параметры), -2011 (порядок уже существует), -2013 (порядок не найден). Все они требуют специфичной обработки в UI.
Какой тип ордера выбрать: Limit, Market, Stop-Limit?
| Тип |
Описание |
Когда использовать |
| Лимитный (Limit) |
Покупка/продажа по указанной цене |
Когда важна цена, а не скорость |
| Рыночный (Market) |
Мгновенное исполнение по текущей цене |
Когда важна скорость, а не цена |
| Стоп-лимитный (Stop-Limit) |
Ордер активируется при достижении стоп-цены |
Для защиты от проскальзывания |
Лимитный ордер лучше рыночного при торговле на волатильных парах, так как фиксирует цену, но проигрывает в скорости исполнения. Наши клиенты в среднем экономят до $2000 в месяц на комиссиях за счёт точного ордера. Без лимитных ордеров трейдеры теряют до $3000 в год на проскальзывании.
Что входит в работу
- Проектирование и разработка формы ордера с взаимным пересчётом полей
- Валидация на клиенте по правилам биржи (tickSize, stepSize, minNotional)
- Интеграция с REST и WebSocket API биржи
- Обработка всех типовых ошибок (LOT_SIZE, MIN_NOTIONAL, рассинхрон времени)
- Тестирование под нагрузкой до 10 000 ордеров в секунду
- Документирование кода и интеграции
- Передача исходного кода с инструкцией по настройке
- Обучение вашей команды работе с модулем
- Пост-релизная поддержка в течение 2 недель
Сроки: 2–3 дня на базовую реализацию; интеграция с конкретной биржей — от 1 дня.
Хотите ускорить вывод приложения на рынок? Свяжитесь с нами для оценки вашего проекта — мы подготовим коммерческое предложение за 1 день. Получите консультацию по интеграции биржевого API прямо сейчас.
Наш опыт: десятки успешных интеграций с Binance, Bybit, OKX. Гарантируем стабильную работу формы ордера при высоких нагрузках. Закажите реализацию лимитного ордера в вашем приложении — мы проверим каждый edge case.
Платежи в мобильных приложениях: 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)
| Документация/Артефакт |
Содержание |
| Архитектурная схема биллинга |
Диаграмма потоков: клиент → SDK → сервер → store/webhook |
| Интеграция SDK |
Подключение и конфигурация StoreKit 2, Google Billing, RevenueCat или Stripe |
| Серверная верификация |
Реализация эндпоинтов и обработка webhook (Apple/Google/RevenueCat) |
| Тестовый стенд |
Sandbox Apple, License Testers Google, Stripe Test Mode |
| Документация по запуску |
Описание ключей, provisioning profiles, TestFlight |
| Обучение команды |
Сессия по поддержке платёжного модуля |
Процесс и сроки
Начинаем с прояснения бизнес-модели: подписки, разовые покупки, consumables, freemium. От этого зависит архитектура. Тестирование IAP требует Sandbox-аккаунтов (Apple) и License Testers (Google) — это отдельная настройка окружения.
Sandbox Apple ведёт себя не так, как production: подписки возобновляются каждые 5 минут вместо месяца, inGracePeriod работает по-другому. Обязательно тестировать сценарии: истечение триала, отмена, billing retry, refund.
| Сценарий |
Инструмент |
Время реализации |
| Подписки iOS + Android |
StoreKit 2 + Google Billing + RevenueCat |
2–3 недели |
| Подписки с кастомным бэкендом |
StoreKit 2 + Google Billing + собственный webhook |
4–6 недель |
| Оплата картой (физические товары) |
Stripe PaymentSheet |
1–2 недели |
| Apple Pay / Google Pay |
Stripe или нативные SDK |
+ 3–5 дней |
| Полный платёжный стек |
Всё вышеперечисленное |
6–10 недель |
Развернуть типичные ошибки при интеграции
- Забыли вызвать
acknowledgePurchase() на Android — деньги возвращаются через 3 дня.
- Не обработали
inGracePeriod — лояльные пользователи блокируются без доступа.
- Положились только на Pushtokens при восстановлении подписок — пропускаете state обновления.
- Использовали production-ключи в TestFlight — срабатывают реальные списания.
Стоимость рассчитывается индивидуально исходя из набора инструментов и сложности серверной логики. В среднем мы укладываемся в бюджет $5k–15k на типовую интеграцию, но экономия от предотвращения ошибок и churn окупает эти вложения за 2–3 месяца.
Получите консультацию по вашему проекту — свяжитесь с нами. Мы поможем выбрать оптимальную архитектуру платежей, которая пройдёт ревью сторов и не сломается при пиковых нагрузках.