REST Resource: purchases.voidedpurchases
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: VoidedPurchase
Tài nguyên VoidedPurchase cho biết một giao dịch mua đã bị huỷ/hoàn tiền/hoàn tiền.
Biểu diễn dưới dạng JSON |
{
"kind": string,
"purchaseToken": string,
"purchaseTimeMillis": string,
"voidedTimeMillis": string,
"orderId": string,
"voidedSource": integer,
"voidedReason": integer,
"voidedQuantity": integer
} |
Trường |
kind |
string
Loại này đại diện cho một đối tượng mua hàng vô hiệu trong dịch vụ androidpublisher.
|
purchaseToken |
string
Mã thông báo xác định duy nhất một giao dịch mua hàng một lần hoặc gói thuê bao. Để xác định riêng từng trường hợp gia hạn gói thuê bao, hãy sử dụng orderId (mã đơn hàng bắt đầu từ phiên bản 3 của API).
|
purchaseTimeMillis |
string (int64 format)
Thời gian thực hiện giao dịch mua, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống (ngày 1 tháng 1 năm 1970).
|
voidedTimeMillis |
string (int64 format)
Thời điểm giao dịch mua bị huỷ/hoàn tiền/hoàn tiền, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống (ngày 1 tháng 1 năm 1970).
|
orderId |
string
Mã đơn hàng xác định duy nhất một giao dịch mua hàng một lần, giao dịch mua gói thuê bao hoặc gia hạn gói thuê bao.
|
voidedSource |
integer
Phương thức khởi tạo giao dịch mua vô hiệu, các giá trị có thể có là: 0. Người dùng 1. Nhà phát triển 2. Google
|
voidedReason |
integer
Lý do giao dịch mua bị vô hiệu, các giá trị có thể có là: 0. Khác 1. Sự hối tiếc 2. Chưa nhận được 3. Bị lỗi 4. Vô tình_purchase 5. Gian lận 6. Lừa đảo thân thiện 7. Hoàn tiền 8. Unacknowledged_purchase
|
voidedQuantity |
integer
Số lượng vô hiệu do hoàn tiền một phần theo số lượng. Bạn chỉ có thể trả lại các giao dịch mua vô hiệu đối với khoản hoàn tiền một phần dựa trên số lượng khi includeQuantityBasedBasedHoàn lại được đặt thành true.
|
Phương thức |
|
Liệt kê các giao dịch mua đã bị huỷ, hoàn tiền hoặc hoàn tiền. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003e\u003ccode\u003eVoidedPurchase\u003c/code\u003e resource represents canceled, refunded, or charged-back purchases in Google Play.\u003c/p\u003e\n"],["\u003cp\u003eIncludes details like purchase time, voided time, reason, and initiator (user, developer, or Google).\u003c/p\u003e\n"],["\u003cp\u003eAccessible via the \u003ccode\u003epurchases.voidedpurchases.list\u003c/code\u003e method to retrieve a list of voided purchases.\u003c/p\u003e\n"],["\u003cp\u003eIdentifies purchases uniquely using \u003ccode\u003epurchaseToken\u003c/code\u003e (for older purchases) or \u003ccode\u003eorderId\u003c/code\u003e (for newer and subscription purchases).\u003c/p\u003e\n"],["\u003cp\u003eProvides \u003ccode\u003evoidedSource\u003c/code\u003e and \u003ccode\u003evoidedReason\u003c/code\u003e fields for understanding the context of the void action.\u003c/p\u003e\n"]]],["The document defines a `VoidedPurchase` resource, representing a canceled, refunded, or charged-back purchase. Key information includes the `purchaseToken`, `purchaseTimeMillis`, `voidedTimeMillis`, and `orderId`. It also specifies the `voidedSource` (user, developer, or Google) and `voidedReason`. `voidedQuantity` indicates the quantity in the case of a partial refund. The method `list` is provided to retrieve lists of these voided purchases. The data is represented in JSON format.\n"],null,["# REST Resource: purchases.voidedpurchases\n\n- [Resource: VoidedPurchase](#VoidedPurchase)\n - [JSON representation](#VoidedPurchase.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: VoidedPurchase\n------------------------\n\nA VoidedPurchase resource indicates a purchase that was either canceled/refunded/charged-back.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"purchaseToken\": string, \"purchaseTimeMillis\": string, \"voidedTimeMillis\": string, \"orderId\": string, \"voidedSource\": integer, \"voidedReason\": integer, \"voidedQuantity\": integer } ``` |\n\n| Fields ||\n|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` This kind represents a voided purchase object in the androidpublisher service. |\n| `purchaseToken` | `string` The token which uniquely identifies a one-time purchase or subscription. To uniquely identify subscription renewals use orderId (available starting from version 3 of the API). |\n| `purchaseTimeMillis` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The time at which the purchase was made, in milliseconds since the epoch (Jan 1, 1970). |\n| `voidedTimeMillis` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The time at which the purchase was canceled/refunded/charged-back, in milliseconds since the epoch (Jan 1, 1970). |\n| `orderId` | `string` The order id which uniquely identifies a one-time purchase, subscription purchase, or subscription renewal. |\n| `voidedSource` | `integer` The initiator of voided purchase, possible values are: 0. User 1. Developer 2. Google |\n| `voidedReason` | `integer` The reason why the purchase was voided, possible values are: 0. Other 1. Remorse 2. Not_received 3. Defective 4. Accidental_purchase 5. Fraud 6. Friendly_fraud 7. Chargeback 8. Unacknowledged_purchase |\n| `voidedQuantity` | `integer` The voided quantity as the result of a quantity-based partial refund. Voided purchases of quantity-based partial refunds may only be returned when includeQuantityBasedPartialRefund is set to true. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------------|-------------------------------------------------------------------|\n| ### [list](/android-publisher/api-ref/rest/v3/purchases.voidedpurchases/list) | Lists the purchases that were canceled, refunded or charged-back. |"]]