Mỗi lần gia hạn có mã đơn hàng Google Play riêng, và đó là con số cần kiểm tra trước khi hoàn tiền cho bất kỳ ai

Hãy nhìn vào phần cuối của mã đơn hàng trước khi hoàn tiền cho một khách hàng Google Play. GPA.1234-5678-9012-34567 là khoản phí đầu tiên của một gói thuê bao. GPA.1234-5678-9012-34567..2 là khoản thứ ba. Chúng dùng chung phần gốc, nhưng là những khoản thanh toán khác nhau, và Play Console xử lý chúng khác nhau khi bạn hoàn tiền. Mã đơn hàng Google Play là mã nhận dạng duy nhất khách hàng nhìn thấy được, nên đó là mã sẽ xuất hiện trong hộp thư hỗ trợ của bạn. Đọc đúng mã, bạn sẽ hoàn đúng khoản phí họ thực sự phàn nàn, và chỉ một lần.

Mã đơn hàng Google Play cho bạn biết điều gì

Tài liệu Play Billing Library của Google mô tả định dạng qua ví dụ. Mã đơn hàng bắt đầu bằng GPA, sau đó là các nhóm chữ số. Với gói thuê bao, mỗi lần gia hạn nhận mã đơn hàng gốc cộng thêm hai dấu chấm và một bộ đếm bắt đầu từ số không. Vì vậy, giao dịch mua ban đầu không có hậu tố, lần gia hạn đầu tiên là ..0, lần thứ hai là ..1, và cứ thế tiếp tục.

Nhờ đó, hậu tố cho bạn biết nhanh một người đã trả tiền bao lâu. Khách hàng viết thư về GPA.3333-4137-0319-36762..11 đã được gia hạn mười hai lần. Khách hàng đưa ra mã gốc không có hậu tố thì hoặc chỉ mua một lần, hoặc đang nói đến khoản thanh toán đầu tiên của họ.

Mã đơn hàng xuất hiện ở đâu, và bạn nhận được phiên bản nào

Đây là chỗ nhiều nhóm vấp phải. Mỗi nơi trả cho bạn một dạng khác nhau của cùng một mã.

• Biên lai Google Play của khách hàng hiển thị mã đơn hàng của khoản phí tương ứng, kể cả các lần gia hạn.
• Trong ứng dụng của bạn, Purchase.getOrderId() từ Play Billing Library trả về mã của đơn hàng ban đầu cho các lần gia hạn thuê bao. Ví dụ của chính Google: thay vì GPA.1234-5678-9012-34567..0, bạn nhận được GPA.1234-5678-9012-34567.
• Trên máy chủ của bạn, purchases.subscriptionsv2 cung cấp cho mỗi line item một latestSuccessfulOrderId, là mã của đơn hàng thành công gần nhất cho mục đó. Google thêm trường này vào ngày 21 tháng 5 năm 2025.
• Trong Voided Purchases API, orderId xác định duy nhất một giao dịch mua một lần, một giao dịch mua thuê bao hoặc một lần gia hạn thuê bao. Tài liệu của Google khuyên dùng orderId, không phải purchase token, để phân biệt các lần gia hạn.

Purchase token thực ra dùng để làm gì

Purchase token xác định toàn bộ giao dịch mua. Với gói thuê bao, một token bao gồm khoản phí ban đầu và mọi lần gia hạn sau đó. Vì vậy, đó là khóa đúng cho quyền sử dụng nhưng là khóa sai cho việc hoàn tiền. Hoàn tiền và chargeback xảy ra trên một khoản phí duy nhất, và chỉ mã đơn hàng mới chỉ đúng một khoản phí.

Cách tra cứu một đơn hàng Google Play

Trong Play Console

Quản lý đơn hàng (Order management) chấp nhận mã đơn hàng hoặc địa chỉ email đầy đủ của khách hàng trong ô tìm kiếm. Mỗi đơn hàng hiển thị một trong các trạng thái sau: Đã xử lý (Processed), Đã hủy (Cancelled), Đang chờ (Pending), Đang chờ hoàn tiền (Pending refund), Đã hoàn tiền (Refunded), Đang chờ hoàn tiền một phần (Pending partial refund) hoặc Đã hoàn tiền một phần (Partially refunded). Nếu khách hàng đưa email thay vì biên lai, hãy tìm theo email và chọn khoản phí theo ngày, rồi xác nhận hậu tố trước khi hành động.

Với Orders API

Kể từ ngày 21 tháng 5 năm 2025, tài nguyên Orders trong Google Play Developer API có orders.get cho một đơn hàng và orders.batchget cho một danh sách. Một vài giới hạn quan trọng trong thực tế:

• batchget nhận từ 1 đến 1.000 mã đơn hàng mỗi yêu cầu, và các mã phải khác nhau.
• Nếu bất kỳ mã đơn hàng nào không được tìm thấy hoặc không thuộc gói ứng dụng, toàn bộ yêu cầu batchget sẽ thất bại.
• Các lệnh gọi Orders API được tính vào hạn mức Play Developer API của bạn, mặc định là 200.000 lệnh gọi mỗi ngày.

Order trả về mới là phần hữu ích. Nó chứa state của đơn hàng, purchaseToken, createTime và lastEventTime, tổng tiền và thuế, một salesChannel như IN_APP hoặc PLAY_STORE, và một orderHistory gồm các sự kiện xử lý, hủy, hoàn tiền và hoàn tiền một phần. Nó cũng có developerRevenueInBuyerCurrency, được Google định nghĩa là doanh thu của bạn tính bằng đơn vị tiền tệ của người mua, đã trừ các khoản hoàn tiền một phần, thuế và phí. Khi Google là bên bán hàng chính thức (merchant of record), địa chỉ người mua chỉ chứa quốc gia.

Hoàn tiền đúng đơn hàng

Khi đã biết khách hàng nói đến khoản phí nào, Play Console cho bạn một lựa chọn phụ thuộc vào vị trí của đơn hàng đó trong gói thuê bao.

Qua API, orders.refund nhận tên gói ứng dụng và mã đơn hàng. Đơn hàng cũ hơn 3 năm không thể được hoàn tiền. Tham số tùy chọn revoke, khi đặt là true, chấm dứt ngay quyền truy cập vào gói thuê bao hoặc vật phẩm trong ứng dụng. Trang trợ giúp của Google cũng lưu ý rằng không thể đảo ngược khoản hoàn tiền sau khi đã thực hiện, nên mã đơn hàng bạn truyền vào là quyết định cuối cùng.

Vì sao một đơn hàng $0.00 xuất hiện với người đăng ký?

Tài liệu về vòng đời gói thuê bao của Google giải thích điều này. Khi người dùng đăng ký lại từ ứng dụng của bạn cho cùng một base plan trước khi gói thuê bao hết hạn, Google Play tạo một đơn hàng $0.00. Họ không bị tính phí vì đã trả cho kỳ hiện tại, và việc thanh toán bình thường tiếp tục vào ngày gia hạn ban đầu. Đây không phải dùng thử miễn phí hay khuyến mãi. Không có gì để hoàn trên đơn hàng đó. Nếu khách hàng muốn lấy lại tiền, hãy tìm đơn hàng có trả phí trước nó.

Hoàn tiền nhầm đơn hàng khiến bạn mất gì

Hoàn tiền trả lại giá bán. Hoàn tiền một phần cũng vận hành như vậy theo tỷ lệ. Ví dụ của Google: hoàn tiền một phần 50% cũng thu lại 50% khoản thanh toán cho bạn và 50% phí dịch vụ. Thứ không quay lại là mọi chi phí bạn đã bỏ ra để phục vụ khách hàng đó, gồm tài nguyên tính toán, lệnh gọi API bên thứ ba, lưu trữ và mọi khoản chi cho đối tác liên kết. Hoàn nhầm đơn hàng, bạn sẽ trả khoản đó hai lần.

Chuyện xảy ra như sau. Một khách hàng dùng gói tháng viết thư về khoản phí ..4, khoản của tuần trước. Một người trong nhóm bạn tìm theo email, thấy đơn hàng đầu tiên ở trên cùng, và nhấn Chỉ hoàn tiền trên đơn hàng gốc từ nhiều tháng trước. Giờ khách hàng được hoàn tiền cho một kỳ họ đã sử dụng. Khoản phí họ phàn nàn vẫn còn nguyên, và gói thuê bao của họ vẫn tiếp tục gia hạn. Họ vẫn có thể yêu cầu ngân hàng đảo ngược khoản phí tuần trước.

Con đường qua ngân hàng giờ đây là con đường tốn kém. Với các đơn hàng đặt sau ngày 3 tháng 8 năm 2026, Google cho biết khi một chargeback được chấp nhận, nhà phát triển chịu trách nhiệm cho giá mua, trừ phí dịch vụ của Play, cộng thêm phí chargeback mà ngân hàng thu. Chargeback là quyết định cuối cùng tại ngân hàng. Một hậu tố đọc nhầm có thể dẫn đến mất số tiền bằng hai lần hoàn tiền, cộng thêm phí.

Những khoản hoàn tiền không bao giờ đến hộp thư của bạn

Phần lớn các khoản hoàn tiền Google Play hoàn toàn không cần đến bạn hay mã đơn hàng. Chính sách hoàn tiền của Google cho biết khách hàng có thể được hoàn tiền trong vòng 48 giờ sau khi mua thông qua Google Play, và sau 48 giờ thì nên liên hệ nhà phát triển. Google cũng hoàn tiền và thu hồi các gói thuê bao mà bạn không acknowledge trong vòng ba ngày. Bạn chỉ biết về những trường hợp đó sau này qua Voided Purchases API, nơi báo cáo voidedSource (0 là Người dùng, 1 là Nhà phát triển, 2 là Google) và một voidedReason như Remorse, Chargeback hoặc Unacknowledged_purchase.

Chỉ có một quy trình hoàn tiền của Google Play yêu cầu ý kiến từ phía bạn. Khi một chargeback cần nhà phát triển xem xét, bạn có 24 giờ để phản hồi qua orders.reviewrefund với lựa chọn hoàn tiền APPROVE, DECLINE hoặc NEUTRAL cùng bằng chứng sử dụng giao dịch mua. RefundHalt thay bạn trả lời yêu cầu xem xét đó trong thời hạn, dựa trên dữ liệu sử dụng bạn đã có, để một đơn hàng bị tranh chấp nhận được bằng chứng của bạn thay vì sự im lặng.

Danh sách kiểm tra ngắn cho phiếu hỗ trợ liên quan đến mã đơn hàng

• Yêu cầu mã đơn hàng đầy đủ trên biên lai Google Play, bao gồm cả hậu tố.
• Tra cứu trong Play Console hoặc bằng orders.get, và kiểm tra state trước tiên.
• Xác nhận ngày tính phí khớp với mô tả của khách hàng.
• Chỉ dùng Hoàn tiền và thu hồi cho đơn hàng gần nhất, và Chỉ hoàn tiền cho các đơn hàng cũ hơn.
• Ghi lại mã đơn hàng bạn đã hoàn tiền, để dễ nhận ra một chargeback sau này trên đơn hàng khác.