Skip to main content
Samsung Developer Program

Prepare 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: You offer in-app items for sale through your Gear apps. These transactions are managed through Samsung Billing, which is preloaded on all new Samsung Galaxy devices. For details, see the Gear In-App Purchase Items section.

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 is the default local price.

Available phone bill price

When you make the phone bill payment method available, one 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 is 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 certified for distribution.
      • Caution: After you input a local price, Seller Office may adjust the local price to comply with requirements. Ensure that all local prices are suitable for you. Samsung Galaxy Apps is not responsible for any loss incurred due to user negligence in checking prices.
    • For default settings and local price settings:
      • If a proposed local price is below the minimum country price, the local price is automatically adjusted to the minimum country price.
      • 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 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":
    • 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.
  • Calculate, set, and change 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 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 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" 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 in-app item purchase payment available through 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.

Prepare to register

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, through the Galaxy Apps store. You have several options regarding registering, submitting 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 through the Galaxy Apps store).

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

  • 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 through the Samsung Galaxy Apps store. After your IAP-integrated app and items have passed certification, 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 is not active in the Seller Office Add New Application menu.

For details about Samsung terms and conditions and the Samsung privacy policy, which can affect in-app item registration and pricing: In the Samsung Seller Office website, click the Terms of Use 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 Item Group Title are displayed in the Seller Office In App Purchase list of in-app items registered to your app. To see this list, click Add New Application, and select In-App Purchase.


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 is 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?