Skip to main content
Samsung Developer Program

Preparing to Register In-App Items

Samsung In-App Purchase (IAP), available in over 90 countries that support Galaxy Apps' paid services, supports a range of payment methods including credit card, phone bill, and PayPal. At the time of user purchase, Samsung IAP manages getting and displaying the sales information of a user-selected in-app item; for example, availability, current price, and payment options.

Note: Starting with Samsung In-App Purchase SDK 4.0, your Gear apps can now offer in-app items for sale. These transactions are managed via Samsung Billing, which makes purchase and payment processing more robust because Samsung Billing is preloaded on all new Samsung Galaxy devices.

In-App Item Pricing and Payment Options

This section presents a summary of how you and other factors determine the price that users pay for your in-app items and how you can control payment methods. 

In-app item pricing involves several types of price:

Price Description

Standard price

The base price (USD) from which other prices are calculated

You must enter and apply this price (Price*) when registering an in‑app item. For consumable, non-consumable, and non-recurring subscription items, you can change this price before and after distribution. For auto-recurring subscription items, you cannot change this price after registering the item.

Localized standard price

The current price (local currency) of the base price after the current rate of exchange is applied

If no other pricing factors are applied, this price will be the default local price.

Available phone bill price

When you make available the phone bill payment method,
1 or more local prices that a user can pay for an item

All available phone bill prices meet all country price requirements.

Minimum country price

When set by a country, the lowest price a user can pay for an item

Local price

The price (in local currency) your user must pay for an in-app item during the purchase transaction, not including any additional local taxes or fees

This price must meet all country pricing requirements. When you make the phone bill payment available, this price will be an available phone bill price.

The following pricing principles apply:

  • You can accept the default local price or enter a new local price.
    • The default local price is automatically set by Seller Office by applying all applicable pricing factors to the standard price: the current exchange rate, country price requirements, and country-specific phone bill prices when phone bill payment is available.
    • When you set a local price:
      • Seller Office ensures your local price meets all country price requirements and is a supported phone bill price when applicable.
      • Your valid local price setting is in effect when your app and the in-app item are currently certified for distribution.
      • Caution: After you input a local price, Seller Office may adjust the local price to comply with requirements. Ensure all local prices are suitable to you. Samsung Galaxy Apps is not responsible for any loss incurred due to user negligence in checking prices.
    • For default settings and for your settings of the local price:
      • If a proposed local price is below the minimum country price, the local price is automatically adjusted to the minimum.
      • When phone bill payment is made available, if a proposed local price is not an available phone bill price, the local price is automatically adjusted (up or down) to the nearest available phone bill price.
  • For auto-recurring subscription in-app items:
    • You cannot enter a zero (0) value for the standard price or a local price.
    • After the item is registered, you cannot update the standard price or set any local price.
  • For non-recurring subscription in-app items:
    • After the item is registered, you cannot update the standard price or set any local price.
  • When the Samsung Galaxy Apps service initially becomes available in a distribution country and you agree to "When Samsung Galaxy Apps becomes available in more countries or with more payment options, your applications will automatically be sold in those countries":
    • All default local prices for all in-app items will be initially based on the exchange rate in effect at the time the service becomes available. 
  • If you agreed to "When Samsung Galaxy Apps becomes available in more countries or with more payment options, your applications will automatically be sold in those countries," then the item price in each new country will be based on the standard price at the time when the service opened in that country, and determined by the appropriate exchange rate.
  • Calculating, setting, and changing local prices
    Exchange rates are updated every four hours. When a local price is calculated or recalculated, the current exchange rate is used.
    • For each distribution country:
      • The local price is calculated or recalculated and applied ONLY when:
        • You set a new standard price AND:
          • You accepted the default local price without checking Apply Phone Bill.
          • You checked Apply Phone Bill and accepted the default local price.
          • You checked Apply Phone Bill and selected a phone bill price.
      • Samsung Galaxy becomes available in a new country and you selected "When Samsung Galaxy Apps becomes available in more countries or with more payment options" in the Country & Price tab.
      • Local prices are NOT changed when:
        • You enter and save a value for a local price and you do not check Apply Phone Bill.
        • Exchange rates are updated.

Phone Bill Payment

You can make available in-app item purchase payment via your user's phone bill in countries that permit this payment method (as indicated in the Seller Office UI).

When you make the phone bill payment option available:

  • Your in-app items can only be sold for one of the available phone bill prices that is set for each distribution country.
  • When an item's localized standard price is not one of the available phone bill prices, the default local price is set to the nearest (above or below) available phone bill price.
  • You can accept the default local price or any other available phone bill prices.

Caution: After making phone bill payment available, each country's local price may change. Check all local prices and ensure they are suitable to you. Samsung Galaxy Apps is not responsible for any loss incurred due to user negligence in checking prices.

Registration Preparation

This section explains how to register and manage your commercial in-app items offered by your IAP‑integrated Android apps that are distributed (freely or commercially) via the Galaxy Apps store. You have several options regarding registering, submitting them for certification and distribution approval, and managing your IAP-integrated app and its in-app items after they are certified (both before and after they are actively distributed via the Galaxy Apps store).

To offer in-app items for sale from within your Android app, from within Galaxy Apps Seller Office you:

  • Register your Android app and its in-app items.
  • Submit them for certification (distribution approval).
  • Manage the distribution of your app, the financial aspects of the Android app and in-app items (set prices), and manage your finances.

Note: Your IAP-integrated app and all in-app items must pass certification in order to be distributed via the Samsung Galaxy Apps store. After your IAP-integrated app and items have passed, new in-app items must be submitted for and pass certification. 

Before registering in-app items to your app:

  1. You must get a Samsung Seller Office commercial seller account.

  2. All of your app's binary files must:

  3. Your app and its binary files must be registered in the Galaxy Apps Seller Office. 
    For details, see Seller Office Application Registration.

Note: If these conditions are not met, the In-App Purchase tab will not be active in the Seller Office Add New Application menu.

For details about Samsung terms and condition and the Samsung privacy policy, which can affect in-app item registration and pricing, in the Samsung Seller Office website, click the Samsung Terms & Condition and Privacy Policy links at the bottom of the web page.

After you register an IAP-integrated binary file to your app, Seller Office assigns a unique ID and a changeable title to the group of in-app items to be registered to your app.The item group ID and title are displayed in the Seller Office In App Purchase list of in-app items registered to your app, which is displayed in the Add New Application by clicking the In-App Purchase menu item.

IAP_Add_New_App_Page_Red_Submit.png

All binary files with the same package name will be associated with the same in-app item group ID and title. You cannot change the assigned item group ID. However, you can change the item group title by clicking Modify and entering and saving a new title.

Note: A binary file cannot be registered if it has the same package name of a binary file that was registered by any OTHER Seller Office Commercial Seller, even after the file was deleted.

If you encounter a duplicate binary file name:

  1. In the Seller Office UI, click Support > 1:1 ENQUIRY.
  2. In the Samsung For Developers Content & Services Customer Support website, click Contact us.
  3. In the Contact us form, fill in the form with the details and click Submit.
  • Was this article helpful?