v1
latestOpenAPI 3.1.02026-07-241080412.6 KBCheck Google Play purchase synchronization status
Use this endpoint to retrieve the status and result of a purchase synchronization or transfer process initiated by the /purchases or /purchases/transfers endpoint. This endpoint provides a concise response with the essential status information, including status, accessGranted, offerId, and result. <br><br> For real-time updates on the synchronization status, you can also subscribe to the inappPurchaseSyncResult webhook, which provides a more detailed payload (WebhookSynchronizationStatus) with additional information about the transaction. <br><br> The status field indicates the current stage of the synchronization process: <br> - processing: The synchronization is in progress. <br> - retrying: The synchronization encountered an error and is being retried. This status may appear multiple times. <br> - finalized: The synchronization process has completed. <br><br> The result field provides more detailed information about the outcome of the synchronization and is only available when status is finalized. The accessGranted field indicates whether the user is entitled to the offer. The offerId field provides the ID of the offer. You can see some possible scenarios and the corresponding response fields in the polling section of the integration tutorial. <br><br>Please note that this endpoint can be authorized with a publisher (X-Publisher-Token) or JWT (Bearer) token. Depending on how you integrate with Cleeng (directly or through middleware), use either a <glossary:JWT> or X-Publisher-Token header authorization. <br> <br> <span style="color:green">Please use JWT (Bearer) token to try out the endpoint in the API console in this documentation.</span>
Path parameters
Unique identifier for the synchronization process. This ID is included in the response to the /purchases and /purchases/transfers endpoints. It can be used to track the status of the asynchronous purchase synchronization or transfer process using the /purchases/synchronizations/{synchronizationId} endpoint. The synchronizationId will be the same as the Correlation-Id provided in the request header, if one is supplied. If no Correlation-Id is provided, a unique synchronizationId will be generated automatically. Format: uuid.
Headers
Can be used within both server-to-server and client integrations. Either a <glossary:JWT> or X-Publisher-Token header authorization is required, depending on how you integrate with Cleeng. <br> <span style="color:green">Please use JWT (Bearer) token to try out the endpoint in the API console in this documentation.</span>
Can be used only within server-to-server integrations. Either a JWT or X-Publisher-Token header authorization is required, depending on how you integrate with Cleeng.
Version of the publisher's application making the API request. <br> This header helps you track which versions of the publisher's app are being used and how they interact with Cleeng API. It can be valuable in identifying compatibility issues, understanding the impact of app updates on API usage, and providing support for different app versions.
Unique identifier for the device making the request (if applicable). <br> This header is useful for tracking requests at the device level, especially in mobile app integrations. It can help you identify issues related to specific devices, analyze user behavior across devices, and gather insights into device-specific usage patterns.
Specifies the type of device the request is coming from. <br> This header provides additional context about the device making the request, beyond just its unique ID. It helps you categorize devices (e.g., "Pixel 8", "Samsung Galaxy S24", "Android TV") and identify potential issues or trends related to specific device types. <br><br> This information can be particularly useful for debugging, as it allows you to narrow down issues that may be specific to certain device models or types. It also helps in understanding user behavior and preferences across different device categories. Example: Android TV
Specifies the action performed by the user in the publisher's application. <br> This header provides additional context about the user's actions within the app, such as "Purchase", "Restore Purchase", "Updating Plan", "Content Access", etc. It helps you understand user behavior, track specific actions that trigger API requests, and analyze usage patterns based on user actions. <br><br> By capturing user actions in the app, you can gain insights into user engagement, preferences, and interactions with your API. This information can be valuable for optimizing the user experience, tailoring content recommendations, and improving app performance.
Response
200
Example response
{
"status": "processing",
"accessGranted": true,
"offerId": "string",
"correlationId": "string",
"result": "RECEIVED_EXPIRED_PURCHASE"
}