Thông báo giao dịch bị hủy cho phép máy chủ Google Play của bạn thu hồi quyền truy cập ngay khi một khoản hoàn tiền xảy ra

Một khoản hoàn tiền trên Google Play không nhất thiết phải là thứ bạn phát hiện sau này trong một báo cáo. Google Play có thể đẩy tới máy chủ của bạn một thông báo giao dịch bị hủy ngay lập tức khi một giao dịch bị hủy, dù người mua đã tự thực hiện hoàn tiền, một nhân viên hỗ trợ đã cấp nó, một ngân hàng đã buộc một khoản bồi hoàn, hay chính bạn đã hoàn tiền đơn hàng đó với cờ thu hồi được bật. Thông điệp rất nhỏ, nó nêu đúng giao dịch, và nó mang một chỉ dẫn, trả lại quyền lợi, vì tiền đã mất rồi.

Thông báo giao dịch bị hủy thực chất là gì

Thông báo giao dịch bị hủy là một loại trong các Real-time Developer Notifications của Google Play, hay RTDN. RTDN là một kênh đẩy. Google phát một thông điệp tới một topic Cloud Pub/Sub mà bạn sở hữu, và backend của bạn nhận được nó trong khoảnh khắc sau khi sự kiện xảy ra, thay vì biết được vào lần thăm dò theo lịch tiếp theo. Đó chính là toàn bộ điểm mấu chốt của thông báo giao dịch bị hủy so với đường pull cũ hơn: bạn biết về khoản hoàn tiền ngay khi nó xảy ra, không phải nhiều giờ sau đó.

Đường pull vẫn tồn tại và vẫn quan trọng. Voided Purchases API cho phép máy chủ của bạn hỏi, theo lịch riêng của bạn, danh sách các giao dịch đã bị hủy trong một khoảng thời gian. Hai cái này bổ trợ cho nhau. Thông báo cho bạn biết ngay khoảnh khắc một giao dịch thay đổi; API cho phép bạn đối soát hàng loạt và bù đắp bất cứ điều gì mà một thông điệp bị bỏ lỡ để lại.

Nó đi kèm bên trong một Real-time Developer Notification

Thông báo giao dịch bị hủy không bao giờ đến một mình. Nó nằm bên trong một lớp bọc DeveloperNotification, và lớp bọc đó được gửi đi dưới dạng một chuỗi mã hóa base64 duy nhất trong trường data của thông điệp Pub/Sub. Trình xử lý của bạn giải mã chuỗi đó thành JSON trước khi có thể đọc bất cứ thứ gì. Lớp bọc luôn nêu tên ứng dụng và thời điểm sự kiện, và nó chứa đúng một đối tượng thông báo trong số năm loại mà Google định nghĩa. Chúng loại trừ lẫn nhau, nên một thông điệp mang voidedPurchaseNotification sẽ không đồng thời mang một sự kiện đăng ký hay mua một lần.

Bốn trường mà nó mang theo

Bóc lớp bọc ra và bản thân thông báo giao dịch bị hủy chỉ là bốn trường. Điều đó cố tình gọn nhẹ. Quan điểm của Google là nếu tất cả những gì bạn cần là tìm đúng giao dịch và điều chỉnh quyền lợi, bốn trường này là đủ, và bạn không phải gọi lại bất kỳ API nào để hành động.

productType cho bạn biết cái gì đã bị hủy

productType là một số nguyên nhỏ, và nó quyết định đường thu hồi nào của bạn cần đi. Một khoản hủy gói đăng ký phải tháo gỡ quyền truy cập đang diễn ra; một khoản hủy giao dịch mua một lần chỉ cần gỡ bỏ một quyền lợi duy nhất.

refundType cho bạn biết bao nhiêu đã được trả lại

refundType phân tách một khoản đảo ngược toàn phần gọn gàng với một khoản một phần. Trường hợp một phần rất hẹp. Nó chỉ xuất hiện khi một giao dịch mua một lần nhiều số lượng được hoàn một phần, chứ không phải toàn bộ số lượng.

Bật nó lên trước, nếu không nó sẽ không bao giờ đến

Thông báo giao dịch bị hủy không tự động chảy về. Bạn bật RTDN một lần, trong Play Console, và trỏ nó tới một topic Pub/Sub mà bạn kiểm soát. Công tắc nằm dưới Monetize, rồi Monetization setup, trong mục Real-time developer notifications ở đầu trang. Đánh dấu Enable real-time notifications, rồi dán tên topic đầy đủ của bạn theo dạng projects/{project_id}/topics/{topic_name}, và dùng Send Test Message để xác nhận đường ống hoạt động trước khi bạn tin nó.

Công tắc nội dung là nơi mọi người bỏ lỡ giao dịch bị hủy. Cả hai lựa chọn đều bao gồm chúng, nên bạn không thể vô tình từ chối hoàn tiền trong khi vẫn giữ các gói đăng ký.

• Nhận thông báo cho các gói đăng ký và tất cả giao dịch bị hủy. Bạn nhận các sự kiện đăng ký và mọi giao dịch bị hủy, nhưng không nhận các sự kiện mua sản phẩm một lần.
• Nhận tất cả thông báo cho các gói đăng ký và sản phẩm mua một lần. Bạn nhận những cái trên cộng với các sự kiện sản phẩm mua một lần như ONE_TIME_PRODUCT_PURCHASED và ONE_TIME_PRODUCT_CANCELED.

Nó tốn kém bao nhiêu, tính bằng tiền

Một khoản hủy là một tổn thất đã được ghi sổ vào thời điểm thông báo đến tay bạn. Giá bán đã mất, và cả những gì bạn đã chi để phục vụ khách hàng đó cũng vậy. Nếu họ đã tạo ra hình ảnh, chạy các lệnh gọi tới các mô hình của bạn, dùng dung lượng lưu trữ, hay kích hoạt một khoản chi trả cho bên thứ ba, những chi phí đó đã được trả bằng tiền thật và không quay lại cùng khoản hoàn tiền. Thông báo không thể phục hồi bất kỳ điều nào trong số đó. Điều nó có thể làm là chặn dòng chảy máu từ đây trở đi, và đó là toàn bộ lý do để hành động nhanh với nó.

Sự chảy máu tồi tệ nhất ở các gói đăng ký và tồi tệ nhất ở các khoản bồi hoàn. Một gói đăng ký mà bạn không thu hồi sẽ tiếp tục tốn kém để phục vụ, tháng này qua tháng khác, cho một khách hàng không còn trả tiền. Và một khoản bồi hoàn là loại hủy đắt đỏ nhất. Từ August 3, 2026, tài liệu của Google nêu rằng một khoản bồi hoàn chuyển giá mua cộng với phí của ngân hàng cho nhà phát triển. Thông báo giao dịch bị hủy thường là nơi đầu tiên mà chính các hệ thống của bạn nghe được rằng một khoản bồi hoàn đã hoàn tất, nên một trình xử lý thu hồi ngay tại chỗ là điều giữ cho một khoản bán bị mất không biến thành một khoản bán bị mất cộng với nhiều tuần phục vụ miễn phí.

Cách xử lý một thông báo giao dịch bị hủy, từng bước

Xác minh và loại trùng lặp thông điệp

• Xác nhận thông điệp Pub/Sub đến từ Google và nhắm tới topic bạn đã cấu hình, rồi giải mã trường data base64 để lấy JSON DeveloperNotification.
• Dùng messageId của Pub/Sub để loại bỏ bản trùng. Google cảnh báo rằng cùng một thông báo có thể được gửi nhiều hơn một lần, nên hãy coi việc phát lại là bình thường và làm cho trình xử lý của bạn có tính idempotent.
• Chỉ xác nhận (acknowledge) thông điệp sau khi bạn đã ghi lại nó an toàn, để một sự cố giữa chừng trình xử lý không làm mất sự kiện.

Tra cứu giao dịch

• Khớp purchaseToken với giao dịch bạn đã lưu khi lần đầu cấp quyền lợi. Dùng orderId làm phương án dự phòng cho tra cứu hỗ trợ và đối soát thủ công.
• Đọc productType để chọn đường thu hồi gói đăng ký hoặc mua một lần, và đọc refundType để quyết định giữa thu hồi toàn phần và một phần.

Thu hồi và ghi lại

• Gỡ bỏ quyền lợi. Với hoàn tiền toàn phần, cắt quyền truy cập vào món hàng. Với hoàn tiền một phần theo số lượng, giảm số lượng đã cấp đi đúng lượng đã hoàn và giữ nguyên phần còn lại.
• Ghi lại bạn đã làm gì và khi nào, khóa theo purchaseToken và orderId. Bản ghi đó là thứ cho phép bạn trả lời một phiếu hỗ trợ về sau, và là thứ cho phép Voided Purchases API đối soát gọn gàng với trạng thái của chính bạn.

Nó nằm ở đâu giữa các tín hiệu hoàn tiền khác

Một thông báo giao dịch bị hủy là một thông báo, không phải một cuộc thương lượng. Nó cho bạn biết một kết quả đã được quyết định. Đáng để đặt nó bên cạnh các tín hiệu dễ bị nhầm lẫn với nó, vì chỉ một số trong chúng từng hỏi phía câu chuyện của bạn.

Điều cần ghi nhớ rất đơn giản. Trên cả hai cửa hàng có đúng hai luồng hoàn tiền mà nhà phát triển có tiếng nói, CONSUMPTION_REQUEST của Apple và quy trình xét duyệt bồi hoàn của Google Play. Một thông báo giao dịch bị hủy không phải là cái nào cả. Đến lúc nó tới tay bạn, quyết định đã ở sau lưng bạn và điều duy nhất còn lại trong tay bạn là bạn thu hồi nhanh đến mức nào.