# 籌備全球發布

## 用語 <a href="#yong-ci" id="yong-ci"></a>

* 國內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）。<br>

    <figure><img src="https://750271784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcs8LWlkAbJnzCUmymYwc%2Fuploads%2Ftfhjr7rMzQOAQtLsXK8N%2F1.jpeg?alt=media&#x26;token=cb6d6df3-3d7e-490b-9928-2c13491dad55" alt=""><figcaption></figcaption></figure>

### ONE store Installer Infomation & 商店分類代碼 <a href="#id" id="id"></a>

<table><thead><tr><th width="167.33333333333331">分類</th><th width="367">Installer Package Name</th><th>Market分類代碼</th></tr></thead><tbody><tr><td>韓國</td><td><ul><li>com.skt.skaf.A000Z00040</li><li>com.kt.olleh.storefront</li><li>com.lguplus.appstore</li></ul></td><td>MKT_ONE</td></tr><tr><td>全球</td><td><ul><li>com.onestorecorp.gaa.storeapp</li><li>com.dti.folderlauncher</li></ul></td><td>MKT_GLB</td></tr></tbody></table>

## SDK <a href="#j96wnt4u8tpp" id="j96wnt4u8tpp"></a>

### **SDK 版本**

* 要進行全球發布，需適用ONE store In-App支付 SDK V19（API V6）以上的版本。
* 如果使用SDK V17，需要升级SDK。
* 如果使用SDK V16，應新註冊已是用SDK V21以上版本的App。

{% hint style="warning" %}
如屬於已套用檢測App健全性網路安全解决方案的App，需套用已修正網路安全解决方案不相容問題之SDK. &#x20;

* [SDK V21.01 guides ](https://onestore-dev.gitbook.io/dev/cht/tools/billing/v21/sdk#fa-hang-quan-qiu-store-de-ce-shi-xuan-xiang-she-zhi)&#x20;
  {% endhint %}

### 串接ONE store客户端

<figure><img src="https://750271784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcs8LWlkAbJnzCUmymYwc%2Fuploads%2FyT4cDo4KtMyEwrvUVffR%2F2.jpeg?alt=media&#x26;token=00c9ce46-00f5-48f9-aaf1-a62e80a0584b" alt=""><figcaption></figcaption></figure>

### **串接商城**

* 在韓國的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)​<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)​<https://onestore-dev.gitbook.io/dev/tools/tools/v21/references/c-classes/c-purchaseclient#id-c-purchaseclient-getstoreinfoasync>​

## 伺服器API <a href="#lano6quwcxhd" id="lano6quwcxhd"></a>

<figure><img src="https://750271784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcs8LWlkAbJnzCUmymYwc%2Fuploads%2F3K34rD4C4p517vSFqPmb%2F3.jpeg?alt=media&#x26;token=0b949ec1-13f3-4550-adb5-27063bb3be99" alt=""><figcaption></figcaption></figure>

### **網域**

* 在全球ONE store上進行的服務與在韓國ONE store上進行服務時的伺服器屬不同網域。
* 原僅於韓國ONE store上服務若要進行全球服務，需更改為含全球的網域。
  * 僅在韓國進行服務：[ ](https://apis.onestore.co.kr/)​[https://apis.onestore.co.kr](https://apis.onestore.co.kr/)​
  * 於韓國以外國家/地區進行服務：[https://iap-apis.onestore.net](https://iap-apis.onestore.net/)​

### Market分類代碼

* Request header中已新增Market分類代碼（x-market-code）。
* 如果在全球範圍内提供服務，則必須提出需求Market分類代碼新增至header中。
* 如果没有Market分類代碼，會叫出ONE store(默認)。

<範例>

{% code overflow="wrap" %}

```
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}' \
```

{% endcode %}

| Market分類代碼 | 服務國家/地區 |
| ---------- | ------- |
| MKT\_ONE   | 韓國      |
| MKT\_GLB   | 除韓國外    |

### PNS

* 國內ONE store和全球ONE store平台的傳送PNS訊息的地址不同。
* 因此，若使用防火牆，則需針對每個傳送的地址進行例外處理。

## 外部支付 <a href="#sj47hdt4vcvw" id="sj47hdt4vcvw"></a>

### 伺服器API <a href="#vo0jistmosx4" id="vo0jistmosx4"></a>

* 外部支付API版本已更改為V6。
* 如果在除韓國外的國家/地區提供服務，則需要更改網域。
  * 僅於韓國提供服務：<https://apis.onestore.co.kr>
  * 於韓國以外國家/地區提供服務：[https://iap-apis.onestore.net](https://iap-apis.onestore.net/)
* 外部支付時傳送購買明細API Request Body中已新增了國家/地區資訊與貨幣代碼。
* 使用支付付款傳送交易明細時，須傳送付款時幣別與金額。
* 外部付款購買記錄傳輸API已更新。（send3rdPartyPurchase-p1 ）
* 傳輸在美國產生的外部付款交易記錄時，必須以send3rdPartyPurchase-p1 格式傳輸交易記錄。
* 因現有格式不修改無法在美國以外國家/地區使用，預計2025年6月 deprecated，請適用新格式。

### 结算

* 註冊ONE store開發者中心時，必須根據已註冊的國為基準，進行手續費匯款。
  * 如果會員國是韓國，要用韓幣匯款。\
    （但美國銷售部分，需以美元匯至當地服務提供商指定的專用帳戶。）
  * 如果會員國是其他國家/地區，需用 USD 匯款。\
    （但美國銷售部分，需以美元匯至當地服務提供商指定的專用帳戶。）
* 手續費結算時的匯率，是銷售月下一個月的1日匯率。（以首爾外匯中介告示為准；如果1日遇假日，則以前一工作日的匯率為准）。

## 商品 <a href="#id-8lfn5bq1c1b2" id="id-8lfn5bq1c1b2"></a>

* 新加坡和台湾不提供订阅产品。
* 即使之前已注册订阅产品，该产品也不会在新加坡和台湾发布。
* 發布國家/地區及當地價格設置、多國語言設置請參考\
  <https://onestore-dev.gitbook.io/dev/v/eng/docs/apps>