退回現有外部交易的退款或部分退款。
HTTP 要求
POST https://androidpublisher.googleapis.com/androidpublisher/v3/{name=applications/*/externalTransactions/*}:refund
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
name |
必要欄位。要退款的外部交易名稱。格式:apps/{packageName}/externalTransactions/{externalTransaction} |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "refundTime": string, // Union field |
欄位 | |
---|---|
refundTime |
必要欄位。交易退款的時間。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
聯集欄位 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
這個類型沒有任何欄位。
全額退款。