AI-generated Key Takeaways
-
This page details how to acknowledge a subscription purchase using an HTTP POST request.
-
The request requires path parameters including the package name, subscription ID (optional since May 21, 2025), and the purchase token.
-
The request body can optionally include a
developerPayloadfield as a string. -
A successful response body is empty.
-
The API call requires the
https://www.googleapis.com/auth/androidpublisherauthorization scope.
Acknowledges a subscription purchase.
HTTP request
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:acknowledge
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
packageName
|
The package name of the application for which this subscription was purchased (for example, 'com.some.thing'). |
subscriptionId
|
Note: Since May 21, 2025, subscriptionId is not required, and not recommended for subscription with add-ons. The purchased subscription ID (for example, 'monthly001'). |
token
|
The token provided to the user's device when the subscription was purchased. |
Request body
The request body contains data with the following structure:
| JSON representation |
|---|
{ "developerPayload" : string } |
| Fields | |
|---|---|
developerPayload
|
Payload to attach to the purchase. |
Response body
If successful, the response body is empty.
Sample
The following is a sample request:
curl - X POST \ 'h tt ps : //androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly_premium_001/tokens/abcDEF123ghiJKL456mnoPQR789:acknowledge' \ - H 'Accep t : applica t io n /jso n ' \ - H 'Co ntent - Type : applica t io n /jso n ' \ - d ' { "developerPayload" : "AppSpecificInfo-UserID-12345" } '
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/androidpublisher
