Skip to main content
Samsung Developer Program

Register Many In-App Items in Bulk

How to register multiple in-app items to your Samsung IAP integrated Android app or your Gear IAP integrated Gear app.

 

Using an Excel spreadsheet, you can register, but not update, one or more consumable or non-consumable 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:

  • Each updated item will take effect either:
    • Immediately when the item is not being purchased by any end-users.
    • 30 seconds later when the item is being purchased by any end-users.
       
  • 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.
       
  • 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 autorecurring 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 Android app has successfully integrated Samsung IAP functionality.

  • 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.png

       

    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 or Re-registering.

        MyApps_GWapp_Registering.png
        MyApps_IAP_Reregistering.png

      3. If your app has been approved for distribution, click your app's Update or Updating.
        MyApps_App_Update.png
        MyApps_App_Updating.png
         
      4. In the Edit Application page, click the In App Purchase tab. and Item Bulk Upload.

        AddEditApp_InAppPurchase_ItemBulkUpload.png
  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. 

      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?