Method: purchases.subscriptions.revoke

  • This method is deprecated; use purchases.subscriptionsv2.revoke instead.

  • The method refunds and immediately revokes a user's subscription purchase, terminating access and stopping recurrence.

  • The HTTP request uses a POST method to a specific URL including package name, subscription ID, and token.

  • The request body should be empty.

  • A successful response body is empty and requires the https://www.googleapis.com/auth/androidpublisher OAuth scope for authorization.

Deprecated: Use purchases.subscriptionsv2.revoke instead. Refunds and immediately revokes a user's subscription purchase. Access to the subscription will be terminated immediately and it will stop recurring.

HTTP request

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

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 \
  -H 'Accept: application/json' \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/subscriptions/monthly.subscription.sku/tokens/jklmnop.123456789:revoke'

Authorization scopes

Requires the following OAuth scope:

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