Bạn có thể cần thực hiện các thao tác quản lý đối với gói thuê bao hoặc giao dịch mua hàng một lần trong hoạt động kinh doanh hằng ngày. Ví dụ: dịch vụ khách hàng của bạn có thể cần hoàn tiền toàn bộ hoặc hoàn tiền một phần cho người dùng, hoặc bạn có thể cần thu hồi quyền trong một số trường hợp nhất định. Bạn có thể quản lý đơn đặt hàng từ Play Console hoặc nếu muốn quản lý đơn đặt hàng từ hệ thống của riêng mình, bạn có thể thực hiện bằng cách sử dụng Google Play Developer API.
Hủy đăng ký
Người dùng hoặc nhà phát triển có thể bắt đầu huỷ gói thuê bao.
Yêu cầu huỷ do người dùng thực hiện
Người dùng có thể huỷ gói thuê bao trên Google Play bất cứ lúc nào thông qua Cửa hàng Play. Nếu áp dụng, bạn cũng phải cung cấp lựa chọn để người dùng huỷ gói thuê bao trong ứng dụng và trên trang web của bạn.
Cách dễ nhất để cho phép người dùng tự nguyện huỷ là cung cấp đường liên kết sâu trong ứng dụng của bạn đến Cửa hàng Play, nơi họ có thể xem và quản lý gói thuê bao của mình.
Lượt huỷ do nhà phát triển thực hiện
Là nhà phát triển, bạn cũng có thể cần kích hoạt lệnh huỷ từ phần phụ trợ.
purchases.subscriptions.cancel
API cho phép bạn huỷ giao dịch mua gói thuê bao.
Ví dụ: bạn có thể sử dụng phương thức này để từ chối một dịch vụ cũ.
Việc huỷ gói thuê bao sẽ không hoàn tiền và người dùng vẫn có quyền truy cập cho đến khi kết thúc kỳ thanh toán hiện tại.
Phương thức này cho phép bạn chỉ định các loại huỷ sau đây trong tham số nội dung yêu cầu cancellationType:
USER_REQUESTED_STOP_RENEWALS: Huỷ gói thuê bao như thể người dùng đã huỷ trên Cửa hàng Play. Mọi khoản thanh toán trả góp sẽ tiếp tục trong thời gian còn lại của kỳ cam kết hiện tại. Trên Cửa hàng Play, người dùng có thể khôi phục gói thuê bao trước khi gói thuê bao hết hạn hoặc đăng ký lại sau khi gói thuê bao hết hạn nếu gói cơ bản có bật tính năng này.
DEVELOPER_REQUESTED_STOP_PAYMENTS: Huỷ gói thuê bao và ngăn mọi khoản thanh toán khác. Người dùng không thể khôi phục hoặc đăng ký lại gói thuê bao từ Cửa hàng Play, tuy nhiên, bạn có thể cho phép họ đăng ký lại trong ứng dụng của bạn.
Cho phép người dùng khôi phục các gói thuê bao chưa hết hạn
Trong một số trường hợp, bạn có thể thấy việc cho phép người dùng khôi phục các gói thuê bao chưa hết hạn từ trung tâm quản lý gói thuê bao của Play sau khi bạn kích hoạt việc huỷ với tư cách là nhà phát triển là một việc hữu ích. Ví dụ: bạn có thể muốn cung cấp quy trình huỷ tuỳ chỉnh trong ứng dụng. Dựa trên logic kinh doanh, bạn có thể quyết định xem người dùng có thể khôi phục những gói thuê bao nào bị huỷ từ phần phụ trợ của bạn.
Để cho biết rằng người dùng có thể khôi phục yêu cầu huỷ, hãy gửi một yêu cầu POST đến API purchases.subscriptions.cancel và đặt tham số yêu cầu cancellationType thành giá trị USER_REQUESTED_STOP_RENEWALS.
Ví dụ:
- Mã thông báo giao dịch mua của gói thuê bao
1a2b3c4d5e6f7g8h9i0j - Tên gói ứng dụng
com.your.app - Mã gói thuê bao
your-subscription-product
Yêu cầu POST qua HTTP:
https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptions/your-subscription-product/tokens/1a2b3c4d5e6f7g8h9i0j:cancel
Nội dung yêu cầu:
{
"cancellationType": "USER_REQUESTED_STOP_RENEWALS"
}
Cho phép người dùng đăng ký lại các gói thuê bao đã hết hạn
Để cho phép đăng ký lại một gói thuê bao đã hết hạn, bạn phải bật
lựa chọn Đăng ký lại
trong gói cơ bản của gói thuê bao, sau đó huỷ gói thuê bao bằng cách đặt
tham số cancellationType thành giá trị USER_REQUESTED_STOP_RENEWALS.
Chỉ cho phép người dùng đăng ký lại trong ứng dụng của bạn
Nếu bạn đã đặt tham số cancellationType thành DEVELOPER_REQUESTED_STOP_PAYMENTS hoặc chưa đặt tham số cancellationType, thì người dùng không thể khôi phục gói thuê bao của họ qua trung tâm quản lý gói thuê bao của Play. Tuy nhiên, người dùng có thể đăng ký lại gói thuê bao thông qua ứng dụng của bạn nếu cần.
Thao tác này sẽ kích hoạt một Thông báo theo thời gian thực dành cho nhà phát triển SUBSCRIPTION_CANCELED. Xử lý các yêu cầu huỷ này như mô tả trong phần Yêu cầu huỷ.
Hoãn thanh toán
Bạn có thể gia hạn thời gian hưởng quyền cho một gói thuê bao bằng cách sử dụng phương thức subscriptionsv2.defer. Khi bạn trì hoãn một gói thuê bao có tiện ích bổ sung, tất cả các mục trong
gói thuê bao đó sẽ bị trì hoãn trong cùng một khoảng thời gian. Trong thời gian hoãn, người dùng vẫn đăng ký nội dung của bạn nhưng không bị tính phí cho thời gian gia hạn. Khi bạn hoãn thanh toán cho một gói thuê bao, thông tin trạng thái sẽ được cập nhật tương ứng và bạn sẽ thấy thông tin đó trong trường expiryTime trong thông tin trạng thái mua hàng:
- Đối với các gói thuê bao định kỳ đang hoạt động, việc trì hoãn thanh toán sẽ kéo dài ngày gia hạn tiếp theo.
- Đối với gói trả trước, việc thanh toán chậm sẽ kéo dài thời gian hết hạn.
Sau đây là một số ví dụ về cách bạn có thể sử dụng tính năng thanh toán chậm:
- Tặng quyền truy cập không tốn phí cho người dùng dưới dạng ưu đãi đặc biệt, chẳng hạn như tặng một tuần miễn phí cho người đăng ký hiện tại khi họ hoàn thành một bản khảo sát ý kiến phản hồi.
- Cung cấp cho khách hàng quyền truy cập miễn phí như một hành động chăm sóc khách hàng, ví dụ: sau khi một sự cố ngừng hoạt động kéo dài có thể đã ảnh hưởng đến khả năng sử dụng dịch vụ của bạn.
Hệ thống có thể hoãn khoản thanh toán chỉ trong một ngày và tối đa là một năm cho mỗi lệnh gọi API. Để hoãn việc kết thúc quyền thêm nữa, hãy gọi lại API trước ngày hết hạn mới.
Thao tác này sẽ kích hoạt một Thông báo theo thời gian thực dành cho nhà phát triển SUBSCRIPTION_DEFERRED. Hãy xem phần Hoãn thanh toán cho người đăng ký trong bài viết Giới thiệu về gói thuê bao để tìm hiểu cách xử lý những sự kiện này.
Ví dụ:
Dịch vụ xem trực tuyến FitnessGoals muốn chạy một chương trình khuyến mãi để khuyến khích mọi người tập thể dục thường xuyên vào tháng 2.
Họ quyết định tặng thêm một tháng sử dụng dịch vụ cho bất kỳ người đăng ký nào tập thể dục với FitnessGoals ít nhất 10 lần trong tháng 2.
Họ theo dõi kết quả của thử thách và vào ngày 1 tháng 3, họ gọi phương thức subscriptionsv2.defer cho mọi giao dịch mua gói thuê bao đang hoạt động của những người dùng đã hoàn thành thử thách trong tháng 2.
Những người dùng này được hưởng lợi từ việc có thêm một tháng tập thể dục miễn phí và họ đã giới thiệu cho bạn bè về cách FitnessGoals giúp họ giữ gìn sức khoẻ!
Hoàn tiền và thu hồi
Có nhiều trường hợp bạn có thể muốn hoàn tiền hoặc thu hồi quyền truy cập vào một gói thuê bao hoặc giao dịch mua hàng một lần.
Hoàn tiền đầy đủ cho một đơn đặt hàng theo mã đơn đặt hàng
Với orders.refund
API, bạn có thể hoàn tiền toàn bộ cho mọi đơn đặt hàng trong vòng 3 năm kể từ ngày mua.
Phương thức orders.refund nhận được tham số thu hồi cho biết liệu có nên thu hồi quyền truy cập hay không, ngoài việc hoàn tiền.
Nếu bạn đưa ra lệnh thu hồi kèm theo lệnh gọi hoàn tiền cho một giao dịch mua gói thuê bao, thì gói thuê bao đó sẽ bị chấm dứt ngay lập tức và kích hoạt cả Thông báo theo thời gian thực dành cho nhà phát triển SUBSCRIPTION_REVOKED và VoidedPurchaseNotification (được ghi lại trong Voided Purchases API). Hãy đọc phần Thu hồi trong hướng dẫn quản lý vòng đời gói thuê bao để tìm hiểu cách xử lý những sự kiện này.
Ví dụ:
Để chào mừng mùa giải mới, ứng dụng thể thao điện tử Football-Not-Soccer quyết định tặng áo đấu ảo miễn phí cho tất cả người dùng mua trang phục thi đấu mới trong 24 giờ đầu tiên.
Football-Not-Soccer sử dụng API
orders.refundmà không truyền tham số thu hồi để hoàn tiền mua áo đấu cho người chiến thắng.
Thu hồi và hoàn tiền cho gói thuê bao theo mã thông báo giao dịch mua
Trong một số trường hợp sử dụng, bạn có thể cần thu hồi quyền truy cập vào gói thuê bao của người dùng và hoàn tiền. Play Billing cung cấp các phương thức thu hồi, bao gồm cả hoàn tiền toàn bộ và hoàn tiền theo tỷ lệ thông qua API subscriptionsv2.revoke. Với điểm cuối này, bạn có thể chỉ định revocationContext để xác định cách tính tiền hoàn lại.
Thao tác này sẽ kích hoạt cả Thông báo theo thời gian thực dành cho nhà phát triển SUBSCRIPTION_REVOKED và VoidedPurchaseNotification, đồng thời được ghi lại trong Voided Purchases API. Ứng dụng của bạn phải xử lý các thao tác huỷ này như mô tả trong phần Thu hồi.
Ví dụ:
- Giao dịch mua có mã thông báo giao dịch mua
1a2b3c4d5e6f7g8h9i0j - Ứng dụng có tên gói
com.your.app - Ý định hoàn tiền theo tỷ lệ
Yêu cầu POST qua HTTP:
https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.your.app/purchases/subscriptionsv2/tokens/1a2b3c4d5e6f7g8h9i0j:revoke
Nội dung yêu cầu:
{
"revocationContext": {
"proratedRefund": {}
}
}
Hoàn lại toàn bộ tiền
Nếu bạn cần chấm dứt một gói thuê bao và hoàn lại toàn bộ số tiền của kỳ thanh toán hiện tại, hãy hoàn tiền toàn bộ. Sử dụng hàm purchases.subscriptionsv2.revoke và đặt "fullRefund": {} làm loại hoàn tiền.
Ví dụ:
Maria có một gói thuê bao tự động gia hạn 30 ngày cho gói xem trực tuyến hằng tháng của SuperMovies. Maria gặp phải một số vấn đề kỹ thuật khiến cô không thể truy cập vào nội dung. Cô ấy liên hệ với bộ phận dịch vụ khách hàng vào ngày thứ 3 của chu kỳ thanh toán và cho biết rằng cô ấy chưa bao giờ có quyền truy cập vào gói thuê bao.
Bộ phận dịch vụ khách hàng tìm thấy thông tin chi tiết về giao dịch mua gói thuê bao của Maria trong hệ thống của họ và kích hoạt lệnh gọi đến
purchases.subscriptionsv2.revokeđể yêu cầu hoàn tiền toàn bộ.Bộ phận dịch vụ khách hàng cho Maria biết rằng cô sẽ được hoàn lại 100% giá gói thuê bao và cô không còn đăng ký gói đó nữa.
Hoàn tiền theo tỷ lệ
Nếu bạn cần chấm dứt một gói thuê bao và hoàn tiền một phần cho thời gian
còn lại của quyền lợi, hãy hoàn tiền theo tỷ lệ. Sử dụng hàm purchases.subscriptionsv2.revoke và đặt "proratedRefund": {} làm loại hoàn tiền.
Chúng tôi hỗ trợ hoàn tiền theo tỷ lệ cho cả gói thuê bao tự động gia hạn và gói trả trước có thời hạn ít nhất một tuần.
Ví dụ:
Maria có một gói thuê bao tự động gia hạn 30 ngày cho gói xem trực tuyến hằng tháng của SuperMovies. Cô ấy đã sử dụng dịch vụ này một thời gian và rất hài lòng. Maria liên hệ với bộ phận dịch vụ khách hàng vào ngày thứ 15 trong chu kỳ thanh toán của mình để thông báo rằng cô sẽ chuyển ra nước ngoài và không thể sử dụng dịch vụ nữa kể từ ngày hôm sau.
Dịch vụ khách hàng tìm thấy thông tin chi tiết về giao dịch mua gói thuê bao của Maria trong hệ thống của họ và kích hoạt lệnh gọi đến
purchases.subscriptionsv2.revokeđể yêu cầu hoàn tiền theo tỷ lệ.Bộ phận dịch vụ khách hàng cho Maria biết rằng cô sẽ được hoàn lại khoảng 50% giá gói thuê bao và quyền truy cập vào dịch vụ sẽ bị chấm dứt ngay lập tức.