Skip to main content

Ready to market your stellar app?

Samsung Developer Program is your gateway to app monetization success.

Learn More

Samsung Developer Program

Registering an Individual 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.png
       
    2. In the My Applications page, locate your app in the list.
    3. If your app has not been submitted for distribution approval:
      Click_Registration_Status.png
       
      1. Click its [Registration Status]
         
      2. In the Add New Application page, click the In App Purchase menu tab

        IAP_Add_New_App_Page_Red_Submit.png
         
    4. If your app has been approved for distribution:
      Click_Update.png
       
      1. Click your app's Update
        NOTE:  It is recommended that you do NOT click your app's For Sale when updating.

        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 certification guidelines. 
    1. In the In App Purchase panel, click Add Item
    2. Enter or update the in-app item information:  

      Add_Item_Popup.png

NOTE:  All information should be entered in English.

Item ID

Identifier of the in-app item (English letters, numbers, and certain special characters (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 (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

Kind of in-app item:

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

Consumable

 
Item can be purchased 1 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 1 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, images for each day of 1 month).

Auto-recurring
Subscription
After initial purchase / free trial, its auto recurring purchase is automatically applied to the users. Samsung IAP provides monthly subscription (such as 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. For each country, manage your in-app item's local price, and either enable or do not enable user payment via their phone bill.

CAUTION:     Ensure each country has a suitable local price.
                        Each local price will ONLY be in effect after your app AND the in-app item are certified for distribution.

NOTE:  For each country, you have the following options:

  • Do not enable phone bill payment and either:
    • Accept the default local price (based on the standard price and the exchange rate or a price set by country price requirements).
    • Enter your own local price (subject to country price requirements).
       
  • Enable phone bill payment (when available) and either:
    • Accept the default local price (which is the phone bill nearest to the default local price).
    • Select another available phone bill price as the local price.

NOTE:   For details about the payment method applied to each country, see the Seller Office Terms and Conditions.
 

  1. In the Add Item Item popup window, click Advanced Mode
  2. When NOT enabling phone bill payment:
    In-App_Item_No_Phone_Bill.png
     
    1. Review the local price for the country.
    2. If the default local price is NOT suitable, enter a suitable price.
      NOTE:  If your new price is below the country minimum, the price will be changed to the minimum.
      If a notice is displayed that your entry does not meet country price requirements, either accept the automatically entered price or enter another price.
    3. Go to step 3.d. below.
       
  3. To enable phone bill payment:
    1. Checkmark Payment Method: Phone Bill (Premium SMS/Carrier Billing)

      Payment_Method.png
       
    2. For each country in which to make phone bill payment available:

In-App_Item_Apply_Phone_Bill.png
 

  1. Checkmark Apply Phone Bill
  2. Review the new default local price, which is the phone bill price nearest to the original default local price.
  3. Review the equivalent USD price.
  4. If either the new default local price or the USD price is NOT suitable, select a suitable phone bill price.

 

  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 above.
  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.  
  • Was this article helpful?