Skip to main content
Samsung Developer Program

Register Many In-App Items in Bulk

How to register multiple in-app items to your Gear IAP integrated Gear app

 

Using an Excel spreadsheet, you can register, but not update, one or more consumable, non-consumable, and non‑recurring subscription in-app items to your IAP-integrated app.

You can register in-app items in bulk before your app has been submitted for validation or after it has passed or failed validation. You cannot specify local prices or purchase options for different countries through the spreadsheet; however, you can do this for individual in‑app items after they have been registered in bulk.

After uploading a bulk item spreadsheet file:

  • For consumable and non-consumable items:
    • You can change: title, description, and standard price.
    • You can set local prices and phone bill payment for each distribution country.
    • You cannot change: ID or type.
       
  • For non-renewable subscription items, you can review but cannot change any values.
  • You can delete an uploaded item and then upload a new spreadsheet file to register an item with a new values.
     

For details about:

Note: You can also individually register a consumable, non-consumable, or auto-recurring subscription in-app item (Register or Change a Single In-App Item).

 

To register many in-app items in bulk:

  • You must have a commercial Seller Office account.
  • Ensure your app and its in-app item meet all applicable Samsung policies and requirements.
  • Ensure that your Gear app has successfully integrated Gear IAP functionality.

  • Ensure that your app:
    • Is either partially or fully registered.
    • Binary file(s) have been registered.
    • Has 'Registering' status or 'For Sale' status. 
       
  • During the procedure:
    • After some actions, a popup is displayed  that requires clicking a button (such as OK). Popup steps are not indicated.
    • 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 your Samsung Seller Office commercial seller account.
  2. Select your app and prepare to register a new in-app item.
    1. In the menu bar, click Applications > My applications
       

      Apps_MyApps_Page_update2.jpg

       

    2. Select your app and prepare to register new in-app items:
      1. In the My Applications page, locate your app.
      2. If your app has not been submitted for validation, click your app's Registering.

        App_Registering.png
         

        1. In the Add New Application page, click the In App Purchase tab.
          IAP_Add_New_App_Page_Red_Submit_update.png
           
        2. Click Item Bulk Upload.

           
      3. If your app has been approved for distribution, click your app's Update.

        App_Update.png
         
        1. In the Edit Application page, click the In App Purchase tab.
          IAP_Update_Full.png
           
        2. Click Item Bulk Upload.
           
  3. Get the spreadsheet file: 
    IAP_ItemBulkUpload.png
     
    1. Click Download Excel Form.
    2. Locally save the spreadsheet file.
       
  4. Complete and upload the spreadsheet file:
    • Open the spreadsheet file.
      IAP_Bulk_Spreadsheet.png
       
    • For each in-app item, enter all field information:

      Item ID *

      Identifier (up to 50 bytes) that you assign to 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
       

      Item Title *

      Name of the in-app item (English letters, Korean letters, numbers, spaces, and certain special characters  [period, dash, and underscore], up to 100 bytes) unique among all item names in the item group

      Users can see the item title in the Samsung Unified Payment window when they purchase the in-app item.
       

      Item Type *

      Kind of in-app item

      Usage and purchase functionality can depend on the current IAP operating mode, and the version of IAP integrated into the item's app.

      The list below contains a summary of item functionality.

      Consumable

      The in-app item (such as fuel and bullets in game apps) remains available to the user until they use it one time, after which it cannot be used again. 

      In all IAP operating modes, the item can be initially purchased, but cannot be purchased again until the item has been reported as consumed. After that, it can be purchased again. 

      Non-consumable

      The in-app item (such as fuel and bullets in game apps) remains available to the user until they use it one time, after which it cannot be used again. 

      In all IAP operating modes, the item can be initially purchased, but cannot be purchased again until the item has been reported as consumed. After that, it can be purchased again. 

      Non-renewable subscription

      The in-app item's subscription remains current for its specified time period, during which the user receives subscription components (such as newsletters, vouchers, and books). After the subscription expires, it is not repurchased and renewed.

      Duration

      For non-renewable subscription items only, the time period (1, 3, 6, or 12 months) from the purchase date that the item's subscription remains active.
       

      Price * The standard price (400 or less, United States of America dollars) that users must pay to get the in-app item
       
      Description *  Brief explanation of the item (up to 1000 bytes)


       
    • Locally save the completed spreadsheet.
    • Upload the completed spreadsheet to Seller Office:
      IAP_ItemBulkUpload.png
       
      1. In the Item Bulk Upload popup window:
        1. Click Browse.
        2. Navigate to and highlight the completed spreadsheet, and click Open.
        3. Click Upload.
           
    • In the In App Purchase page, verify your in-app items are listed.
       

 

  • Was this article helpful?