Method: purchases.subscriptions.refund
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Eingestellt. Verwenden Sie stattdessen „orders.refund“. Der Abokauf eines Nutzers wird erstattet, das Abo bleibt jedoch bis zum Ablaufdatum gültig und wird fortgesetzt.
HTTP-Anfrage
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:refund
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
packageName |
string
Der Paketname der Anwendung, für die dieses Abo gekauft wurde (z. B. „com.beispiel.app“).
|
subscriptionId |
string
„Die ID des gekauften Abos (z. B. ‚monthly001‘).
|
token |
string
Das Token, das beim Kauf des Abos auf dem Gerät des Nutzers bereitgestellt wurde.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.
Beispiel
Hier ein Beispiel für eine Anfrage:
curl -X POST \
'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly.premium.plan/tokens/abcdefghijklmnopqrstuvwxyz1234567890:refund' \
-H 'Accept: application/json'
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/androidpublisher
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003eRefunds a user's subscription purchase, keeping the subscription active until its expiration and allowing it to continue recurring.\u003c/p\u003e\n"],["\u003cp\u003eThe request is made using a \u003ccode\u003ePOST\u003c/code\u003e request to a specific URL with path parameters for package name, subscription ID, and purchase token.\u003c/p\u003e\n"],["\u003cp\u003eAn empty request body is required, and a successful response will also be empty.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e OAuth scope is necessary for authorization.\u003c/p\u003e\n"]]],["This document details how to refund a user's subscription purchase via a `POST` HTTP request to a specific URL. The URL requires three path parameters: `packageName`, `subscriptionId`, and `token`. The request body must be empty. A successful request results in an empty response body. The user's subscription remains valid until it naturally expires. This process requires authorization via the `https://www.googleapis.com/auth/androidpublisher` OAuth scope.\n"],null,["# Method: purchases.subscriptions.refund\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\n| This item is deprecated!\nDeprecated: Use orders.refund instead. Refunds a user's subscription purchase, but the subscription remains valid until its expiration time and it will continue to recur.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:refund`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------------|-------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` The package name of the application for which this subscription was purchased (for example, 'com.some.thing'). |\n| `subscriptionId` | `string` \"The purchased subscription ID (for example, 'monthly001'). |\n| `token` | `string` The token provided to the user's device when the subscription was purchased. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Sample\n\nThe following is a sample request: \n\n```json\ncurl -X POST \\\n 'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly.premium.plan/tokens/abcdefghijklmnopqrstuvwxyz1234567890:refund' \\\n -H 'Accept: application/json'\n```\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
