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

Отображение пейволов в мобильном приложении — это ключевой шаг для предоставления пользователям доступа к премиум-контенту или сервисам. Однако само по себе отображение пейвола поддерживает покупки только тогда, когда экран отрисовывает Adapty — то есть флоу или пейвол из старого 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 для разработчиков:

• О режимах замены
• Рекомендации 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
}

Продвигаемые встроенные покупки из App Store

Когда пользователь начинает покупку со страницы вашего продукта в App Store и транзакция переходит в ваше приложение, SDK передаёт продукт через OnPromotedPurchaseListener. Завершение покупки остаётся за вашим приложением: передайте продукт в makePromotedPurchase. Поскольку вы сами контролируете момент запуска, можно показать собственный экран до начала покупки.

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

Adapty.setOnPromotedPurchaseListener(OnPromotedPurchaseListener { product ->
    scope.launch {
        Adapty.makePromotedPurchase(product)
            .onSuccess { result -> /* process the purchase result */ }
            .onError { error -> /* handle the error */ }
    }
})

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

Если продвигаемый продукт содержит предложение по подписке, SDK автоматически применяет его при покупке. Предложение считывается из намерения о покупке App Store, которое доступно начиная с iOS 18.0. На iOS 16.4–17.x покупка проходит по базовой цене.

makePromotedPurchase не принимает параметры покупки — продвигаемый продукт поступает из App Store, а не из пейвола, поэтому у него нет контекста пейвола. Метод возвращает тот же AdaptyPurchaseResult, что и makePurchase.

AdaptyPromotedProduct содержит vendorProductId, localizedTitle, localizedDescription, price, regionCode, isFamilyShareable и subscription типа AdaptyProductSubscription.