Method: externaltransactions.refundexternaltransaction

针对现有外部交易办理退款或部分退款。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。待退款的外部交易的名称。格式：application/{packageName}/externalTransaction/{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 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："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

此类型没有任何字段。

交易剩余金额的全额退款。