Разработка мобильного приложения для сбора пожертвований

Разработка мобильного приложения для сбора пожертвований

Пользователь не доверяет, если не видит, на что идут деньги. Особенно когда донаты рекуррентные, а суммы произвольные. Мы сталкивались с проектами, где из-за плохой реализации прозрачности и UX падал LTV донаторов. Например, один благотворительный фонд терял до 40% пользователей на экране оплаты из-за отсутствия Apple Pay и непонятного прогресса сбора. Прозрачность сборов — это не просто прогресс-бар, а целая система: лента транзакций, анимированные индикаторы, автоматические отчёты. В этой статье — как избежать типовых ошибок и сделать приложение, которому верят.

Как разработать мобильное приложение для сбора пожертвований?

Базовый функционал включает три типа платежей: разовый донат, рекуррентный донат и оплата через кошелёчные системы. Каждый требует своей реализации.

Разовый донат

Стандартный платёж через провайдера. Пользователь вводит сумму, нажимает кнопку, видит результат. Главное — минимизировать количество полей. Идеально — одна кнопка «Пожертвовать» с предустановленными суммами и полем «своя сумма».

Рекуррентный донат

Пользователь подписывается на ежемесячное списание. Реализуется через recurring payments: при первом платеже провайдер возвращает токен карты, дальше сервер самостоятельно инициирует списания в нужный день. Это основа прогнозируемого cash flow для НКО.

// iOS: Stripe recurring donation setup
import StripePayments

let params = STPConfirmSetupIntentParams(
    paymentMethodParams: cardParams,
    clientSecret: setupIntentClientSecret
)

STPPaymentHandler.shared().confirmSetupIntent(
    params,
    with: self
) { [weak self] status, setupIntent, error in
    switch status {
    case .succeeded:
        // setupIntent.paymentMethodID — сохраняем на сервере
        self?.saveRecurringMethod(setupIntent?.paymentMethodID)
    case .failed:
        self?.showError(error?.localizedDescription)
    case .canceled:
        break
    @unknown default: break
    }
}

Apple Pay / Google Pay для разовых донатов

Максимально низкое трение — пользователь не вводит данные карты вручную. Настройка merchant ID и provisioning profile входит в объём работ. Пример на iOS:

let request = PKPaymentRequest()
request.merchantIdentifier = "merchant.com.yourcharity.app"
request.countryCode = "RU"
request.currencyCode = "RUB"
request.supportedNetworks = [.visa, .masterCard]
request.merchantCapabilities = [.capability3DS]
request.paymentSummaryItems = [
    PKPaymentSummaryItem(
        label: "Помощь животным",
        amount: NSDecimalNumber(string: donationAmount)
    )
]

Apple Pay лучше разовых карточных платежей в 2-3 раза по конверсии — подтверждено A/B-тестами наших клиентов.

Сравнение подходов к платежам

Как реализовать произвольную сумму без ошибок?

Поле «своя сумма» — частый источник ошибок. Проблемы:

• Пользователь вводит «1000.5» или «1 000» с пробелом — нужна нормализация до Decimal
• Минимальный лимит провайдера (у большинства — 10 ₽)
• Максимальный лимит без 3DS (обычно 150 000 ₽)

// Android: нормализация произвольной суммы
fun parseAmount(input: String): Result<Long> {
    val cleaned = input
        .replace(",", ".")
        .replace(Regex("\\s"), "")
        .trim()

    return try {
        val decimal = cleaned.toBigDecimal()
        if (decimal < BigDecimal("10")) {
            Result.failure(Exception("Минимальная сумма — 10 ₽"))
        } else if (decimal > BigDecimal("150000")) {
            Result.failure(Exception("Для сумм выше 150 000 ₽ требуется верификация"))
        } else {
            Result.success((decimal * BigDecimal("100")).toLong()) // в копейках
        }
    } catch (e: NumberFormatException) {
        Result.failure(Exception("Введите корректную сумму"))
    }
}

Как обеспечить прозрачность сбора?

Пользователи жертвуют охотнее, когда видят конкретную цель и прогресс. Это "прогресс-бар сбора" — целевой показатель vs текущий. Для анимации используем animateFloatAsState во Flutter или Compose. Сервер отправляет новые данные через WebSocket, и шкала обновляется плавно, создавая вовлекающий эффект.

// Android: Jetpack Compose progress indicator для сбора
@Composable
fun FundraisingProgress(
    current: Long,
    target: Long,
    modifier: Modifier = Modifier
) {
    val progress = (current.toFloat() / target.toFloat()).coerceIn(0f, 1f)
    val animatedProgress by animateFloatAsState(
        targetValue = progress,
        animationSpec = tween(durationMillis = 800)
    )

    Column(modifier) {
        LinearProgressIndicator(
            progress = animatedProgress,
            modifier = Modifier.fillMaxWidth().height(8.dp),
            trackColor = MaterialTheme.colorScheme.surfaceVariant,
            color = MaterialTheme.colorScheme.primary
        )
        Row(Modifier.fillMaxWidth(), horizontalArrangement = Arrangement.SpaceBetween) {
            Text("${formatAmount(current)} ₽ собрано")
            Text("из ${formatAmount(target)} ₽")
        }
    }
}

Кроме прогресс-бара, добавляем ленту транзакций — каждый пользователь видит, что его донат зафиксирован. Это повышает доверие и снижает chargeback.

Почему recurrency стоит внедрять с первой версии?

Рекуррентные донаты дают на 30-50% больше среднего чека по сравнению с разовыми платежами. Технически мы реализуем recurring через токенизацию карт: после первого успешного списания храним paymentMethodID на сервере и инициируем новые списания через Stripe API. Обязательно настраиваем напоминания о списании (push + email) за 3 дня до даты — это снижает chargeback в 4 раза.

Стек технологий для сборки

Налоговые вычеты и документы

Для благотворительных фондов часто требуется формирование справки для налогового вычета. Это серверная логика: агрегация платежей пользователя за год, формирование PDF. Приложение только показывает кнопку «Скачать справку».

Что входит в разработку под ключ?

• Аналитика: интервью с фондом, аудит текущих процессов, выбор провайдера (Stripe / YooKassa / Cloud Payments)
• Проектирование: UX-прототипы с фокусом на экран платежа и историю, архитектура (iOS / Android / Flutter)
• Реализация: вёрстка экранов, интеграция платежей, настройка push-уведомлений (APNs + FCM), deep linking (Universal Links)
• Тестирование: unit-тесты логики, UI-тесты критических путей, тестовая оплата в sandbox, проверка App Store Review Guidelines (Section 4.2/5.1)
• Деплой: публикация в App Store и Google Play, настройка metrica, закрытие доступа к тестовым данным
• Пост-релиз: мониторинг crash-free rate, обновление библиотек, поддержка в течение 3 месяцев

Ориентиры по срокам

Базовая версия (разовые донаты, карта + Apple/Google Pay, история): 3–5 недель. Рекуррентные подписки — ещё 1–2 недели. Прогресс-бары по целевым сборам — ещё 1 неделя. Стоимость рассчитывается индивидуально. Получите консультацию по вашему проекту — более 5 лет опыта в разработке финтех-приложений. Свяжитесь с нами, чтобы обсудить детали.

Платежи в мобильных приложениях: 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 месяца.

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