The Samsung IAP Publish API is used to view, register, modify, and remove Samsung In-App Purchase (IAP) items. Before you can start using the IAP Publish API, you must meet all requirements and use the required authorization header parameters in your requests. See Get Started with the IAP APIs for more information.
NoteUsing the IAP Publish API to register, modify, or delete an item immediately changes it within the content, even when the content is in the For Sale state.
The following is a quick reference to the IAP Publish APIs:
Unique identifier of the in-app item registered in Seller Portal.
title
string
Title of the in-app item registered in Seller Portal.
description
string
Brief explanation of the in-app item registered in Seller Portal.
type
string
In-App item type.
CONSUMABLE: An item that can be purchased one or more times and remains effective or available in the app until it is used one time (for example, coins, special powers, or gems).
NON_CONSUMABLE: An item that is purchased only once and remains effective or available in the app at all times, even after deletion and re‑installation of the app (for example, game boards or an upgrade).
UNSPECIFIED: An unknown item type.
status
string
Item distribution status in Seller Portal.
PUBLISHED: Item is for sale in Galaxy Store.
UNPUBLISHED: Item is not available in Galaxy Store.
REMOVED: Item has been removed from Galaxy Store.
UNSPECIFIED: Item status is not known.
itemPaymentMethod.phoneBillStatus
Boolean
Whether or not the item is paid with an automatic payment on a phone bill.
true: The item is paid by an automatic payment on a phone bill.
false: The item is not paid by an automatic payment on a phone bill.
usdPrice
number
The base price in USD (United States of America dollars) of the item. The price can be set between 0 and 400.
prices[].countryId
string
Three-character country code (ISO 3166) of the country where the item is sold.
prices[].currency
string
Three-character currency code (ISO 4217) of the specified country's currency (for example, EUR, GBP, USD).
prices[].localPrice
string
Price of the item in the specified country's currency.
Required. Unique identifier of the in-app item registered in Seller Portal.
title
string
Required. Title of the in-app item registered in Seller Portal.
description
string
Required. Brief explanation of the in-app item registered in Seller Portal.
type
string
Required. In-App item type.
CONSUMABLE: An item that can be purchased one or more times and remains effective or available in the app until it is used one time (for example, coins, special powers, or gems).
NON_CONSUMABLE: An item that is purchased only once and remains effective or available in the app at all times, even after deletion and re‑installation of the app (for example, game boards or an upgrade).
UNSPECIFIED: An unknown item type.
status
string
Required. Item distribution status in Seller Portal.
PUBLISHED: Item is for sale in Galaxy Store.
UNPUBLISHED: Item is not available in Galaxy Store.
REMOVED: Item has been removed from Galaxy Store.
UNSPECIFIED: Item status is not known.
itemPaymentMethod.phoneBillStatus
Boolean
Required. Whether or not the item is paid with an automatic payment on a phone bill.
true: The item is paid by an automatic payment on a phone bill.
false: The item is not paid by an automatic payment on a phone bill.
usdPrice
number
Required. The base price in USD (United States of America dollars) of the item. The price can be set between 0 and 400.
prices[].countryId
string
Required. Three-character country code (ISO 3166) of the country where the item is sold.
prices[].currency
string
Three-character currency code (ISO 4217) of the specified country's currency (for example, EUR, GBP, USD).
prices[].localPrice
string
Required. Price of the item in the specified country's currency.
106: ItemGroup doesn't exist in production level. Need to publish IAP-supported app.
110: Item does not exist
409 Conflict
105: The item already exists with the requested id
107: There are multiple ItemGroupIds or ItemIds with the requested packageName
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.