Skip to main content
Samsung Developer Program

Registering a Single In-App Item

Before or after getting distribution approval for your Android IAP-integrated app and its in-app items, you can register new in‑app items one at a time.

Note: You cannot register new in-app items while your app is undergoing certification.

To individually register an in-app item for an IAP-integrated app:

  • Ensure that an IAP-integrated Android binary file has been registered to your app. After some actions, a notice popup window is displayed that requires clicking a button (such as OK). Notice popup steps are NOT indicated in this procedure.
  • To see help text, hover the mouse over a field's Comments icon Comments_Icon.png, click Show Tip: On (info tips for all fields), or toggle-click an individual field's Info Tip icon Info_Icon.png .
  1. Log in to Samsung Seller Office via your commercial seller account.
  2. Select your IAP-integrated app:
    1. In the menu bar, click Applications > My applications

      Apps_MyApps_Page_update2.jpg
    2. In the My Applications page, locate your app in the list.
    3. If your app has not been submitted for distribution approval:
      1. Click its Registration Status.Click_Registration_Status_update.jpg
      2. In the Add New Application page, click the In App Purchase menu tab. IAP_Add_New_App_Page_Red_Submit_update.jpg
    4. If your app has been approved for distribution:
      1. Click your app's Update
        Note: It is recommended that you do not click your app's For Sale when adding items.

        IAP_Edit_App_Page_Red_Submit.png

      2. In its Edit Application page, click the In App Purchase menu tab.
  3. Register an in-app item:
    Note: Your in-app item must meet Samsung validation guidelines.
    1. In the In App Purchase panel, click Add Item
    2. Enter or update the in-app item information:  
      Add_Item_Popup.png

Enter required information, as shown in the following table.

Note: Enter all information in English.

Item ID

Identifier of the in-app item (English letters, numbers, and certain special characters, such as period, dash, and underscore) that is unique among all item IDs in the item group

After entering a proposed ID, click Check

If a notice is displayed, click OK and enter and check a different ID.

Caution: After item registration, item ID cannot be changed.

Item Title

Name of the in-app item (English letters, Korean letters, numbers, spaces, and certain special characters, such as period, dash, and underscore, fewer than 100 bytes) unique among all item names in the item group

Users will be able to see the item name in the Samsung Unified Payment window when they purchase in-app items.

Item Type

Type of in-app item:

Caution: After item registration, item type cannot be changed.

Consumable

 
Item can be purchased one or more times, remains effective/available in the app until it is used, after which it becomes ineffective/unavailable (such as in-game coins, food, potions).

Non-consumable

Supported by IAP v2.0 and above

Item needs to be purchased only once to remain effective/available in the app at all times, even after deletion and re-installation of the app (such as a more difficult race course or a premium upgrade of the user's account).

Non-recurring
Subscription


Supported by IAP v2.0 and above

Item can be purchased one or more times and remains effective/available in the app during the subscription period (Duration) after each purchase (such as enhancements for the user's game character or images for each day of one month).

Auto-recurring
Subscription
After initial purchase/free trial, an auto-recurring purchase is applied. Samsung IAP provides a monthly subscription (such as a monthly magazine).

Duration

For non-recurring subscription items ONLY, the length of time (1, 3, 6, or 12 months) from the purchase date that the item is effective / available to the user

CAUTION:  After item registration, duration cannot be changed.

Payment Cycle

For auto-recurring subscription items ONLY, the length of time (1 month only) from the purchase date that the item is effective / available to the user for each subscription period

1 month is the interval the user is billed to automatically re-subscribe.

Free Trial Period

For auto-recurring subscription items ONLY, the length of time (30, 60, or 90 days) from the purchase date that the item is effective / available to the user without charge

At the end of this period, the user is billed for their subscription.

Description Brief explanation of the item (1000 bytes maximum)

Price

The standard price (USD 0 to USD 400) of the in-app item

NOTE: For an auto-recurring subscription item: a value of 0 (zero) cannot be entered, and its standard price cannot be changed after the item is registered.

After entering a value, set the value by clicking Apply

For details about in-app item pricing, see the Managing In-App Items section.

 

  1. Complete the registration of the in-app item:
    1. Ensure that the Item ID and Item Type entries are correct.
      Caution: These entries cannot be changed after saving the in-app item.
    2. Click Save
  1. To register additional in-app items, go to step 3. Register an in-app item.
  2. Make the new in-app item(s) available to your users:
    1. If your app has not been certified for distribution:
      1. Complete the registration of your app.
        Note: After making entries for all required app fields, the Submit button turns red. 
      2. Submit your app and all of its in-app items to be certified for distribution.
        For details, see Seller Office Application Registration.
         
    2. If your app has already been certified for distribution, submit all of the new in-app items to be certified for distribution by clicking Submit

      Banner_Red_Submit.png

      The items will undergo certification for distribution by Samsung.