Transfer Apple SK2 purchase

Use this endpoint to transfer an existing active purchase from one user to another. This allows re-assigning access to a subscription or in-app purchase.

The transfer process is asynchronous. Upon successful registration, the API will return a 202 Accepted status with a unique synchronizationId in the response body.

Note: Only active purchases can be transferred.

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 JWT or X-Publisher-Token header authorization.

Please use JWT (Bearer) token to try out the endpoint in the API console in this documentation.

Body Params
int32
required

Cleeng's unique identifier for the customer who will become the new owner of the purchase after the transfer.

string
required

Apple's unique transaction identifier for the purchase to be transferred. This ID is used to identify the purchase in Cleeng's system.

string

IP address of the customer who requested the transfer. This information will be stored in the user's profile as the IP address of their latest activity. Accepted: IPv4

The parameter is required in backend intergrations (with middleware) to ensure the correct customer IP address (address of their latest activity) is stored.

Headers
string

Can be used within both server-to-server and client integrations. Either a JWT or X-Publisher-Token header authorization is required, depending on how you integrate with Cleeng.
Please use JWT (Bearer) token to try out the endpoint in the API console in this documentation.

string

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.

string

Correlation ID for the request, which is used to link the initial purchase registration or transfer request with the subsequent synchronization process. This ID is not used as the synchronizationId but is included in the response for tracking and correlation purposes.

It is recommended to provide a Correlation-Id for easier tracking of requests, especially if you need to correlate the purchase registration with other events or processes in your system. Ensure that the Correlation-Id is unique within the context of your specific client integration to avoid conflicts.

int32
required

Unique identifier for the publisher integrating with the API.
This header is crucial for tracking the source of requests and identifying which publisher's application is making the API call. It helps in isolating issues, monitoring usage patterns, and providing targeted support to specific publishers.

string

Version of the publisher's application making the API request.
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.

string

Unique identifier for the device making the request (if applicable).
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.

string

Specifies the type of device the request is coming from.
This header provides additional context about the device making the request, beyond just its unique ID. It helps you categorize devices (e.g., "iPhone 13", "Samsung Galaxy S21", "Web Browser") and identify potential issues or trends related to specific device types.

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: Apple TV

string

Specifies the action performed by the user in the publisher's application.
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.

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.

Responses

Language
Credentials
Header
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json