Khôi phục mua hàng trong ứng dụng di động với Android SDK

Khôi phục giao dịch mua là tính năng cho phép người dùng lấy lại quyền truy cập vào nội dung đã mua trước đó, chẳng hạn như các gói đăng ký hoặc in-app purchase, mà không bị tính phí lần nữa. Tính năng này đặc biệt hữu ích cho những người dùng đã gỡ cài đặt rồi cài lại ứng dụng, hoặc chuyển sang thiết bị mới và muốn truy cập nội dung đã mua mà không phải trả thêm tiền.

Note

Nếu bạn đã xây dựng màn hình trong builder, bạn không cần phải khôi phục giao dịch mua thủ công. Chỉ cần gắn control khôi phục — hành động Restore purchases trong Flow & Paywall Builder, hoặc link hay nút khôi phục trong phiên bản cũ — và SDK sẽ hoàn tất việc khôi phục.

Nếu bạn tự xây dựng màn hình, hãy gọi phương thức .restorePurchases():

Adapty.restorePurchases { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val profile = result.value
                      
            if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive == true) {
            // successful access restore
            }
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.restorePurchases(result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyProfile profile = ((AdaptyResult.Success<AdaptyProfile>) result).getValue();
        
        if (profile != null) {
            AdaptyProfile.AccessLevel premium = profile.getAccessLevels().get("YOUR_ACCESS_LEVEL");
            
            if (premium != null && premium.isActive()) {
                // successful access restore
            }
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // handle the error
    }
});

Response parameters:

Parameter Description

Parameter	Description
Profile	Một đối tượng `AdaptyProfile`. Model này chứa thông tin về các mức độ truy cập, gói đăng ký, và các sản phẩm mua một lần. Kiểm tra trạng thái mức độ truy cập để xác định xem người dùng có quyền truy cập vào ứng dụng hay không.

Profile

Một đối tượng AdaptyProfile. Model này chứa thông tin về các mức độ truy cập, gói đăng ký, và các sản phẩm mua một lần.

Kiểm tra trạng thái mức độ truy cập để xác định xem người dùng có quyền truy cập vào ứng dụng hay không.

Info

Bắt đầu từ Adapty Android SDK 3.17.3 và 4.0.2, restorePurchases() hoàn thành thành công ngay cả khi không có gì để khôi phục: phương thức trả về hồ sơ người dùng hiện tại, vì vậy hãy kiểm tra trạng thái mức độ truy cập trong đó. Ở các phiên bản SDK cũ hơn, phương thức sẽ thất bại với lỗi NO_PURCHASES_TO_RESTORE trong trường hợp này.

Những gì có thể được khôi phục

restorePurchases khôi phục các gói đăng ký đang hoạt động và các sản phẩm mua một lần chưa được tiêu dùng từ Google Play.

Bắt đầu từ Adapty Android SDK 3.17.3 và 4.0.2, sử dụng Google Play Billing Library 8, Play Store không còn trả về các gói đăng ký đã hết hạn hoặc các sản phẩm mua một lần đã tiêu dùng. Để cho phép người dùng khôi phục những giao dịch đó trên nhiều thiết bị và sau khi cài đặt lại, hãy xác định họ bằng Adapty.identify. Adapty sau đó sẽ khôi phục lịch sử mua hàng từ backend của mình thay vì từ cửa hàng.

Note

Google Play chỉ báo cáo những giao dịch mua hiện đang sở hữu, vì vậy restorePurchases() không thể tìm thấy các gói đăng ký đã hết hạn trước khi bạn tích hợp Adapty. Để thêm chúng vào Adapty, hãy import dữ liệu lịch sử của bạn.

Tip

Bạn muốn xem ví dụ thực tế về cách tích hợp Adapty SDK vào ứng dụng di động? Hãy xem ứng dụng mẫu của chúng tôi, minh họa toàn bộ quá trình thiết lập, bao gồm hiển thị paywall, thực hiện mua hàng và các chức năng cơ bản khác.