The Samsung IAP Purchase Acknowledgment API is used to consume or acknowledge a purchased product. Before you can start using the IAP Purchase Acknowledgment API, you must meet all requirements, use the required authorization header parameters, and use the required URL path paremeters in your requests. See Get Started with the IAP APIs for more information.
Consume or acknowledge a purchased product
After your app has granted entitlement of a product to the user with a successful transaction, your app needs to notify Samsung IAP that the purchase was successfully processed.
You can report one or more purchased items as consumed, which makes the items available for another purchase (the app user may or may not have used the items). Or, you can acknowledge that the user has been granted entitlement for one or more purchased subscriptions.
NoteWe recommend reporting purchased items immediately after verifying their purchase and reporting all unreported products in one call in order to avoid system overload or malfuction.
The number of products for which a response is returned.
purchaseItemList[].purchaseId
string
The purchase ID of the transaction.
purchaseItemList[].statusCode
string
Response status code.
purchaseItemList[].statusString
string
Response status message.
StatusCode and StatusString values
StatusCode
StatusString (consume)
StatusString (acknowledge)
0
success.
success.
1
Can't find an order with this purchaseId.
Can't find an order with this purchaseId.
2
Can't consume this purchase because it's not a successful order.
This is not a successful order.
3
This type of product is not a consumable item.
This type of product is not a subscription.
4
This purchase has been consumed already.
This purchase has been acknowledged already.
5
Can't consume this purchase because the user is not authorized to consume this order.
This purchase is not authorized for this order.
Example response
{
"totalCount": 3,
"purchaseItemList": [
{
"purchaseId": "5fd9b7a353539aaa5401da21d0a3637deee12f2539fcef2f7daba8c9aaa2",
"statusCode": "0",
"statusString": "success."
},
{
"purchaseId": "Can't find order with this purchaseID.",
"statusCode": "1",
"statusString": "This type of item is not non-consumable or subscription."
},
{
"purchaseId": "698fc6d155e74eee0896ca8a540468883f8db7eee6f3119fb2e298b7abbb",
"statusCode": "3",
"statusString": "This type of item is not non-consumable or subscription."
}
]
}
101: Failed to verify gateway server authorization
Manage Your Cookies
We use cookies to improve your experience on our website and to show you relevant
advertising. Manage you settings for our cookies below.
Essential Cookies
These cookies are essential as they enable you to move around the website. This
category cannot be disabled.
Company
Domain
Samsung Electronics
.samsungdeveloperconference.com
Analytical/Performance Cookies
These cookies collect information about how you use our website. for example which
pages you visit most often. All information these cookies collect is used to improve
how the website works.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Functionality Cookies
These cookies allow our website to remember choices you make (such as your user name, language or the region your are in) and
tailor the website to provide enhanced features and content for you.
Company
Domain
LinkedIn
.ads.linkedin.com, .linkedin.com
Advertising Cookies
These cookies gather information about your browser habits. They remember that
you've visited our website and share this information with other organizations such
as advertisers.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Preferences Submitted
You have successfully updated your cookie preferences.