Thực hiện mua hàng trong ứng dụng mobile với Kotlin Multiplatform SDK

Hiển thị paywall trong ứng dụng di động là bước thiết yếu để cung cấp cho người dùng quyền truy cập vào nội dung hoặc dịch vụ cao cấp. Tuy nhiên, việc hiển thị paywall chỉ tự động hỗ trợ mua hàng khi Adapty render màn hình — tức là, một flow, hoặc paywall từ Paywall Builder cũ.

Nếu bạn tự render màn hình trong code của mình, bạn phải sử dụng một phương thức riêng gọi là .makePurchase() để hoàn tất giao dịch mua và mở khóa nội dung mong muốn. Phương thức này đóng vai trò là cổng để người dùng tương tác với các paywall và tiến hành các giao dịch họ muốn.

Nếu paywall của bạn có ưu đãi đang hoạt động cho sản phẩm mà người dùng muốn mua, Adapty sẽ tự động áp dụng ưu đãi đó tại thời điểm thanh toán.

Hãy đảm bảo bạn đã hoàn thành cấu hình ban đầu mà không bỏ qua bước nào. Nếu thiếu, chúng tôi không thể xác thực giao dịch mua.

Thực hiện mua hàng

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
}

Tham số yêu cầu:

Tham số phản hồi:

Thay đổi gói đăng ký khi mua hàng

Khi người dùng chọn gói đăng ký mới thay vì gia hạn gói hiện tại, cách thức hoạt động phụ thuộc vào cửa hàng. Với Google Play, gói đăng ký không tự động được cập nhật. Bạn cần quản lý việc chuyển đổi trong code ứng dụng như mô tả dưới đây.

Để thay thế gói đăng ký bằng gói khác trên Android, hãy gọi phương thức .makePurchase() với tham số bổ sung:

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
}

Tham số yêu cầu bổ sung:

Bạn có thể đọc thêm về gói đăng ký và các chế độ thay thế trong tài liệu Google Developer:

• Giới thiệu về các chế độ thay thế
• Khuyến nghị của Google về các chế độ thay thế
• Chế độ thay thế CHARGE_PRORATED_PRICE. Lưu ý: phương thức này chỉ dùng được khi nâng cấp gói đăng ký. Hạ cấp không được hỗ trợ.
• Chế độ thay thế DEFERRED. Lưu ý: Việc thay đổi gói đăng ký thực sự chỉ diễn ra khi kỳ thanh toán gói đăng ký hiện tại kết thúc.

Đổi mã ưu đãi trên iOS

Để hiển thị giao diện đổi mã trong ứng dụng:

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

Quản lý gói trả trước (Android)

Nếu người dùng ứng dụng của bạn có thể mua gói trả trước (ví dụ: mua gói đăng ký không tự gia hạn trong vài tháng), bạn có thể bật giao dịch đang chờ xử lý cho các gói trả trước.

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

Promoted in-app purchases từ App Store

Khi người dùng bắt đầu mua hàng từ trang sản phẩm App Store của bạn và giao dịch được chuyển vào ứng dụng, SDK sẽ giao sản phẩm cho bạn thông qua OnPromotedPurchaseListener. Việc hoàn tất giao dịch mua là do ứng dụng của bạn quyết định: truyền sản phẩm vào makePromotedPurchase. Vì bạn kiểm soát thời điểm đó xảy ra, bạn có thể hiển thị màn hình của riêng mình trước khi giao dịch mua bắt đầu.

Để hỗ trợ promoted purchase, hãy đăng ký listener và hoàn tất giao dịch mua từ đó:

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

Đăng ký listener ngay khi khởi động ứng dụng, ngay sau Adapty.activate. Một giao dịch mua qua quảng cáo thường khởi động lạnh ứng dụng, nên thường đến SDK trước khi lệnh đăng ký của bạn chạy. SDK giữ lại một giao dịch như vậy và gửi đến ngay khi bạn đăng ký, chỉ giữ giao dịch gần nhất, đồng thời ghi cảnh báo vào console mỗi khi giữ lại một giao dịch.

Nếu sản phẩm được quảng bá có kèm ưu đãi gói đăng ký, SDK sẽ tự động áp dụng ưu đãi đó khi mua. Ưu đãi được đọc từ purchase intent của App Store, vốn chỉ khả dụng trên iOS 18.0 trở lên. Trên iOS 16.4–17.x, giao dịch mua sẽ thực hiện theo giá gốc.

makePromotedPurchase không nhận tham số mua — vì sản phẩm được quảng bá đến từ App Store chứ không phải từ paywall, nên nó không mang theo ngữ cảnh paywall nào. Hàm này trả về cùng kiểu AdaptyPurchaseResult như makePurchase.

AdaptyPromotedProduct chứa vendorProductId, localizedTitle, localizedDescription, price, regionCode, isFamilyShareable, và một subscription kiểu AdaptyProductSubscription.