Khôi phục giao dịch mua trong ứng dụng 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 tiền thêm lần nữa. Tính năng này đặc biệt hữu ích cho những người đã 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 lại nội dung đã mua mà không cần thanh toán lại.

Note

Trong các paywall được xây dựng bằng Paywall Builder, giao dịch mua sẽ được khôi phục tự động mà không cần thêm code từ phía bạn. Nếu đó là trường hợp của bạn — bạn có thể bỏ qua bước này.

Để khôi phục giao dịch mua khi bạn không sử dụng Paywall Builder để tùy chỉnh paywall, hãy gọi phương thức .restorePurchases():

Response parameters:

ParameterDescription
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

Trong Adapty Android SDK 4.0.2 trở lên, restorePurchases() hoàn thành thành công ngay cả khi không có gì để khôi phục: nó 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 đó. Trong các phiên bản SDK trước đó, phương thức này 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 thụ từ Google Play.

Trong Adapty Android SDK 4.0.2 trở lên, 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 đã được tiêu thụ. Để người dùng có thể 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.

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, nơ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.