Quyền của tài khoản dịch vụ Google Play quyết định ai có thể hoàn tiền đơn hàng của bạn, vì vậy hãy cấp tập quyền hẹp nhất vẫn đủ dùng
Chỉ một quyền trong Play Console đã cho phép tài khoản dịch vụ hoàn tiền bất kỳ đơn hàng nào và hủy bất kỳ gói đăng ký nào. Đây là những quyền tài khoản dịch vụ Google Play mà công cụ hoàn tiền thực sự cần, những gì một khóa bị rò rỉ có thể làm trên từng cửa hàng, và cách giới hạn, xoay vòng và thu hồi khóa.

Điểm chính
- Quyền Manage orders and subscriptions (Quản lý đơn hàng và gói đăng ký) của Google Play cho phép người nắm giữ xem đơn hàng, hoàn tiền đơn hàng và hủy gói đăng ký, nên bất kỳ tài khoản dịch vụ nào có quyền này đều có thể chuyển tiền trả lại cho người mua của bạn.
- Hướng dẫn Play Developer API của Google cho biết Google Play Billing APIs cần hai quyền Play Console: View financial data, orders, and cancellation survey responses, và Manage orders and subscriptions.
- Phương thức orders.refund của Google Play Developer API có thể hoàn tiền bất kỳ đơn hàng mua một lần hoặc gói đăng ký nào có tuổi tối đa 3 năm, và khi đặt revoke thành true, quyền truy cập của người mua chấm dứt ngay lập tức.
- Khóa tài khoản dịch vụ Google Cloud mặc định không hết hạn, và Google cho biết một khóa đã bị commit vào kho mã phải được xóa trong IAM, vì chỉ gỡ nó khỏi kho mã là chưa đủ.
- In-App Purchase key của Apple không thể hoàn tiền, nhưng có thể gọi App Store Server API, bao gồm các endpoint gia hạn ngày gia hạn gói đăng ký thêm tối đa 90 ngày, một khoản gia hạn mà Apple cho biết không thể đảo ngược.
- Chỉ Account Holder hoặc Admin mới có thể tạo In-App Purchase key trong App Store Connect, khóa riêng tư chỉ tải xuống được một lần, và khóa đã thu hồi thì không thể khôi phục.
Cấp cho một tài khoản dịch vụ hai quyền Play Console, và nó có thể hoàn tiền bất kỳ đơn hàng nào trong ứng dụng của bạn. Đó không phải là cấu hình sai. Đó chính xác là cách Google xây dựng Google Play Developer API, và đó là lý do khóa JSON đứng sau công cụ hoàn tiền của bạn cần được bảo vệ cẩn trọng như thông tin đăng nhập ngân hàng.
Hầu hết các nhóm thiết lập việc này một lần, trong lúc chạy hạn, bằng cách đánh dấu bất cứ thứ gì giúp lệnh gọi API đầu tiên thành công. Hướng dẫn này đi theo chiều ngược lại. Nó liệt kê những quyền tài khoản dịch vụ Google Play mà công việc hoàn tiền và chargeback thực sự cần, mỗi cửa hàng cho phép một khóa bị đánh cắp làm gì, và cách giữ phạm vi thiệt hại ở mức nhỏ.
Quyền của tài khoản dịch vụ Google Play thực sự cho phép làm gì
Tài khoản dịch vụ là một người dùng robot. Bạn tạo nó trong Google Cloud, rồi mời địa chỉ email của nó trong Play Console tại Users and permissions (Người dùng và quyền), giống như cách bạn mời một đồng nghiệp. Từ đó trở đi, nó có thể làm bất cứ điều gì các quyền đó cho phép, qua API, vào bất kỳ giờ nào, mà không cần yếu tố xác thực thứ hai.
Hai quyền mà các API thanh toán yêu cầu
Hướng dẫn Play Developer API của Google nói rất cụ thể. Để dùng Google Play Billing APIs, bạn cấp hai quyền: View financial data, orders, and cancellation survey responses (Xem dữ liệu tài chính, đơn hàng và phản hồi khảo sát hủy), và Manage orders and subscriptions (Quản lý đơn hàng và gói đăng ký). Quyền thứ nhất cho phép tài khoản đọc đơn hàng và dùng Purchases API. Quyền thứ hai là quyền đụng đến tiền.
| Quyền Play Console | Google nói quyền này cho phép gì | Có thể trả tiền lại cho người mua không |
|---|---|---|
| View financial data, orders, and cancellation survey responses | Xem báo cáo tài chính, báo cáo doanh số và đơn hàng, truy cập Purchases API, tải xuống phản hồi khảo sát hủy | Không |
| Manage orders and subscriptions | Xem đơn hàng, hoàn tiền đơn hàng, hủy gói đăng ký | Có |
| Admin (tất cả quyền) | Mọi quyền khác, cộng thêm mời người dùng và thay đổi quyền của họ | Có, và có thể tự cấp thêm quyền cho mình |
Một khóa có quyền hoàn tiền có thể làm gì
Phương thức orders.refund của Google Play Developer API hoàn tiền một đơn hàng gói đăng ký hoặc mua hàng trong ứng dụng của người dùng. Google cho biết đơn hàng cũ hơn 3 năm không thể hoàn tiền, nghĩa là mọi đơn mới hơn đều có thể. Đặt revoke thành true và quyền truy cập của người mua chấm dứt ngay. Với gói đăng ký, purchases.subscriptionsv2.revoke kèm hoàn tiền toàn bộ làm được điều tương tự.
Đó là những công cụ đúng khi bạn chủ ý dùng chúng. Chính hướng dẫn chống gian lận của Google khuyên bạn hoàn tiền và thu hồi một giao dịch mua không vượt qua kiểm tra của bạn thay vì để nó hết hạn. Vấn đề nằm ở một khóa có thể làm việc này cho mọi ứng dụng trong tài khoản của bạn trong khi nó chỉ cần một ứng dụng.
Một khóa bị rò rỉ có thể khiến bạn mất bao nhiêu tiền
Hãy tính toán trước khi quyết định việc này đáng bỏ bao nhiêu công sức. Trên Google Play, một khóa có Manage orders and subscriptions có thể hoàn tiền từng đơn hàng qua từng lệnh gọi, và mỗi lần hoàn tiền lại trả giá trị giao dịch về cho người mua. Một đoạn script thì không biết mệt. Mức trần là toàn bộ lịch sử đơn hàng của bạn trong 3 năm gần nhất.
Những chi phí không quay về cùng khoản hoàn tiền
Hoàn tiền đảo ngược giao dịch bán. Nó không đảo ngược những gì bạn đã chi để phục vụ giao dịch đó. Khoản chi ấy vẫn nằm trên sổ sách của bạn, dù việc hoàn tiền là lựa chọn của khách hàng hay của kẻ tấn công.
- Tài nguyên tính toán đã chạy: thời gian GPU và máy chủ đằng sau mỗi lần tạo nội dung, render hoặc phản hồi mô hình mà người mua đã nhận.
- Lệnh gọi API đã trả tiền: phí theo từng yêu cầu từ nhà cung cấp mô hình, bản đồ, giọng nói hoặc dữ liệu.
- Lưu trữ bạn vẫn tiếp tục trả: các tệp và lịch sử mà những tài khoản đó vẫn lưu trên máy chủ của bạn.
- Các khoản chi trả đã gửi: tiền trả cho nhà sáng tạo, đối tác liên kết hoặc người bán gắn với những giao dịch mua đó không quay về cùng khoản hoàn tiền.
Phía Apple có hình thù khác
App Store Server API của Apple không có endpoint nào để hoàn tiền. Apple là bên quyết định hoàn tiền. Nhưng cùng In-App Purchase key đó có thể gia hạn ngày gia hạn của một người đăng ký thêm tối đa 90 ngày, hai lần trong 365 ngày cho mỗi khách hàng, hoặc cho mọi người đăng ký đang hoạt động của một sản phẩm trong một yêu cầu hàng loạt. Apple cho biết khoản gia hạn không thể đảo ngược. Trong những ngày đó, người đăng ký không bị tính phí mà vẫn dùng ứng dụng của bạn, nên hóa đơn tính toán, lưu trữ và API của bạn vẫn chạy mà không có doanh thu bù lại.
| Khóa bị đánh cắp có thể làm gì | Tài khoản dịch vụ Google Play có Manage orders and subscriptions | Apple In-App Purchase key |
|---|---|---|
| Hoàn tiền một đơn hàng | Có, đơn hàng tối đa 3 năm tuổi | Không, chỉ Apple hoàn tiền |
| Chấm dứt quyền truy cập của người mua | Có, revoke khi hoàn tiền | Không |
| Hủy hoặc gia hạn gói đăng ký | Hủy, có | Gia hạn ngày gia hạn thêm tối đa 90 ngày, không thể đảo ngược |
| Đọc dữ liệu mua hàng | Có, với quyền xem | Có, lịch sử giao dịch và hoàn tiền |
| Trả lời yêu cầu xem xét hoàn tiền | Có, orders.reviewrefund | Có, Send Consumption Information |
| Giới hạn trong một ứng dụng | Có, qua quyền ứng dụng | Không, khóa dùng được trên mọi ứng dụng của nhóm bạn |
Cách giới hạn quyền của tài khoản dịch vụ Google Play
Play Console tách quyền tài khoản khỏi quyền ứng dụng. Quyền ứng dụng chỉ áp dụng cho những ứng dụng bạn chọn. Riêng thiết lập đó đã giúp bạn an toàn hơn bất cứ điều gì khác trong danh sách này.
Cấp quyền trên một ứng dụng, không phải toàn bộ tài khoản
Mời mỗi tài khoản dịch vụ với quyền ứng dụng chỉ trên những ứng dụng nó phục vụ. Công cụ hoàn tiền cho một trò chơi không cần quyền hoàn tiền trên ứng dụng thiền của bạn. Có một cái bẫy: View financial data, orders, and cancellation survey responses chỉ tồn tại ở cấp tài khoản, và quyền tương đương ở cấp ứng dụng có tên View financial data. Hãy chọn quyền cấp ứng dụng khi giới hạn phạm vi.
Tách việc đọc khỏi việc hoàn tiền
Không phải công việc nào cũng cần Manage orders and subscriptions. Phân tích dữ liệu chỉ đọc đơn hàng có thể chạy trên một tài khoản chỉ có quyền xem. Hãy giữ khóa có khả năng hoàn tiền trên đúng một dịch vụ thực sự gọi orders.refund, orders.reviewrefund hoặc các endpoint revoke.
Không bao giờ cấp Admin cho robot
Admin cấp mọi quyền, và Google liệt kê việc mời người dùng và quản lý quyền của họ trong số các quyền hạn của nó. Một khóa Admin bị rò rỉ có thể tự mở rộng quyền truy cập hoặc mời người mới. Không quy trình hoàn tiền nào cần đến nó.
Hỏi nhà cung cấp cách họ kết nối
Một số công cụ yêu cầu bạn tải lên khóa JSON. Số khác cung cấp email tài khoản dịch vụ của chính họ để bạn mời, nhờ vậy không khóa nào của bạn rời khỏi tầm kiểm soát và bạn có thể gỡ quyền truy cập của họ trong Users and permissions chỉ với một cú nhấp. Nếu nhà cung cấp cần quyền hoàn tiền, hãy hỏi: quyền nào, trên ứng dụng nào, và vì sao.

Cách lưu trữ, xoay vòng và thu hồi khóa
Cả hai cửa hàng nói cùng một điều bằng những lời khác nhau. Đừng đặt khóa trong kho mã và đừng đóng gói chúng vào ứng dụng. Khác biệt nằm ở những gì xảy ra sau khi có sự cố.
Khóa Google Cloud không tự hết hạn
Hướng dẫn của Google Cloud lưu ý rằng khóa tài khoản dịch vụ mặc định không có thời hạn. Hướng dẫn khuyến nghị xoay vòng khóa định kỳ và vô hiệu hóa những khóa không còn dùng. Nếu một khóa lọt vào kho mã, Google yêu cầu xóa nó trong IAM càng nhanh càng tốt, vì xóa nó khỏi kho mã là chưa đủ. Google Cloud cũng có thể tự động vô hiệu hóa các khóa bị rò rỉ mà nó phát hiện khi ràng buộc Service Account Key Exposure Response được đặt thành DISABLE_KEY, nhưng không đảm bảo sẽ bắt được mọi vụ rò rỉ.
Khóa Apple chỉ tải một lần và thu hồi là vĩnh viễn
Chỉ Account Holder hoặc Admin mới có thể tạo In-App Purchase key. Apple giữ phần công khai, bạn tải tệp .p8 riêng tư xuống một lần, và Apple không giữ bản sao. Nếu bạn nghi ngờ khóa đã bị xâm phạm, Apple yêu cầu thu hồi ngay trong App Store Connect tại Users and Access, Integrations, In-App Purchase. Khóa đã thu hồi không thể khôi phục, và việc thu hồi cũng khiến các ưu đãi khuyến mãi được ký bằng khóa đó không thể đổi được nữa, vì vậy hãy cập nhật các ưu đãi đó trước hoặc ngay sau khi thu hồi.
| Việc cần làm | Tài khoản dịch vụ Google Play | Apple In-App Purchase key |
|---|---|---|
| Ai có thể tạo | Tạo trong Google Cloud, rồi mời trong Users and permissions của Play Console | Account Holder hoặc Admin |
| Có tải lại bí mật được không | Bạn tạo một khóa mới | Không, chỉ tải một lần |
| Thời hạn mặc định | Không có | Không có, cho đến khi bạn thu hồi |
| Cách cắt quyền truy cập nhanh | Xóa khóa trong IAM, hoặc gỡ tài khoản trong Play Console | Thu hồi khóa trong App Store Connect |
| Tác dụng phụ khi cắt quyền truy cập | Mọi công cụ dùng tài khoản đó ngừng gọi API | Ưu đãi khuyến mãi được ký bằng khóa đó không đổi được nữa |
Danh sách kiểm tra ngắn
- Mỗi công việc một tài khoản dịch vụ, được mời với quyền ứng dụng chỉ trên những ứng dụng nó phục vụ.
- Manage orders and subscriptions chỉ trên tài khoản thực sự hoàn tiền, thu hồi hoặc trả lời yêu cầu xem xét.
- Không cấp Admin cho bất kỳ tài khoản robot nào.
- Khóa nằm trong trình quản lý bí mật, không bao giờ trong kho mã, nhật ký build hay ứng dụng di động.
- Một danh sách bằng văn bản về mọi khóa, ai tạo ra và dịch vụ nào dùng nó, để việc thu hồi không làm hỏng phản hồi hoàn tiền của bạn.
- Rà soát Users and permissions của Play Console và các khóa App Store Connect mỗi khi có người rời nhóm hoặc ngừng dùng một nhà cung cấp.
Câu hỏi thường gặp
- Tài khoản dịch vụ cần những quyền Play Console nào cho hoàn tiền và chargeback?
- Nó cần Manage orders and subscriptions để hoàn tiền đơn hàng, hủy gói đăng ký và xử lý đơn hàng, cộng thêm quyền xem đơn hàng. Hướng dẫn Play Developer API của Google liệt kê View financial data, orders, and cancellation survey responses và Manage orders and subscriptions là hai quyền mà Google Play Billing APIs yêu cầu.
- Tài khoản dịch vụ Google Play có thể hoàn tiền đơn hàng không?
- Có, nếu nó nắm quyền Manage orders and subscriptions. Trang trợ giúp của Google cho biết quyền đó cho phép người dùng xem đơn hàng, hoàn tiền đơn hàng và hủy gói đăng ký, và phương thức API orders.refund hoàn tiền bất kỳ đơn hàng nào có tuổi tối đa 3 năm.
- Người có App Store In-App Purchase key của tôi có thể hoàn tiền cho khách hàng của tôi không?
- Không. App Store Server API không có endpoint hoàn tiền, vì Apple là bên đưa ra quyết định hoàn tiền. Tuy vậy, một khóa bị đánh cắp vẫn có thể đọc lịch sử giao dịch và hoàn tiền, gửi thông tin tiêu dùng, và gia hạn ngày gia hạn gói đăng ký thêm tối đa 90 ngày, điều mà Apple cho biết không thể đảo ngược.
- Khóa tài khoản dịch vụ Google Play có hết hạn không?
- Mặc định thì không. Hướng dẫn của Google Cloud cho biết các khóa bạn tạo và tải xuống không có thời hạn trừ khi bạn cấu hình, và khuyến nghị xoay vòng khóa định kỳ cũng như vô hiệu hóa những khóa không còn dùng.
- Tôi nên làm gì nếu khóa JSON của tài khoản dịch vụ bị commit lên GitHub?
- Xóa khóa đó trong Google Cloud IAM ngay lập tức và tạo khóa mới. Google cho biết chỉ gỡ khóa khỏi kho mã là chưa đủ, vì bất kỳ ai đã sao chép nó vẫn có thể dùng cho đến khi chính khóa đó bị xóa.
Nguồn và tài liệu đọc thêm
- Play Console Help: Add developer account users and manage permissions
- Google Play Developer API: Getting started (service accounts and required permissions)
- Google Play Developer API: orders.refund reference
- Android Developers: Fight fraud and abuse
- Google Cloud: Best practices for managing service account keys
- Apple Developer: Creating API keys to authorize API requests
- App Store Connect Help: Generate keys for in-app purchases
- Apple Developer: Extending the renewal date for auto-renewable subscriptions
RefundHalt
Chế độ tự động xử lý hoàn tiền cho App Store và Google Play
Đọc tiếp
Brazil đang rà soát những game vẫn bán loot box cho trẻ em, và hoàn tiền loot box là nơi chi phí đổ về
Bộ Tư pháp Brazil đã đề nghị cơ quan bảo vệ dữ liệu giám sát sáu game bán loot box mà không kiểm tra độ tuổi. Bài viết này tóm tắt luật yêu cầu gì, Apple và Google vốn đã đòi hỏi gì, và cách định giá, xử lý hoàn tiền loot box khi hộp đã được mở.
Giao dịch mua trong ứng dụng ngoài ý muốn là những khoản hoàn tiền bạn không thể thắng, vì vậy cách khắc phục nằm ở màn hình mua hàng
Giao dịch mua trong ứng dụng ngoài ý muốn quay lại dưới dạng hoàn tiền trên cả hai cửa hàng, và không bằng chứng sử dụng nào chứng minh được một lần chạm là có chủ ý. Bài viết này giải thích cách Apple và Google gắn nhãn chúng, chi phí tính toán và chi trả mà mỗi trường hợp gây ra cho bạn, và thiết kế màn hình mua hàng giúp ngăn chúng trước khi khoản phí phát sinh.