Розробка мобільного додатку для збору пожертвувань

Розробка мобільного додатку для збору пожертвувань

Додатки для збору пожертвувань—окрема категорія фінтеху з нетривіальними вимогами. Ключова різниця від звичайного інтернет-магазину: пожертви часто рекурентні, суми довільні (включаючи «своя сума»), й користувач повинен бачити, на що саме йдуть його гроші—інакше довіра падає.

Типи платежів та їх реалізація

Розовий пожертвування—стандартний платіж через провайдера. Користувач вводить суму, натискає кнопку, бачить результат.

Рекурентне пожертвування—користувач підписується на щомісячне списання. Реалізується через recurring payments: при першому платежі провайдер повертає токен карти, далі сервер самостійно ініціює списання в потрібний день.

// iOS: Stripe recurring donation setup
import StripePayments

// Крок 1: створити SetupIntent на серверу для збереження карти без платежу
// Крок 2: підтвердити з допомогою STPPaymentHandler
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 для розових пожертвувань—максимально низьке тертя. Користувач не вводить дані карти вручну:

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)
    )
]

Довільна сума: UX-нюанси

Поле «своя сума»—частий джерело помилок. Проблеми:

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

// 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 поточний.

// 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)} ₽")
        }
    }
}

Податкові вирахування та документи

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

Ориентири по терміне

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