Tất cả bài viết
Phân tích chuyên sâuĐọc trong 7 phút

Play Billing Library 8 giờ là bắt buộc cho mọi bản cập nhật trên Google Play và chuyển việc theo dõi hoàn tiền về máy chủ của bạn

Thời gian gia hạn của Google cho Play Billing Library 7 đã hết vào ngày 1 tháng 11 năm 2026, nên ứng dụng mới và bản cập nhật cần phiên bản 8 trở lên. Phiên bản 8 đã gỡ bỏ queryPurchaseHistory(), nghĩa là các giao dịch đã hoàn tiền và đã tiêu thụ phải được theo dõi phía máy chủ. Dưới đây là những gì đã thay đổi và cái giá của một đợt chuyển đổi chậm trễ.

Bàn làm việc của một lập trình viên Android trong nắng sớm, với laptop, điện thoại và tấm lịch treo tường có một ngày được khoanh tròn, đúng tuần Play Billing Library 8 trở thành mức tối thiểu cho các bản cập nhật trên Google Play

Điểm chính

  • Bảng ngừng hỗ trợ của Google đặt ngày 31 tháng 8 năm 2026 là hạn cuối cho ứng dụng mới và bản cập nhật dùng Play Billing Library 7, với gia hạn kết thúc ngày 1 tháng 11 năm 2026, nên mọi bản cập nhật trên Google Play giờ cần Play Billing Library 8 trở lên.
  • Các ứng dụng đang chạy trên Play Billing Library 7 vẫn hoạt động, vì Google cho biết việc ngừng hỗ trợ chỉ chặn ứng dụng mới và bản cập nhật, không ảnh hưởng đến các bản đã cài đặt.
  • Play Billing Library 8 đã gỡ bỏ queryPurchaseHistory(), và phương án thay thế của Google nằm phía máy chủ: tự theo dõi giao dịch đã tiêu thụ trên backend của bạn và lấy các giao dịch đã hoàn tiền hoặc đã hủy từ Voided Purchases API.
  • Voided Purchases API của Google Play chỉ hiển thị giao dịch bị vô hiệu trong 30 ngày gần nhất và cho phép 6.000 truy vấn mỗi ngày và 30 truy vấn trong bất kỳ khoảng 30 giây nào cho mỗi ứng dụng.
  • Google Play vẫn tự động hoàn tiền một giao dịch và thu hồi quyền sử dụng nếu ứng dụng không xác nhận nó trong vòng ba ngày, và một đợt chuyển đổi Play Billing Library 8 bị lỗi có thể khiến điều đó xảy ra với mọi giao dịch bán.
  • Quy trình xem xét chargeback của Google Play là luồng hoàn tiền Android duy nhất yêu cầu nhà phát triển cung cấp bằng chứng, thông qua orders.reviewrefund trong vòng 24 giờ kể từ PendingRefundReviewNotification.
  • Với các đơn hàng Google Play đặt sau ngày 3 tháng 8 năm 2026, nhà phát triển chịu giá mua, trừ phí dịch vụ của Play, cộng thêm phí chargeback của ngân hàng cho mỗi chargeback bị thua.

Mọi ứng dụng Android bán hàng qua Google Play giờ phải phát hành Play Billing Library 8 trở lên trong bản cập nhật kế tiếp. Hạn cuối của phiên bản 7 cho ứng dụng mới và bản cập nhật là ngày 31 tháng 8 năm 2026, và các đợt gia hạn cuối cùng đã hết vào ngày 1 tháng 11 năm 2026. Các mốc này nằm trong một bảng ở trang FAQ về ngừng hỗ trợ của Google, và lời nhắc xuất hiện dưới dạng cảnh báo trên trang Policy status của Play Console.

Với hầu hết các nhóm, đây chỉ là nâng phiên bản thư viện và đổi tên vài phương thức. Với hoàn tiền thì không đơn giản như vậy. Play Billing Library 8 đã xóa lệnh gọi phía client duy nhất cho phép ứng dụng xem lại các giao dịch trước đây. Từ giờ, nếu muốn biết người dùng đã mua gì, đã tiêu thụ gì hay được hoàn tiền gì, máy chủ của bạn phải tự ghi nhớ.

Hạn chót Play Billing Library 8 thực sự chặn những gì

Google cho mỗi phiên bản thư viện vòng đời hai năm. Việc ngừng hỗ trợ chỉ chặn ứng dụng mới và bản cập nhật. FAQ của Google cho biết ứng dụng hiện có vẫn hoạt động và các APK không còn được bảo trì không cần cập nhật. Vậy nên hôm nay chưa có gì hỏng với một ứng dụng bạn đã thôi đụng tới. Nó chỉ hỏng vào ngày bạn cố phát hành một bản sửa lỗi, một mức giá mới hay một paywall mới.

Phiên bản thư việnHạn cho ứng dụng mới và bản cập nhậtHạn gia hạn
631 tháng 8 năm 20251 tháng 11 năm 2025
731 tháng 8 năm 20261 tháng 11 năm 2026
831 tháng 8 năm 20271 tháng 11 năm 2027
931 tháng 8 năm 20281 tháng 11 năm 2028

Phiên bản 8.0.0 ra mắt ngày 30 tháng 6 năm 2025. Phiên bản 9.0.0 tiếp theo vào ngày 19 tháng 5 năm 2026. Nếu bạn đang chuyển đổi lúc này, đi thẳng lên 9 cho bạn thêm một năm so với dừng ở 8.

Vì sao Play Billing Library 8 quan trọng với hoàn tiền

Thay đổi lớn nhất là việc gỡ bỏ queryPurchaseHistory(). Nó bị đánh dấu ngừng hỗ trợ ở phiên bản 7 và bị gỡ bỏ ở phiên bản 8.0.0. Ghi chú chuyển đổi của Google chia công việc cũ của nó thành ba phần, và chỉ một phần còn ở trên thiết bị.

Bạn từng dùng queryPurchaseHistory() để làm gìGoogle bảo dùng gì bây giờChạy ở đâu
Giao dịch đang hoạt động và đang chờqueryPurchasesAsync()Trên thiết bị
Giao dịch một lần đã tiêu thụDữ liệu do bạn tự lưuMáy chủ của bạn
Giao dịch đã hoàn tiền, đã hủy hoặc bị chargebackVoided Purchases APIMáy chủ của bạn
Toàn bộ lịch sử mua của người dùngDữ liệu do bạn tự lưuMáy chủ của bạn

Tôi còn khôi phục được giao dịch tiêu hao trên Android không?

Không phải từ client. queryPurchasesAsync() trả về những gì đang hoạt động, nên một gói tín dụng đã tiêu thụ hay một gói ngọc đã dùng hết sẽ không bao giờ quay lại qua lệnh này. Nếu người dùng cài lại ứng dụng và hỏi số xu của họ đi đâu, câu trả lời phải đến từ sổ ghi chép bạn lưu lúc giao dịch diễn ra. Những ứng dụng từng dựa vào lịch sử mua như một bản sao lưu miễn phí giờ đã mất nó.

Giờ làm sao tôi biết về các khoản hoàn tiền?

Có hai kênh phía máy chủ. Real-time developer notifications gửi một VoidedPurchaseNotification kèm purchase token, mã đơn hàng, loại sản phẩm và loại hoàn tiền, là hoàn tiền toàn phần hoặc hoàn tiền một phần theo số lượng. Voided Purchases API cho phép bạn kéo cùng các sự kiện đó theo khoảng thời gian, làm lớp dự phòng cho những gì bạn bỏ sót.

API kéo dữ liệu này có giới hạn cứng. Nó chỉ hiển thị giao dịch bị vô hiệu trong 30 ngày gần nhất. Mỗi ứng dụng được 6.000 truy vấn mỗi ngày và 30 truy vấn trong bất kỳ khoảng 30 giây nào. Và một khoản hoàn tiền do nhà phát triển thực hiện mà không chọn thu hồi sẽ hoàn toàn không được trả về. Một máy chủ ngừng hoạt động năm tuần sẽ mất những khoản hoàn tiền không bao giờ kéo lại được.

Một kỹ sư cầm máy tính bảng trong dãy máy chủ yên tĩnh, nơi các giao dịch Google Play đã hoàn tiền và đã tiêu thụ giờ phải được ghi lại sau khi Play Billing Library 8 gỡ bỏ lịch sử mua phía client

Những khoản hoàn tiền nhà phát triển vẫn có tiếng nói

Chuyển việc theo dõi hoàn tiền lên máy chủ không cho bạn thêm quyền kiểm soát hoàn tiền. Gần như mọi khoản hoàn tiền trên Google Play được quyết định mà không cần bạn: hoàn tiền tự phục vụ, hoàn tiền qua bộ phận hỗ trợ, hủy giao dịch và hoàn tiền tự động cho giao dịch chưa được xác nhận. Bạn chỉ biết về chúng sau khi sự việc đã xảy ra, qua thông báo giao dịch bị vô hiệu.

Ngoại lệ là xem xét chargeback. Khi người mua gửi một chargeback cần ý kiến của bạn, Google gửi một PendingRefundReviewNotification. Google cho biết bạn nên trả lời bằng một đề xuất hoàn tiền và bằng chứng sử dụng trong vòng 24 giờ bằng cách gọi orders.reviewrefund. Bằng chứng đó đến từ chính các bản ghi trên máy chủ mà thư viện mới buộc bạn phải lưu. Một nhóm đã giữ sổ ghi chép để khôi phục giao dịch thì đã có sẵn thứ cần để trả lời.

Một đợt chuyển đổi chậm trễ tốn bao nhiêu tiền

Rủi ro trực tiếp là quy tắc ba ngày. Google Play tự động hoàn tiền một giao dịch và thu hồi quyền sử dụng nếu ứng dụng của bạn không xác nhận nó trong vòng ba ngày. Với giao dịch đang chờ, đồng hồ bắt đầu khi giao dịch chuyển từ PENDING sang PURCHASED. Một đợt chuyển đổi làm hỏng logic kết nối, listener queryProductDetailsAsync() mới hoặc phần thiết lập giao dịch đang chờ có thể làm ngừng việc xác nhận mà không làm ngừng doanh số. Mọi đơn hàng trong khoảng trống đó đều bị hoàn tiền toàn bộ, trong khi người dùng đã nhận được thứ họ trả tiền.

Đó là chỗ đau. Một gói tín dụng tạo ảnh bị hoàn tiền vẫn đã đốt thời gian GPU cho mỗi lần tạo. Một gói AI bị hoàn tiền vẫn đã chạy các lệnh gọi API trả phí. Một gói lưu trữ bị hoàn tiền vẫn đã lấp đầy ổ đĩa bạn trả tiền thuê. Một khoản tip bị hoàn tiền vẫn đã được chi cho nhà sáng tạo. Khoản hoàn tiền trả doanh thu về cho người mua và để lại các hóa đơn đó cho bạn.

Chargeback cũng đắt hơn. Trung tâm trợ giúp của Google cho biết với các đơn hàng đặt sau ngày 3 tháng 8 năm 2026, nhà phát triển chịu giá mua, trừ phí dịch vụ của Play, cộng thêm phí chargeback từ ngân hàng. Google chỉ còn tiếp tục chịu phần phí dịch vụ của chính mình. Một ứng dụng không thể trả lời một yêu cầu xem xét chargeback trong 24 giờ bằng dữ liệu sử dụng thực sẽ trả toàn bộ hóa đơn đó mỗi lần.

Danh sách kiểm tra chuyển đổi để bảo vệ doanh thu

  • Nâng thư viện lên Play Billing Library 8 hoặc 9 và gỡ bỏ queryPurchaseHistory(), querySkuDetailsAsync() cùng enablePendingPurchases() không tham số.
  • Cập nhật listener queryProductDetailsAsync(). Từ phiên bản 8, nó còn trả về cả các sản phẩm không lấy được, kèm mã trạng thái.
  • Bật enableAutoServiceReconnection() để một kết nối thanh toán bị ngắt không làm đình trệ việc xử lý giao dịch.
  • Gọi queryPurchasesAsync() trong onResume() để các giao dịch hoàn tất khi ứng dụng đang đóng vẫn được xác nhận trong vòng ba ngày.
  • Ghi lại mọi purchase token, mã đơn hàng và lần tiêu thụ trên máy chủ, gắn với ID tài khoản của chính bạn.
  • Đăng ký real-time developer notifications và xử lý cả VoidedPurchaseNotification lẫn PendingRefundReviewNotification.
  • Chạy đồng bộ Voided Purchases API hằng ngày làm lưới an toàn, nằm gọn trong khoảng 30 ngày và hạn mức 6.000 truy vấn mỗi ngày.

RefundHalt lắng nghe các thông báo giao dịch bị vô hiệu và xem xét chargeback của Google Play, trả lời từng yêu cầu xem xét qua orders.reviewrefund trong khung 24 giờ bằng dữ liệu sử dụng thực của bạn, và lưu giữ lịch sử hoàn tiền mà ứng dụng của bạn không còn hỏi được từ thiết bị.

Câu hỏi thường gặp

Tôi có bắt buộc phải dùng Play Billing Library 8 bây giờ không?
Có, với mọi ứng dụng mới hoặc bản cập nhật bán hàng qua hệ thống thanh toán của Google Play. Bảng ngừng hỗ trợ của Google đặt ngày 31 tháng 8 năm 2026 là hạn chót cho phiên bản 7, và các đợt gia hạn đã kết thúc ngày 1 tháng 11 năm 2026. Bạn có thể dùng phiên bản 8 hoặc phiên bản 9 mới hơn.
Ứng dụng hiện có của tôi có ngừng hoạt động nếu vẫn dùng Play Billing Library 7 không?
Không. Google cho biết ứng dụng hiện có vẫn hoạt động và các APK không còn được bảo trì không cần cập nhật. Việc ngừng hỗ trợ chỉ chặn bạn phát hành ứng dụng mới hoặc bản cập nhật dùng phiên bản không còn được hỗ trợ.
Cái gì đã thay thế queryPurchaseHistoryAsync trong Play Billing Library 8?
Không có gì trên thiết bị làm cùng việc đó. Google bảo dùng queryPurchasesAsync() cho giao dịch đang hoạt động và đang chờ, tự theo dõi giao dịch đã tiêu thụ trên máy chủ của bạn, và dùng Voided Purchases API cho giao dịch đã hủy hoặc đã hoàn tiền.
Voided Purchases API của Google Play truy ngược được bao xa?
30 ngày. Google cho biết API chỉ có thể hiển thị giao dịch bị vô hiệu xảy ra trong 30 ngày gần nhất, và giới hạn mỗi ứng dụng ở 6.000 truy vấn mỗi ngày và 30 truy vấn trong bất kỳ khoảng 30 giây nào.
Google Play có hoàn tiền một giao dịch nếu ứng dụng của tôi không xác nhận nó không?
Có. Nếu một giao dịch không được xác nhận trong vòng ba ngày, người dùng sẽ tự động được hoàn tiền và Google Play thu hồi giao dịch. Với giao dịch đang chờ, ba ngày bắt đầu tính khi trạng thái chuyển từ PENDING sang PURCHASED.

Nguồn và tài liệu đọc thêm

RefundHalt

Chế độ tự động xử lý hoàn tiền cho App Store và Google Play

Đọc tiếp

Yêu cầu hoàn tiền tiếp theo đã đang trên đường đến.

Thiết lập RefundHalt trong khoảng thời gian bạn cần để đọc thêm một email hỗ trợ về khoản hoàn tiền mà mình chưa kịp phản biện.