Method: externaltransactions.refundexternaltransaction

為現有外部交易辦理退款或部分退款。

HTTP 要求

POST https://androidpublisher.googleapis.com/androidpublisher/v3/{name=applications/*/externalTransactions/*}:refund

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必要欄位。要退款的外部交易名稱。格式：application/{packageName}/externalTransactions/{externalTransaction}

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "refundTime": string,

  // Union field refund_type can be only one of the following:
  "partialRefund": {
    object (PartialRefund)
  },
  "fullRefund": {
    object (FullRefund)
  }
  // End of list of possible types for union field refund_type.
}
欄位
refundTime

string (Timestamp format)

必要欄位。交易退款的時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
聯集欄位 refund_type。必要欄位。外部交易退款類型。refund_type 只能是下列其中一項：
partialRefund

object (PartialRefund)

部分退款。
fullRefund

object (FullRefund)

全額退款。

回應主體

如果成功，回應主體會包含 ExternalTransaction 的執行例項。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/androidpublisher

PartialRefund

交易的部分退款。

JSON 表示法 
{
  "refundId": string,
  "refundPreTaxAmount": {
    object (Price)
  }
}
欄位
refundId

string

必要欄位。用於區分部分退款的專屬 ID。如果退款成功，後續使用相同 ID 的退款就會失敗。單筆交易的退款不得重複。
refundPreTaxAmount

object (Price)

必要欄位。部分退款的稅前金額。應少於交易的剩餘稅前金額。

FullRefund

這個類型沒有任何欄位。

交易剩餘金額的全額退款。