Method: orders.refund
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
退還使用者的訂閱項目或應用程式內購訂單。超過 3 年的訂單無法退款。
HTTP 要求
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders/{orderId}:refund
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
packageName |
string
購買此訂閱項目或應用程式內商品的應用程式套件名稱 (例如「com.some.thing」)。
|
orderId |
string
購買訂閱項目或應用程式內訂單時，向使用者提供的訂單 ID。
|
查詢參數
| 參數 |
revoke |
boolean
是否要撤銷已購買的項目。如果設為 true，系統會立即終止訂閱或應用程式內商品的存取權。如果是定期訂閱項目，日後的所有付款也會終止。應用程式內已消耗的項目必須由開發人員的應用程式處理 (選用)。
|
範例
以下是要求範例：
curl \
-X POST \
'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/orders/1234567890:refund?revoke=true' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]'
授權範圍
需要下列 OAuth 範圍：
https://www.googleapis.com/auth/androidpublisher
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-07-26 (世界標準時間)。"],[[["This operation refunds a user's subscription or in-app purchase order, provided the order is less than 3 years old."],["It uses an HTTP POST request to the specified URL with path parameters for package name and order ID."],["An optional query parameter \"revoke\" can be included to immediately terminate access to the purchased item."],["The request body should be empty, and a successful response will also be empty."],["Authorization requires the `https://www.googleapis.com/auth/androidpublisher` OAuth scope."]]],["This document details how to refund a user's subscription or in-app purchase via a `POST` HTTP request. The request URL requires the application's `packageName` and the `orderId` as path parameters. An optional `revoke` query parameter determines if the purchased item should be immediately revoked. The request body must be empty, and a successful response also returns an empty body. Orders over 3 years old are ineligible for refunds. This action requires the `https://www.googleapis.com/auth/androidpublisher` authorization scope.\n"]]
