REST Resource: purchases.voidedpurchases
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: VoidedPurchase
VoidedPurchase kaynağı, iptal edilen/geri ödemesi yapılan/geri ödemesi yapılan bir satın alma işlemini belirtir.
| JSON gösterimi |
{
"kind": string,
"purchaseToken": string,
"purchaseTimeMillis": string,
"voidedTimeMillis": string,
"orderId": string,
"voidedSource": integer,
"voidedReason": integer,
"voidedQuantity": integer
} |
| Alanlar |
kind |
string
Bu tür, androidpublisher hizmetindeki geçersiz bir satın alma nesnesini temsil eder.
|
purchaseToken |
string
Tek seferlik satın alma işlemini veya aboneliği benzersiz şekilde tanımlayan jeton. Abonelik yenilemelerini benzersiz bir şekilde tanımlamak için orderId'yi (API'nin 3. sürümünden itibaren) kullanın.
|
purchaseTimeMillis |
string (int64 format)
Dönemden (1 Ocak 1970) itibaren milisaniye cinsinden satın alma işleminin yapıldığı zaman.
|
voidedTimeMillis |
string (int64 format)
Dönemden (1 Ocak 1970) itibaren milisaniye cinsinden satın alma işleminin iptal edildiği/geri ödemenin/geri ödemenin yapıldığı zaman.
|
orderId |
string
Tek seferlik satın alma işlemini, abonelik satın alma işlemini veya abonelik yenilemeyi benzersiz şekilde tanımlayan sipariş kimliği.
|
voidedSource |
integer
Geçersiz satın alma işlemini başlatan taraf. Olası değerler: 0. 1. Kullanıcı Geliştirici 2. Google
|
voidedReason |
integer
Satın alma işleminin geçersiz olmasının nedeni (olası değerler: 0). Diğer 1. Pişmanlık 2. Not_received 3. Kusurlu 4. Yanlışlıkla_satın_alma 5. Sahtekarlık 6. Dostça_dolandırıcılık 7. Ters ibraz 8. Unacknowledged_purchase
|
voidedQuantity |
integer
Miktara dayalı kısmi geri ödeme sonucunda geçersiz kılınan miktar. Miktara dayalı kısmi geri ödemelerde geçersiz satın alma işlemleri, yalnızca includequantitybasedKısmi geri ödeme doğru olarak ayarlandığında iade edilebilir.
|
Yöntemler |
|
|
İptal edilen, geri ödemesi yapılan veya ters ibraz uygulanan satın alma işlemlerini listeler. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]
