Preparation for Global Distribution
Last updated
Last updated
ONE store: an Android app store that provides services in 'South Korea'.
Global Platform: An Android app store available in countries/regions other than 'Korea'.
Developers can list their products in both the Korean and global markets with just one product registration in the ONE store Developer Center.
Developers who have their existing products on the ONE Store simply need to choose global distribution
The ONE store Developer Center repackages the apps registered by developers to generate a global service APK, which is then distributed to ONE store Global users.
The ONE store client and server are separately configured for Korea and the global market.
When the IAP SDK API is called within the app, it automatically integrates with the ONE store client/server based on the service country/region.
When making IAP Server API calls from the developer's server, the market classification code (x-market-code) must be provided.
Service Country/Region | Installer Package Name | Market Classification Code |
---|---|---|
Korea |
| MKT_ONE |
Others |
| MKT_GLB |
For Global Platform distribution, the ONE Store in-app payment SDK V19 (API V6) or higher must be applied.
Apps using SDK V17 require an SDK upgrade.
Apps using SDK V16 must be registered as new apps with SDK V21 or higher.
Apps with security solutions for integrity checks are required to apply an updated SDK to resolve any conflicts with the security solution.
ONE store and Global Platform have separate app groups.
Apps for Korea should connect to ONE store, while apps for other countries should connect to Global Platform.
Apps in ONE store using SDK V19 or higher can be directly distributed worldwide and will be automatically connected to Global Platform.
To identify the marketplace(ONE store or Global Platform) from which a user downloaded the app, the Market Classification Code is necessary.
The acquired Market Classification Code should be included as a header when using the server API to verify the currently used store.
How to Obtain Market Classification Code
The domain for Global Platform service and for Korean exclusive service are different.
To offer Global Platform services, a domain change is necessary.
For exclusive service in Korea : https://apis.onestore.co.kr
For global service: https://iap-apis.onestore.net
The Market Classification Code (x-market-code) has been added to the request header.
For Global Platform services, the header should include the acquired Market Classification Code when utilizing the server API.
If the Market Classification Code is absent, it will be treated as an app for Korea.
<Example>
Market Code | Service Country/Region |
---|---|
MKT_ONE | Korea |
MKT_GLB | Others |
For PNS, the message sending addresses for ONE store and Global Platform are different.
Hence, if a firewall is in place, two firewall exceptions are necessary for each sending address.
The 3rd party payment API version has been updated to V6.
To offer Global Platform services, a domain change is necessary
For exclusive service in Korea: https://apis.onestore.co.kr
For global service: https://iap-apis.onestore.net
Country/region information and currency codes have been added to the Request Body of the purchase history transmission API for 3rd-party payments.
When transmitting the 3rd-party payment transaction history, it should be sent with the amount in the currency in which the transaction was made.
The 3rd party payment purchase history has been updated. (send3rdPartyPurchase-p1)
When transmitting 3rd party payment purchase history that occurred in the United States, you must use the send3rdPartyPurchase-p1 specification.
The existing specification can be used without modification in countries/regions other than the United States, but it is scheduled to be deprecated in June 2025, so please use the new specification.
Service fees must be wired based on the country/region you registered in upon signing up for the ONE store Developer Center.
If the member's country is Korea, the transfer should be made in Korean Won (KRW). (However, for U.S. sales, payments must be remitted in USD to a separate account designated by the service provider in that country.)
If the member's country is any other country/region than Korea, the transfer should be made in USD. (However, for U.S. sales, payments must be remitted in USD to a separate account designated by the service provider in that country.)
The exchange rate applied to calculate service fees is the exchange rate on the 1st day of the following sales month (based on Seoul Money Brokerage's official exchange rate. In cases where the 1st day is a public holiday, the exchange rate of the previous business day will be used).
Subscription-based products are not supported in Global Platform.
Even if subscription-based products were previously registered, they will not be distributed in the Global Platform.
For information on setting distribution countries/regions, local pricing, and multilingual settings, please refer to App Registration and Mgmt.