Method: purchases.subscriptions.refund

AI-generated Key Takeaways

• Refunds a user's subscription purchase, keeping the subscription active until its expiration and allowing it to continue recurring.

• The request is made using a POST request to a specific URL with path parameters for package name, subscription ID, and purchase token.

• An empty request body is required, and a successful response will also be empty.

• https://www.googleapis.com/auth/androidpublisher OAuth scope is necessary for authorization.

• HTTP request
• Path parameters
• Request body
• Response body
• Authorization scopes
• Try it!

This item is deprecated!

Deprecated: 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.

HTTP request

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:refund

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
packageName	string The package name of the application for which this subscription was purchased (for example, 'com.some.thing').
subscriptionId	string "The purchased subscription ID (for example, 'monthly001').
token	string The token provided to the user's device when the subscription was purchased.

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

Sample

The following is a sample request:

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'

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/androidpublisher