Покупки в мобильном приложении в Kotlin Multiplatform SDK

Отображение пейволов в мобильном приложении — обязательный шаг для предоставления пользователям доступа к премиум-контенту или услугам. Однако просто показать пейвол достаточно для совершения покупок только в том случае, если вы используете Paywall Builder для его настройки.

Если вы не используете Paywall Builder, необходимо вызывать отдельный метод .makePurchase() для завершения покупки и открытия нужного контента. Этот метод служит точкой входа для пользователей, желающих взаимодействовать с пейволами и совершать транзакции.

Если в вашем пейволе есть активный promotional offer для продукта, который пользователь хочет купить, Adapty автоматически применит его в момент покупки.

Убедитесь, что вы выполнили начальную настройку, не пропустив ни одного шага. Без неё мы не сможем валидировать покупки.

Совершение покупки

Adapty.makePurchase(product = product).onSuccess { purchaseResult ->
    when (purchaseResult) {
        is AdaptyPurchaseResult.Success -> {
            val profile = purchaseResult.profile
            if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive == true) {
                // Grant access to the paid features
            }
        }
        is AdaptyPurchaseResult.UserCanceled -> {
            // Handle the case where the user canceled the purchase
        }
        is AdaptyPurchaseResult.Pending -> {
            // Handle deferred purchases (e.g., the user will pay offline with cash)
        }
    }
}.onError { error ->
    // Handle the error
}

Параметры ответа:

Изменение подписки при совершении покупки

Когда пользователь выбирает новую подписку вместо продления текущей, поведение зависит от стора. В Google Play подписка не обновляется автоматически. Вам нужно управлять переключением в коде мобильного приложения, как описано ниже.

Чтобы заменить подписку другой в Android, вызовите метод .makePurchase() с дополнительным параметром:

val subscriptionUpdateParams = AdaptyAndroidSubscriptionUpdateParameters(
    oldSubVendorProductId = "old_subscription_product_id",
    replacementMode = AdaptyAndroidSubscriptionUpdateReplacementMode.CHARGE_FULL_PRICE
)

val purchaseParams = AdaptyPurchaseParameters.Builder()
    .setSubscriptionUpdateParams(subscriptionUpdateParams)
    .build()

Adapty.makePurchase(
    product = product,
    parameters = purchaseParams
).onSuccess { purchaseResult ->
    when (purchaseResult) {
        is AdaptyPurchaseResult.Success -> {
            val profile = purchaseResult.profile
            // successful cross-grade
        }
        is AdaptyPurchaseResult.UserCanceled -> {
            // user canceled the purchase flow
        }
        is AdaptyPurchaseResult.Pending -> {
            // the purchase has not been finished yet, e.g. user will pay offline by cash
        }
    }
}.onError { error ->
    // Handle the error
}

Дополнительный параметр запроса:

• О режимах замены
• Рекомендации Google по режимам замены
• Режим замены CHARGE_PRORATED_PRICE. Примечание: этот метод доступен только для апгрейда подписки. Даунгрейд не поддерживается.
• Режим замены DEFERRED. Примечание: фактическая смена подписки произойдёт только по окончании текущего расчётного периода.

Погашение промокодов в iOS

Чтобы показать в приложении экран погашения промокодов:

Adapty.presentCodeRedemptionSheet()
    .onSuccess {
        // code redemption sheet presented successfully
    }
    .onError { error ->
        // handle the error
    }

Управление предоплаченными планами (Android)

Если пользователи вашего приложения могут приобретать предоплаченные планы (например, неавтоматически возобновляемую подписку на несколько месяцев), вы можете включить отложенные транзакции для предоплаченных планов.

Adapty.activate(
    AdaptyConfig.Builder("PUBLIC_SDK_KEY")
        .withGoogleEnablePendingPrepaidPlans(true)
        .build()
).onSuccess {
    // successful activation
}.onError { error ->
    // handle the error
}