# 籌備全球發布

## 用語 <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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://onestore-dev.gitbook.io/dev/cht/glb.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.