Skip to main content
Samsung Developer Program

Android App Registration Fields

When a field title has an asterisk (*):

  • When 'Conditional' is not in the field description, a field entry must be entered.
    or
  • When the field description starts with 'Conditional', a field entry is sometimes required and is not at other times.
    • In the field description, the condition is stated first.
    • When the condition is met, a field entry must be entered.
    • When the condition is not met, a field entry is optional and can either be entered or not entered.
       

When a field title does not have an asterisk:

  • When 'Conditional' is not in the field description, a field entry is optional and can either be entered or not entered.
    or
  • When the field description starts with 'Conditional', a field entry is sometimes required and is not at other times.
    • In the field description, the condition is stated first.
    • When the condition is met, a field entry must be entered.
    • When the condition is not met, a field entry is optional and can either be entered or not entered.
       

App Information tab

Fundamental app information

Fields in the App Information tab.

 
 

[Language]

The language in which you provide application information

Add: Add local languages in which you want to provide application information. If you do not add any local languages, the information is provided in the default language.
Select Language:  Select one of the added languages in which you want to provide application information. Fields available for that language are displayed.
Change default: Change the default language to one of the added languages. Fields for that language are displayed.

If the app is distributed to only one country:

  • Enter app information in the most suitable language.
  • If the suitable language is English, use the English (Default) tab.
  • If the suitable language is not English, use another language tab.

If the app is to be distributed to more than one country:

  • App information must be entered in English in the English (Default) tab.
  • App information can also be entered in one or more other suitable languages in the additional language tabs.

See Alternate languages for information about adding, selecting, and changing languages.

Application Title *

Name of the app that is displayed in your Samsung app store listing (maximum: 100 bytes)

This title must be unique among all Android app titles currently registered in all Seller Office accounts (yours and others). However, this title may be a duplicate of a title registered for a Gear or Theme app. Duplicate titles can be used for Tencent apps that are distributed in China.


A title can be re-used after a previously registered app has been suspended and terminated.

Short Description

Brief explanation of the app displayed in the Chinese app store listing (maximum: 40 bytes)

This field is only available when Simplified Chinese is the selected language.

Description *

Explanation of the app (including a description, features, requirements, and supported languages) that is displayed in your app store listing (maximum: 4000 bytes)

For non-English apps, the description must contain a warning stating that the full features of the application may not be available on devices that do not support the app's languages.

New Features

Explanation of the changes made to an updated app (maximum: 4000 bytes)

This field is only available when the app is being updated.

Tags

Up to five words or phrases associated with the app in order to aid user searches (maximum: 20 bytes each)

Icon *

App icon or logo file

Image requirements:

Android: PNG file, 512x512 pixels, up to 1024 kB
Edge Screen: Edge Single Mode or Edge Feeds Mode application, PNG file, 160x2560 pixels, up to 1024 kB
Edge Screen - Single +: Edge Single + Mode application, PNG file, 550x2560 pixels, up to 1024 kB

To upload a file, click-and-browse or drag-and-drop.

Cover Image

Image file (JPG or PNG file, 1024x500 pixels, and up to 1024 kB)

To upload a file, click-and-browse or drag-and-drop.

Screenshots *

Image files of app screenshots to be displayed in your app store listing (JPG or PNG file, 320-3840 pixels with a maximum 2:1 aspect ratio)

You must register 4-8 screenshots. If more than eight screenshots are uploaded, only the first eight images are displayed.

If you register a link to a YouTube video, a screenshot of the video and the link is displayed automatically in the first screenshot location of the app store listing.

To upload images, click-and-browse or drag-and-drop.

Category *

One or more app store groups and their sub-groups that best describe the app

Note: When a category is selected, one of its sub-categories must be selected.

Available categories and sub-categories depend on the platform, binary files, permissions, and other factors. General selections are available to Samsung partners. Galaxy selections are available for non-partners. Exclusive selections apply to apps only distributed through Samsung app stores and not through any other app stores.

Unless governed by distribution country requirements, the app is listed in the Samsung app store under one or both categories and sub-categories. If the category selected is not suitable for the application, it may be changed automatically.

General: Root-level category and its sub-category.
Galaxy: Non-root level category and its sub-category.
Exclusives: Non-root level category and its sub-category.

Game apps must specify one or both of the following:

General: (Games)
Galaxy: (Game)
Exclusives: (Game)

Age Restriction *

The Samsung Galaxy Apps age rating of the app

The selected age rating and distribution country determine the age displayed in your app's Galaxy Apps Store listing.

Kids Age Restriction *

When the Kids category is selected, the age range for the app

The selected age range and distribution country determine the age displayed in your app store listing.

Rating Certificate for Available Countries

For game apps only, one or more game industry age ratings and certificates

Note: Initial entries are determined by the selected Age Restriction and Kids Age Restriction fields.

For non-game apps
Other than the default entries, there are no requirements that must be met. However, uploading certificates can help establish the proper age rating of your app.

For game apps
Game industry age rating certificates issued to the app must be scanned and uploaded. There can be data entry requirements that must be met.

For each age restriction certificate issued to the app by one of the listed or other issuing organizations, do the following:

  • For certificates issued by an organization not listed, upload them to the ETC category.
  • If GRAC and MJ/DEJUS age ratings are issued to the app, select Age Restriction: (the issued rating).

    Note: When the Age Restriction field is set to 18+, the MJ/DEJUS age rating is set to 18 and cannot be changed. If the issued rating is different, note this in the certification comments.

To upload a certificate, click Upload, and navigate to and select the scanned certificate's JPG, PNG, or GIF image file.

Supported Languages *

One or more languages that the app presents graphically or audibly in its UX, instructions, or other ways to users


To add a language, click Add, mark one or more languages that the app supports, and click Save.

To delete a language, click [Language's X-box].

Open Source URL

Conditional  For apps that use or include open source software, the URL of the open source license (maximum: 200 bytes)

Privacy Policy URL

Conditional  For apps that have a privacy policy that require a separate notification, the URL of the app privacy policy (maximum: 200 bytes)

Required if the Kids category is selected. If a privacy policy is not specified, the category may be changed during certification.

Optional for all other app categories.

YouTube URL

YouTube video ID of a YouTube video related to the app (11 characters)

Example format of a complete URL: http://www.youtube.com/watch?v=<YouTube video ID>

The initial screenshot and hyperlink of the video is automatically displayed in the first screenshot location of the app store listing.

For more details, see How to find the url of a Youtube video?.

Copyright Holder

Conditional  For apps that have copyrighted content, the name of the copyright holder of the app (maximum: 100 bytes)

If a company is the holder, enter the company name. If an individual is the holder, enter the individual's name.

When specified, the copyright holder's name is displayed in the app store listing instead of the seller's name. When not specified, the seller's name is displayed as the copyright holder.

Support E-Mail *

Email address of the person to whom app end-users can send inquiries (maximum: 100 bytes)

To auto-populate with the Seller Office account holder email, select Use my default profile information.

Support URL

URL of the available end-user support site for the app (maximum: 200 bytes)

Notify Result

Email address(es) that are notified when the status of the app registration changes (maximum: 20 email addresses)

To enter additional email addresses:

  1. Click +
  2. Enter the email address.

To remove an email address, delete it from the list (using "-" removes the last line in the list).

Binary tab

Component binary file information

Fields in the Add binary popup of the Binary tab.

 
 

Resolution(s)*

One or more video resolutions supported by the app

Check All: The app supports all listed resolutions.
[Resolution]: The app supports the selected resolutions.

This setting can be changed without having to upload a newer version of the binary file.

Google Mobile Service *

Whether or not the app provides the user with any Google™ services (such as Google Maps™, Gmail™, and Talk)

Yes: The app provides one or more Google services.
No: The app does not provide any Google services.

Note: The distribution of an app that provides the user with any Google services is prohibited in some countries (such as China) and is automatically enforced by Seller Office.

When registering a new version of a binary file, this setting can be changed, if needed.

Binary Upload *

One app binary file to be registered

Note: You must complete the Resolutions and Google Mobile Service fields before you can upload the binary file.

To upload a binary file:

  1. Click Upload.
  2. Navigate to the file and select it.

Basic binary file information

Binary file information in the Binary tab.

 
 

No

Index number assigned to the binary file based on the order of adding files

Version

Latest version code and name of the binary file

File Name

Filename, number of bytes, and the status of binary file processing:

Registering: The file's app is being registered, or the file is being replaced.
In registration: The file has been uploaded but not submitted for validation testing, or the file's app free / commercial status has been changed.
Pre-certification: The file is undergoing Samsung pre-validation testing.
Certification: The file is undergoing Samsung validation testing.
Rejected: The file has failed validation or cannot be validated.
Passed: The file has successfully completed validation testing.
On sale: The file is currently being distributed (freely or commercially) or is waiting for the specified Selling Start date to start being distributed.

Device

Number of devices that are compatible with the binary file and are currently being distributed in the app store

Modify

Icon button to change info and upload a later version of the binary file

Delete

Icon button to permanently remove the binary file

Device compatibility information

Fields in the Detailed Device Settings popup of the Binary tab.

 
 

Device(s) has (have) been selected

Total number of devices that are check marked for distribution in the Galaxy Apps store

Change in total number are not indicated until after clicking 'Save'.

Binary [Number]

Number of each binary file, in the order they were registered to the app.

The latest binary to be registered has a red circle 'N' icon. Mouse-over the title to display the binary filename.

The On Sale check mark indicates the binary files are currently being distributed in the Galaxy Apps Store.

Group Title Bar

Title bar for each type of mobile device

Toggle click the title bar to expand or collapse the list of devices in the group type

Device listing

For each listed device/binary file combination, the status of compatibility and distribution of the binary to the device in the Galaxy Apps Store

Compatibility and distribution status

  • No checkbox: The device is not compatible with the binary and cannot be selected for distribution. However, the device is compatible with other registered binaries.
  • Empty checkbox: The device is compatible with the binary, but the binary is not selected for distribution.
  • Red checkmark: The device is compatible with the binary, and the binary is selected for distribution but is not currently being distributed.
  • On Sale checkmark: The device is compatible with the binary, and the binary is selected for distribution and is currently being distributed.
     

Device feature and resolution compatibility information

Fields in the Check Compatibility of Non-recommended Devices popup of the Binary tab.

 
 

API (minSdkVersion)

SDK requirement of the device, whether or not the binary file meets the requirement, and if not, the SDK version of the binary file

[Device Column]: SDK requirement of the device

[Binary File Column]:

  • [Empty]: The binary file meets the device requirement.
  • [Red text]: SDK version of the binary file that does not meet the device requirement

[Feature List]

Features supported or not supported by the device and binary file compatibility with the device support or non-support

[Device Column]: For each listed feature, whether or not the device supports the feature.

[Binary File Column]: For each listed feature:

  • [Empty]: The binary file is compatible with the device support or non-support of the feature.
    For example, the binary file requires a camera and the device has a camera, or the device has an accelerometer but the binary file does not require one.
  • [Red circle]: The binary file is not compatible with the device support or non-support of the feature.
    For example, the binary file requires a camera and the device does not have a camera.
Resolution

Video resolution supported by the device, binary file display resolution compatibility

[Device Column]: Video resolution(s) supported by the device.

[Binary File Column]:

  • [Empty]: The binary file is compatible with the device display resolution.
  • [Red circle]: The binary file display requirement is not compatible with the device display resolution.

Binary file detailed information

Binary file details in the Binary tab.

 
 

Version Code

Integer value that represents the version of the app code in the binary file relative to other versions

Version Name

String value that represents the release version of the app code in the binary file for display to others

Updated

Local time (in local format) that the binary file was last registered

Device Recommendation Information

General information about the binary file and supported user device features

Package Name: Name of the binary file.

API (minSdkVersion): Lowest API level that the binary file is compatible with.
API (maxSdkVersion): Highest API level that the binary file is compatible with.
Note: API level identifies the framework API revision offered bybut is notthe Android version number.
[Device Feature]: Whether the binary file supports/uses the listed device features (green check mark) OR does not (no check mark).

For details, see the Samsung Seller Office Application Validation Guide.

Galaxy Specials Information

For each Galaxy Special SDK below, whether the app has integrated (green checkmark) OR has not integrated (no check mark) SDK APIs

  • Samsung Developer SDK
  • Samsung IAP SDK
  • S Pen SDK
  • Group Play SDK
  • S Health SDK
  • Smart Connectivity SDK
  • Music Studio SDK
  • PEN.UP SDK

Additional Information

Whether the binary file supports/provides the listed item (green check mark) or does not (no check mark)

VOIP: The file supports VoIP.
Google Mobile Service: The file provides Google mobile services to users.

Open beta test information

Open beta test settings in the Binary tab.
 

Feedback Channel *

Your email address or webpage URL that enables testers to send you feedback (maximum: 200 bytes)

To auto-populate with your Seller Office account email, select Use my default Email ID information.

Beta Testing URL

URL to download the beta version application

Caution: The URL is completed only after you have registered the beta app's binary files.

Send the URL to beta testers.

 

Closed beta test information

Closed beta test settings in the Binary tab.
 

Tester Settings *

Samsung account ID of every beta tester (maximum: 1,000 testers, 100 bytes per account ID)

To enter one tester, enter their ID and click Confirm.

To enter many testers, click Bulk Registration. In the popup, enter one tester ID per line and click Save.

To delete one tester, click their X-box.  To delete all testers, click Delete All.

Feedback Channel *

Your email address or webpage URL that enables testers to send you feedback (maximum: 200 bytes)

To auto-populate with your Seller Office account email, select Use my default Email ID information.

Beta Testing URL

URL to download the beta version application

Caution: The URL is completed only after you have registered the beta app's binary files.

Send the URL to beta testers.

Country & Price tab

Free app information

Free app fields in the Country & Price tab.

 
 


Price *

Whether or not app download requires a user payment

Free: Users can download the app without payment.
Caution: When an app is switched between free and paid, current distribution countries and prices are reset.

Country 

Countries and groups of countries to which the free app is to be distributed

There are restrictions based on other registration settings. When a selected country  or any country in a selected group contradicts a restriction, the country or group will be automatically changed to not selected. For details, see Distribution Countries and Restrictions.

Distribution Country

  • To enable or disable app distribution to all listed countries and groups, click Check All (Country).
  • To enable or disable app distribution to one listed country or group, click the checkbox next to the country's name.
    Caution: If no country or group is selected, the app will not be distributed to any country.
  • To automatically distribute the app to a new country or group when it initially becomes available, select: When SAMSUNG Galaxy Apps becomes available… .

Selling Starts

When distribution of the app in the Samsung app store begins

[Date entered or selected]: Date that app distribution starts, either on or after the day of app approval, whichever is later.

Selling starts on the day of approval:

  • Checked: Default Distribution starts soon after the app is approved for distribution.
  • Unchecked: Distribution starts on the specified date.

 

Selling Ends

When distribution of the app in the Samsung app store stops

[Date entered or selected]: Distribution stops at the beginning of the specified date.

Permanent:

  • Checked: Default Distribution does not stop until: you uncheck this checkbox and enter a stop date, you terminate the app, you cancel your Seller Office account, or distribution is suspended due to a requirement issue.
  • Unchecked: Distribution stops on the specified date.

US Export Laws *

Conditional Whether or not you certify that the app is in compliance with all applicable U.S. export laws for export to other countries

Checked:  You certify your app is in compliance.
Unchecked: You do not certify your app.

Note: If your app is not in compliance, it cannot be submitted for validation and distribution.

Paid app information

Paid app fields in the Country & Price tab.

 
 

Price *

Whether or not app download requires a user payment, and the standard price of the app:

Paid: Users can download the app after making a payment.
USD ($): Standard USD price (in United States of America dollars) that determines the default country-specific price for all distribution countries.

Other factors can override the default country-specific price.
For each distribution country, the price displayed in the app store in the local currency is the country-specific price at the time of the transaction.

For details, see the Country field below.
For more app and in-app item pricing details, see Pricing and Payment.

After the USD amount is correctly specified, click Apply.
To change the USD amount, enter a new price and click Apply.

Caution: When an app is switched between free and paid, current distribution countries and prices are reset.

About the USD field:

  • The price must be greater than zero but cannot be greater than $400.
  • The price can contain up to five characters (valid characters are numbers and a single decimal point). For example, 9, 1.9, 1.99, and 10.99 are valid values, but 100.99 is not an acceptable value.
  • When using the decimal point, a number must appear before and after it. Therefore, if you are entering a price under $1, you must include a zero before the decimal point (for example, 0.99).
  • The numbers entered after the decimal point must be greater than zero and cannot end with a zero. For example, 1.9 and 1.99 are valid values, but 1.00 and 1.90 are not an acceptable values.
  • If you enter three numbers after the decimal point, the last number is ignored.

Payment Method

One or more methods available to the user to pay for the app when supported in a distribution country and not overridden by phone bill payment: Credit Card, Micropayment, PayPal®, Phone Bill, Cyber Cash, WebMoney, and Pre-Paid Card.

Red check: The method is available to users in supporting countries and cannot be made unavailable unless overridden by phone bill payment.
Blue check: You have made the method available to users in supporting countries.
Checkbox: You can make the method unavailable (unchecked) or available (checked) to users in supporting countries. To change the method's availability, click the method's checkbox.

Note: Credit card and phone bill payment (if selected) are the default methods of payment.

Payment method(s) can vary based on the distribution country.

For billing details, click How will billing fee be paid by payment methods?

For more payment method details, see the Country field below and see Pricing and Payment.

Country

Countries and groups of countries to which the paid app is to be distributed, and app price and payment methods for each country

There are restrictions based on other registration settings. When a selected country or any country in a selected group contradicts a restriction, the country or group will be automatically changed to not selected. For details, see Distribution Countries and Restrictions.

Distribution Country

  • To enable or disable app distribution to all listed countries and groups, click Check All (Country).
  • To enable or disable app distribution to one listed country or group, click the checkbox next to the country's name.
  • Note: If no countries are selected (default), the app will be distributed to all countries, unless specific countries are not eligible for distribution.
  • To automatically distribute the app to a new country or group when it becomes available, select: When SAMSUNG Galaxy Apps becomes available… .
     

App Payment

  • App payment methods available to users in each country are indicated by the displayed payment icons.
  • For countries with phone carrier agreements, phone bill payment can be made the automatic payment method, which causes phone bill payment to override all other available payment methods, and carrier price options to override the current country-specific price.
  • For more payment details, see Pricing and Payment.
  • To enable or disable user payment by phone bill payment:
    • For the payment service, click Phone Bill (Premium SMS / Carrier Billing).
    • For all available listed countries, click Check All (Apply Phone Bill). You should verify any changes to the price for each country.
    • For each available listed country, click the country's Apply Phone Bill checkbox.
       

App Price for a Country

The country-specific prices displayed for each country are what users currently pay to download the app.

  • The localized standard price (determined by the standard USD price of the app and the current daily rate of exchange) is displayed initially.
  • You can manually enter a new price but you cannot enter a price lower than the minimum or higher than the maximum price (minimum and maximum prices may vary by country).
  • When phone bill payment for a country is enabled:
    • The price will be changed to the nearest phone carrier price that is not greater than the initial price.
    • You can select another price available in the list of phone carrier prices.
  • For more pricing details, see Pricing and Payment.

Selling Starts

When distribution of the app in the Samsung app store begins

[Date entered or selected]: Date that app distribution starts, either on or after the day of app approval, whichever is later.

Selling starts on the day of approval:

  • Checked: Default Distribution starts soon after the app is approved for distribution.
  • Unchecked: Distribution starts on the specified date.

Selling Ends

When distribution of the app in the Samsung app store stops

[Date entered or selected]: Distribution stops at the beginning of the specified date (00:00:00 local time).

Permanent:

  • Checked: Default Distribution continues until: you uncheck this checkbox and enter a stop date, or distribution is suspended due to a requirement issue.
  • Unchecked: Distribution stops on the specified date.

US Export Laws *

Whether or not you certify that the app is in compliance with all applicable U.S. export laws for export to other countries

Checked: You certify your app is in compliance.
Unchecked: You do not certify your app.

Note: If your app is not in compliance, it cannot be submitted for validation and distribution.

Beta test information

Beta test app fields in the Country & Price tab.
 

Selling Starts

For open and closed beta releases, when beta testers can begin downloading the beta app

Selling starts on the day of approval: Downloading is supported within 10 minutes of beta release submission.

[yyyy-mm-dd date entered or selected]: Downloading is supported beginning on the specified day.

Selling Ends

For open and closed beta releases, when downloading of the beta app is no longer supported

Permanent: Downloading support does not automatically stop; downloading is supported until the beta release is manually suspended.

[yyyy-mm-dd date entered or selected]: Downloading is no longer supported starting on the specified day.

 

In App tab

In-App group information

In-App group fields in the In App Purchase tab.

Item Group ID

Identifier of the group of items

This ID is assigned by Seller Office and cannot be changed. The ID is used to support your app, for example, during email communication.

Item Group Title

Descriptive title name of the group

This title can be changed for your own purposes. The title can be identical to another item group registered to your or any other app.

In-App item basic information

The first three in-App item fields in the Add Item popup of the In App Purchase tab.

Caution: After the item registration is saved or the spreadsheet is uploaded, the entries or values cannot be changed for the following fields: Item ID and Item Type. However, you can delete and re-register an in-app item.

Item ID *

Identifier of an item (English letters, numbers, and certain special characters [period, dash, and underscore]) that is unique among all item IDs in the item group (up to 130 bytes)

After entering a proposed ID, verify it is unique by clicking Check.
If a notice is displayed, click OK and then enter and check a different ID.

Caution: The Item ID value cannot be changed after the item is saved.
 

Item Title *

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

This title can be changed later.

Users see the item title in the Samsung Unified Payment window when they purchase in‑app items.
 

Item Type *

Kind of in-app item

Usage and purchase functionality can depend on the IAP operating mode, and the version of IAP integrated.

Note: After the user deletes and re-installs the app, the following items purchased before deletion can be recovered: non‑consumable, non‑recurring subscriptions, and auto‑recurring subscription items.

Caution: The Item Type value cannot be changed after the item is saved.

Item

The in-app item is either:

  • A consumable item when you checkmark 'This item can be purchased multiple times'.
  • A non-consumable item when you do not checkmark 'This item...'. 

For details, see below. 

 

 

Consumable

Supported by IAP v2.0 and above.

Each item can be purchased one or more times and remains effective or available in the app until it is used one time, after which it becomes ineffective or unavailable (such as in‑game coins, food, or potions).

Note: Items can be registered individually or in bulk.

In all IAP operating modes:

  • The item can be initially purchased.
  • For all other purchases:
    • After IAP v5.0, the item but cannot be purchased again until the item has been reported as consumed. After that, it can be purchased again. 
    • Before IAP v5.0, the item can be purchased again at any time without restrictions.

 

 

Non-consumable

Supported by IAP v2.0 and above.

Each item is purchased only once and remains effective or 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).

Note: Items can be registered individually or in bulk.

In both IAP developer test modes: the item can be initially purchased, and then purchased again 10 or more minutes after the last purchase (to support testing) by re-initializing the IAP operating mode to a developer test mode.

In IAP production mode: the item can be initially purchased, but cannot be purchased again. 

Subscription

Auto-recurring subscription

Supported by IAP v2.0 and above.

Each item can be purchased one or more times. The in-app item's subscription remains active for its specified time period, during which the user receives subscription components (such as newsletters, vouchers, books, or enhancements of the user's game character) through a method that is independent of Samsung IAP (such as such as through the app or by email). While the subscription is active, new subscription components can be periodically issued. After the subscription expires, it is automatically repurchased and renewed, unless stopped by the user.

Starting with IAP v5.0, subscription items can offer a free trial period (7 to 999 days) before the first paid subscription time period.

Subscription components remain available for use, even after termination of the subscription.

Note: Items can only be registered individually.

For all items:

  • Subscription time period can be:
    • For IAP v5.0 and later: 1 week, 1 month, 3 months, 6 months, or 1 year.
    • Before IAP v5.0: 1 month
       
  • While a subscription remains active:
    • Subscription components are provided to the user (for example, upon initial purchase, periodically while the subscription is active, and upon renewal) by you or your app by methods that are independent of Samsung IAP.
    • The user can use the provided subscription components.
       
  • When a subscription expires, the user is automatically billed the item price and the subscription is renewed, unless stopped by the user.
     
  • After the user stops the subscription:
    • New subscription components are not provided.
    • All previously provided subscription components can be accessed and used indefinitely.
    • The user can again purchase the subscription item.
       

For items without a free trial period:

  • When the user initially purchases the subscription item:
    • The purchase and payment transaction:
      • Bills the user for the item's price.
      • Commits the user to automatic renewal (including item price billing) after the subscription expires.
    • The subscription time period begins after a successful purchase transaction.
       

For items with a free trial period:

  • When the user initially 'purchases' the subscription item:
    • The purchase and payment transaction:
      • Does not bill the user for the item's price.
      • Commits the user to automatic renewal (including item price billing) after the free trial period expires.
    • The free trial period begins after a successful 'purchase' transaction.
       
  • During the free trial period, the subscription is active and subscription components can be provided and used.
     
  • After the free trial period: 
    • The user is billed the item price and the subscription time period starts.
    • The subscription remains active for its specified time period
    • After each subscription expires, the user is automatically billed the item price and the subscription is renewed, unless stopped by the user. 
       
  • After stopping the subscription, the user:
    • Can continue to use all subscription components they previously received.
    • Does not receive new subscription components.
    • Can again purchase the subscription item.

 

In both IAP developer test modes: 

  • A subscription remains active for 2 hours, during which it cannot be repurchased.
  • After 2 hours, the subscription expires, is not automatically renewed, and can be purchased again.
     

In IAP production mode: 

  • A subscription remains active for its specified time period, during which it cannot be repurchased.
  • After the subscription expires, it is automatically repurchased and renewed, unless stopped by the user. 
  • After renewal is stopped, the user can again purchase the subscription item.
     
 

Non-recurring subscription (non-renewable subscription)

Supported by IAP v2.0 and up to but not including v5.0.

Note: Items can only be registered in bulk (Register Many In-App Items in Bulk).
 

 

Price by Country

Manage your in-app item's local price, and either enable or do not enable user payment using their phone bill for each country.

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 have been validated for distribution.

Payment Method *
This section lists one or more methods that users can pay for in-app items. Each red checked method may be available to users, depending on each specific country (see below).

If an empty checkbox or blue checkmark appears next to a method, that method can be made unavailable or available to users in supporting countries.  You can enable phone bill payment after you apply a standard price, which disables all other payment methods for users is the phone bill payment countries.

Note: For details about the payment method applied to each country, see the Samsung Seller Office Terms and Conditions link at the bottom of the web page.

Price by each country
Payment methods, local price, and phone bill payment are indicated for each distribution country, grouped into geographical regions. Settings for the Global A group apply to all countries in the group.

  • Payment method icons: For each distribution country, icons indicate the available payment methods, other than phone bill payment.

  • Phone bill payment: For each country with a phone carrier agreement, you can set phone bill payment as the automatic payment method, which causes: phone bill payment to be the only payment method for users in that country, and carrier prices to be the only available prices.

    After enabling phone bill payment, either:

    • Accept the default local phone bill price, which is the phone bill price that is nearest (above or below) to the default local price.

    • Select another phone bill price.
      Note: All phone bill prices meet country minimum and maximum requirements.
  • Local price for a country: After you apply a standard price, the default local price is displayed for each country, which is either: the current daily exchange rate applied to the standard USD price and or is the minimum price set by country price requirements.

    You can either:

    • Accept the default local price or default local phone bill price.

    • Enter a new local price that is above the minimum and below the maximum price when specified by a country.

Consumable and non-consumable in-app item information

Description *

Brief explanation or purpose of the item (up to 1000 bytes)
 

Price *

Standard price of the in-app item (USD 0 to USD 400, up to 5 digits)

The price determines the default country-specific item price for all distribution countries. However, other factors can override the default country-specific item price. For each distribution country, the price displayed in the app that the user must pay in the local currency to purchase the item will be the country-specific item price at the time of the transaction.

Note: For an auto-recurring subscription item, a value of 0 (zero) cannot be entered.

Caution: For auto-recurring subscription items, price cannot be changed after the item is saved.

After entering a value, click Apply to set the value.

For details about in-app item pricing, see Application Pricing and Payment Methods.

Auto-recurring subscription in-app item information

Caution: After the item registration is saved, the entries for all field can be reviewed but cannot be changed. However, you can delete and re-register an in-app item.

Payment Cycle * Length of time from the purchase date that the item is effective or available to the user for each subscription period (one month)
 

Free Trial Period

Length of time from the purchase date that the item is effective or available to the user without charge (minimum: 7 days)

If this entry is left blank, there is no initial free subscription time.

At the end of this period, an auto‑recurring subscription is started.
 

Description * Brief explanation or purpose of the item (up to 1000 bytes)
 

Price *

The standard price (400 or less, United States of America dollars) that users must pay to get the in-app item

 

In-app item bulk upload information

In-app item fields in the Bulk Item Upload spreadsheet.

Caution: After the spreadsheet is uploaded, the values cannot be changed for the following fields: Item ID, Item Type, and Duration. However, you can delete and re-register an in-app item.

Item ID *

Identifier of an item (English letters, numbers, and certain special characters [period, dash, and underscore]) that is unique among all item IDs in the item group (maximum: 50 bytes)

Caution: The Item ID value cannot be changed after the item bulk spreadsheet is uploaded.

Item Title *

Descriptive name of the in-app item (English letters, Korean letters, numbers, spaces, and certain special characters [period, dash, and underscore]) unique among all item titles in the item group (maximum: 100 bytes)

The title can be identical to another item registered to the app or any other app. Users see the item title in the Samsung Unified Payment window when they purchase in‑app items.

Item Type *

Kind of in-app item

Usage and purchase functionality can depend on the IAP operating mode, and the version of IAP integrated.

Note: After the app is deleted and reinstalled, the following items purchased before deletion can be recovered: non‑consumable, non‑recurring subscriptions, and auto‑recurring subscription items.

Caution: The Item Type value cannot be changed after the item bulk spreadsheet is uploaded.

Consumable

Supported by IAP v2.0 and above.

Each item can be purchased one or more times and remains effective or available in the app until it is used one time, after which it becomes ineffective or unavailable (such as in‑game coins, food, or potions).

Note: Items can be registered individually or in bulk.

In all IAP operating modes:

  • The item can be initially purchased.
  • For all other purchases:
    • After IAP v5.0, the item but cannot be purchased again until the item has been reported as consumed. After that, it can be purchased again. 
    • Before IAP v5.0, the item can be purchased again at any time without restrictions.

Non-consumable

Supported by IAP v2.0 and above.

Each item is purchased only once and remains effective or 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).

Note: Items can be registered individually or in bulk.

In both IAP developer test modes: the item can be initially purchased, and then purchased again 10 or more minutes after the last purchase (to support testing) by re-initializing the IAP operating mode to a developer test mode.

In IAP production mode: the item can be initially purchased, but cannot be purchased again. 

Non-renewable subscription (non-recurring subscription)

Supported by IAP v2.0 and up to but not including v5.0.

Each item can be purchased one or more times and remains effective or available in the app during the specified subscription time period after purchase,  during which the user receives subscription components (such as newsletters, vouchers, books, enhancements of the user's game character, or images for each day of one month) through a method that is independent of Samsung IAP (such as through the app or by email).

While the subscription is active, new subscription components can be periodically issued. After the subscription expires, it is not automatically repurchased or renewed. Delivered subscription components are available for use, even after termination.

Note: Items can only be registered in bulk.

For all items:

  • Subscription time period can be 1, 3, 6, or 12 months.
  • While a subscription remains active:
    • Subscription components are provided to the user (for example, upon initial purchase, periodically while the subscription is active, and upon renewal) by you or your app by methods that are independent of Samsung IAP.
    • The user can use the provided subscription components.
       
  • After the subscription expires, the user:
    • Can continue to use all subscription components they previously received.
    • Does not receive new subscription components.
    • Can again purchase the subscription item.
       

In both IAP developer test modes: 

  • A subscription remains active for 2 hours, during which it cannot be repurchased.
  • After 2 hours, the subscription expires, is not automatically renewed, and can be purchased again.

In IAP production mode: 

  • A subscription remains active for one month, during which it cannot be repurchased.
  • After the subscription expires, it is not automatically repurchased and renewed, and the user can again purchase the subscription item.

 

Duration *

For non-recurring subscription items only, the length of time from the purchase date that the item is effective or available to the user (1, 3, 6, or 12 months)

Supported by IAP v2.0 and up to but not including v5.0.

Caution: The Duration value cannot be changed after the item bulk spreadsheet is uploaded.

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 or purpose of the item (up to 1000 bytes)

 

Validation tab

Validation information

Fields in the Validation tab.

 
 

Please Enter Comments to the Validation Team *

Information to help with the evaluation of the app to determine whether or not the app is to be distributed (maximum: 4000 bytes)

Required

  • App login info (valid but temporary login ID and password) and fake card number if your application requires login and payment testing.
  • If the app does not meet requirements, an explanation of why the app does not meet these requirements.
  • ​If the app is being resubmitted after an update or a previous validation failure:
    • All changes made from the previous version.
    • Changes made to address all failure issues.

Note: If required information is omitted, the app may not pass validation.
 

Helpful

  • Upload a file with additional information (such as developer comments).
  • Information to prevent unnecessary QA failures (such as the concept of the app, self‑test results, and any precautions to be taken while testing the app).
  •  

For more information, see the Seller Office webpage and Validation Guide.

Upload

Attachments (such as copyrighted materials and video links) to help with the evaluation of the app (maximum: 10Mb)

 

Profile page

Beta testers for free in-app items information

License Test settings in the Profile page.

License Tester setting

For closed beta testing of Android apps that offer in-app items, the Samsung account name or email address of one or more closed beta testers who can get all of the app's in-app items without payment (up to 100 bytes per name or email address, maximum number of testers: 400).

To register one tester: enter their Samsung account name or email address, and click Confirm.

To register many testers: 

  1. Click Bulk Registration.
    BetaTest_LicenseTestFreeTesters_BulkRegistration.png
     
  2. List the testers' Samsung account name or email addresses (one name or address per line).
  3. Click Save.

To remove all registered testers, click Delete All.

  • Was this article helpful?