Method: purchases.products.acknowledge
Stay organized with collections
Save and categorize content based on your preferences.
Acknowledges a purchase of an inapp item.
HTTP request
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}:acknowledge
The URL uses gRPC Transcoding
syntax.
Path parameters
| Parameters |
packageName
|
string
The package name of the application the inapp product was sold in (for example, 'com.some.thing').
|
productId
|
string
The inapp product SKU (for example, 'com.some.thing.inapp1').
|
token
|
string
The token provided to the user's device when the inapp product was purchased.
|
Request body
The request body contains data with the following structure:
| Fields |
developerPayload
|
string
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.app/purchases/products/com.example.app.inapp1/tokens/exampletoken:acknowledge' \
-
H
'Accep
t
:
applica
t
io
n
/jso
n
'
\
-
H
'Au
t
horiza
t
io
n
:
Bearer
[
YOUR_ACCESS_TOKEN
]
'
\
-
H
'Co
ntent
-
Type
:
applica
t
io
n
/jso
n
'
-
d
'
{
"developerPayload"
:
"payload_for_the_purchase"
}
'
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/androidpublisher
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-06-02 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-02 UTC."],[[["\u003cp\u003eAcknowledges a purchase of an in-app product using the provided product and package information.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003epackageName\u003c/code\u003e, \u003ccode\u003eproductId\u003c/code\u003e, and purchase \u003ccode\u003etoken\u003c/code\u003e as path parameters for identification.\u003c/p\u003e\n"],["\u003cp\u003eOptionally accepts a \u003ccode\u003edeveloperPayload\u003c/code\u003e in the request body for attaching additional data.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e authorization scope.\u003c/p\u003e\n"],["\u003cp\u003eA successful acknowledgement results in an empty response body, confirming the action.\u003c/p\u003e\n"]]],["This document details the process of acknowledging an in-app purchase. It uses a `POST` request to the specified URL, including the `packageName`, `productId`, and `token` as path parameters. The request body requires a JSON structure with a `developerPayload` string. Successful acknowledgement results in an empty response body. This process requires `https://www.googleapis.com/auth/androidpublisher` OAuth scope for authorization. The process includes a try it out functionality.\n"],null,["# Method: purchases.products.acknowledge\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nAcknowledges a purchase of an inapp item.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}:acknowledge`\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 the inapp product was sold in (for example, 'com.some.thing'). |\n| `productId` | `string` The inapp product SKU (for example, 'com.some.thing.inapp1'). |\n| `token` | `string` The token provided to the user's device when the inapp product was purchased. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------|\n| ``` { \"developerPayload\": string } ``` |\n\n| Fields ||\n|--------------------|---------------------------------------------|\n| `developerPayload` | `string` Payload to attach to the purchase. |\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 \\\n -X POST \\\n 'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/products/com.example.app.inapp1/tokens/exampletoken:acknowledge' \\\n -H 'Accept: application/json' \\\n -H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \\\n -H 'Content-Type: application/json'\n -d '{\n \"developerPayload\": \"payload_for_the_purchase\"\n }'\n```\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
