籌備全球發布

用語

• 國內ONE store：在韓國提供服務的ONE store

• 全球ONE store：在其他國家/地區提供服務的ONE store

ONE store服務架構

• 開發者只需在ONE store開發者中心註冊一次商品，就可以在韓國和全球出售商品。

  • 於現有的韓國ONE store註冊並出售商品的開發者，只需選擇全球發布即可。

  • ONE store開發者中心透過 Re-Packaging開發者註冊App，為全球服務生成APK，並將其發布給全球ONE store用户。

• ONE store用户端和伺服器分為韓國和全球。

  • 在App呼叫IAP SDK API時，將自動連動至服務國家/地區適配之One Store用户端/伺服器。

  • 開發公司伺服器中呼叫IAP Server API時，須傳送商店分類代碼（x-market-code）。

    

ONE store Installer Infomation & 商店分類代碼

分類	Installer Package Name	Market分類代碼
韓國	com.skt.skaf.A000Z00040 com.kt.olleh.storefront com.lguplus.appstore	MKT_ONE
全球	com.onestorecorp.gaa.storeapp com.dti.folderlauncher	MKT_GLB

SDK

SDK 版本

• 要進行全球發布，需適用ONE store In-App支付 SDK V19（API V6）以上的版本。

• 如果使用SDK V17，需要升级SDK。

• 如果使用SDK V16，應新註冊已是用SDK V21以上版本的App。

如屬於已套用檢測App健全性網路安全解决方案的App，需套用已修正網路安全解决方案不相容問題之SDK.

• SDK V21.01 guides

串接ONE store客户端

串接商城

• 在韓國的ONE store服務與其他國家/地區的ONE store服務App不同。

• 在韓國服務的App是韓國國內的ONE store，其他國家/地區的App服務需連動至全球ONE store。

• 原本於ONE store中V19以上App，可以直接在ONE store上進行全球發布，已發布之APP則會自動連動至全球ONE store。

Market分類代碼

• 如果使用者想了解下載的Marketplace資訊（韓國ONE store或全球ONE store），則必須獲得Market分類代碼。

• 已取得之Market分類代碼，必須在使用伺服器API時確認並傳送至header。

• 取得Market分類代碼的方法：

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

伺服器API

網域

• 在全球ONE store上進行的服務與在韓國ONE store上進行服務時的伺服器屬不同網域。

• 原僅於韓國ONE store上服務若要進行全球服務，需更改為含全球的網域。

  • 僅在韓國進行服務： ​https://apis.onestore.co.kr​

  • 於韓國以外國家/地區進行服務：https://iap-apis.onestore.net​

Market分類代碼

• Request header中已新增Market分類代碼（x-market-code）。

• 如果在全球範圍内提供服務，則必須提出需求Market分類代碼新增至header中。

• 如果没有Market分類代碼，會叫出ONE store(默認)。

<範例>

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分類代碼	服務國家/地區
MKT_ONE	韓國
MKT_GLB	除韓國外

PNS

• 國內ONE store和全球ONE store平台的傳送PNS訊息的地址不同。

• 因此，若使用防火牆，則需針對每個傳送的地址進行例外處理。

外部支付

伺服器API

• 外部支付API版本已更改為V6。

• 如果在除韓國外的國家/地區提供服務，則需要更改網域。

  • 僅於韓國提供服務：https://apis.onestore.co.kr

  • 於韓國以外國家/地區提供服務：https://iap-apis.onestore.net

• 外部支付時傳送購買明細API Request Body中已新增了國家/地區資訊與貨幣代碼。

• 使用支付付款傳送交易明細時，須傳送付款時幣別與金額。

• 外部付款購買記錄傳輸API已更新。（send3rdPartyPurchase-p1 ）

• 傳輸在美國產生的外部付款交易記錄時，必須以send3rdPartyPurchase-p1 格式傳輸交易記錄。

• 因現有格式不修改無法在美國以外國家/地區使用，預計2025年6月 deprecated，請適用新格式。

结算

• 註冊ONE store開發者中心時，必須根據已註冊的國為基準，進行手續費匯款。

  • 如果會員國是韓國，要用韓幣匯款。 （但美國銷售部分，需以美元匯至當地服務提供商指定的專用帳戶。）

  • 如果會員國是其他國家/地區，需用 USD 匯款。 （但美國銷售部分，需以美元匯至當地服務提供商指定的專用帳戶。）

• 手續費結算時的匯率，是銷售月下一個月的1日匯率。（以首爾外匯中介告示為准；如果1日遇假日，則以前一工作日的匯率為准）。

商品

• 全球ONE store不提供定期付費商品。

• 即使存在現有定期付費商品，也不會發布到全球ONE store。

• 發布國家/地區及當地價格設置、多國語言設置請參考 https://onestore-dev.gitbook.io/dev/v/eng/docs/apps