REST Resource: purchases.voidedpurchases

資源:VoidedPurchase

VoidedPurchase 資源表示已取消/退款/退單的購買交易。

JSON 表示法
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
欄位
kind

string

這類代表 androidpublisher 服務中已取消的購買交易物件。

purchaseToken

string

專門用來識別一次性購買交易或訂閱項目的權杖。如要識別不重複的續訂交易,請使用 orderId (適用於 API 第 3 版以上)。

purchaseTimeMillis

string (int64 format)

購買時間,以自 Epoch 紀元時間 (1970 年 1 月 1 日) 起的毫秒為單位。

voidedTimeMillis

string (int64 format)

取消/退款/退費的購買交易時間,以自 Epoch 紀元時間 (1970 年 1 月 1 日) 起的毫秒為單位。

orderId

string

訂單 ID,用於專門識別一次性購買、訂閱購買或訂閱續訂。

voidedSource

integer

作廢交易的發起者,可能的值為:0。使用者 1。開發人員 2。Google

voidedReason

integer

交易作廢的原因,可能的值包括:0. 其他 1. Remorse 2. Not_received 3. 有瑕疵 4. Accidental_purchase 5. 詐欺 6. Friendly_fraud 7. 交易退單 8. Unacknowledged_purchase

voidedQuantity

integer

依數量提供部分退款後,取消的數量。只有在 includeQuantityBasedPartialRefund 設為 true 時,依數量提供部分退款的交易才能退回。

方法

list

列出已取消、退款或退單的購買交易。

錯誤代碼

這項資源的作業會傳回下列 HTTP 錯誤碼:

錯誤代碼 原因 解析度
5xx Google Play 伺服器發生一般錯誤。 重試要求。

如果問題持續發生,請與 Google Play 帳戶管理員聯絡,或提交支援要求。 建議查看 Play 狀態資訊主頁,瞭解是否有已知服務中斷情形。

409 並行更新錯誤。

嘗試更新正在更新的物件。舉例來說,購買交易同時透過呼叫 Play 帳款服務程式庫的 acknowledgePurchase() 方法和 Play Developer API 的 purchases.products.acknowledge 進行確認。

重試要求。