Recommendations
The Samsung In-App Purchase (IAP) APIs provide the following functionality:
To start using the IAP APIs, you must meet certain requirements and use the required authorization header parameters described below.
In order to use the IAP APIs, the following is required:
The IAP APIs are part of the Galaxy Store Developer API. You must meet all of the requirements of the Galaxy Store Developer API including, but not limited to, creating the access token, including the access token in the authorization header of every IAP API call, and having commercial seller status to manage in-app purchase items.
The IAP APIs must be connected with the content in the In App Purchase tab area of Seller Portal. To create this connection, you must either initially distribute your content using the Content Publish API or the content must be in the For Sale state in Seller Portal. If this connection does not exist, matching product information cannot be retrieved.
You must integrate the IAP SDK into your app. All binaries registered in your content must support IAP.
If these requirements are not met, error code 106 is returned.
Every request must include authorization header parameters which specify the content type, your access token, and service account ID. See Create an Access Token for more information about how to create an access token and service account ID.
| Attribute | Description |
|---|---|
| Authorization | Required .Use Bearer <your-access-token> where <your-access-token> is the access token you requested from the Galaxy Store authentication server
|
| service-account-id | Required. The service account ID used to create the JWT associated with the access token (can be found in the Assistance > API Service area of Seller Portal) |
| content-type | Required. Must be application/json
|
The following example shows the header used with the IAP APIs:
curl -X <IAP_PUBLISH-or-IAP_ORDER-or-IAP_SUBSCRIPTION_API_REQUEST> \
-H "content-type: application/json" \
-H "Authorization: Bearer <your-access-token>" \
-H "service-account-id: <your-service-account-id>"
The URL path for every IAP Publish and Subscription API request must contain the package name (for the IAP Orders API, the package name may be required in the body parameter). For the IAP Subscription API, the in-app item purchase transaction identifier is also required.
| Attribute | Description |
|---|---|
| packageName | Required for IAP Order and Subscription APIs. The app's package name |
| purchaseId | Required for IAP Subscription API. Unique identifier of the in-app item purchase transaction |
The following example shows the URL path for creating an item using the IAP Publish API:
https://devapi.samsungapps.com/iap/v6/applications/<packageName>/items
The following example shows the URL path for canceling, refunding, or revoking a subscription using the IAP Subscription API:
https://devapi.samsungapps.com/iap/seller/v6/applications/<packageName>/items/purchases/subscriptions/<purchaseId>