Preparation for Global Distribution

Terminology

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

ONE store Service Configuration

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

ONE store Installer Infomation & Market Classification Code

Service Country/Region	Installer Package Name	Market Classification Code
Korea	com.skt.skaf.A000Z00040 com.kt.olleh.storefront com.lguplus.appstore	MKT_ONE
Others	com.onestorecorp.gaa.storeapp com.dti.folderlauncher	MKT_GLB

SDK

SDK Version

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

• SDK V19.01 guides

• SDK V21.01 guides

ONE store Client Integration

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

Market Classification Code

• 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

  • v19 : https://onestore-dev.gitbook.io/dev/tools/tools/old-version/v19/undefined-3/classes/purchaseclient#purchaseclient-getstoreinfoasync

  • v21 : https://onestore-dev.gitbook.io/dev/tools/tools/v21/references/c-classes/c-purchaseclient#id-c-purchaseclient-getstoreinfoasync

Server API

Domain

• 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

Market Classification

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

curl --location '{global domain}/v7/apps/com.sample/purchases/inapp/products/{productId}/{purchaseToken}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {accessToken}' \
--header 'x-market-code: {marketCode]'\
 

Market Code	Service Country/Region
MKT_ONE	Korea
MKT_GLB	Others

PNS

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

3rd Party Payment

Server API

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

Settlement

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

Products

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