针对现有外部交易办理退款或部分退款。
HTTP 请求
POST https://androidpublisher.googleapis.com/androidpublisher/v3/{name=applications/*/externalTransactions/*}:refund
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
name |
必需。待退款的外部交易的名称。格式:application/{packageName}/externalTransaction/{externalTransaction} |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "refundTime": string, // Union field |
字段 | |
---|---|
refundTime |
必需。交易退款的时间。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
联合字段 refund_type 。必需。外部交易退款的类型。refund_type 只能是下列其中一项: |
|
partialRefund |
部分退款。 |
fullRefund |
全额退款。 |
响应正文
如果成功,则响应正文包含一个 ExternalTransaction
实例。
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/androidpublisher
PartialRefund
交易的部分退款。
JSON 表示法 |
---|
{
"refundId": string,
"refundPreTaxAmount": {
object ( |
字段 | |
---|---|
refundId |
必需。用于区分此部分退款的唯一 ID。如果退款成功,对同一 ID 的后续退款将会失败。在单笔交易的退款中必须唯一。 |
refundPreTaxAmount |
必需。部分退款的税前金额。应少于交易的剩余税前金额。 |
FullRefund
此类型没有任何字段。
交易剩余金额的全额退款。