> For the complete documentation index, see [llms.txt](https://onestore-dev.gitbook.io/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onestore-dev.gitbook.io/dev/cht/tools/billing/v21/releasenote.md).

# ONE store In-App支付發布说明

### ONE Billing Lab發售 <a href="#id09.onebillinglab-fa-shou" id="id09.onebillinglab-fa-shou"></a>

ONE Billing Lab作為研發工具，支援 ONE store In-App付款庫統一測試。

可通過大韓民國、新加坡、臺灣、美國各國家/地區的帳戶登錄進行付款測試，不需要為了付款測試安裝各國家/地區的所有商店App。

可以不使用實際付款系統，僅使用回應模擬程式功能測試付款流程。

可以在 ONE store App或GitHub下載 ONE Billing Lab。

* [在ONE store App安裝](https://onesto.re/0001002700)
* [在GitHub安裝](https://github.com/ONE-store/one_billing_lab)

{% hint style="info" %}
需要在 ONE store 研發者中心註冊付款測試ID才能進行測試。（Sandbox或在商用測）

ONE Billing Lab會員和 ONE store 會員一致。 可用原有帳戶在ONE Billing Lab註冊，在ONE Billing Lab進行加入/退出會員也按照 ONE store 會員加入程式。
{% endhint %}

### ONE store In-App支付SDK 21.01 發行

ONE store In-App支付（内部App支付）SDK 21.01 已經發行。

主要變更事項如下。

* 解決了與檢測App健全性的網絡安全解決方案不兼容的問題。&#x20;
* 解決了安裝有韓国One store App時，下载安裝全球One store App動線中發生的加載問題。&#x20;
* 提供在研發階段可以改變研發環境的設置。提供以下兩種設置，可以選擇國内One store和全球One store進行研發的環境。&#x20;

### **ONE store In-App支付library API V7(SDK V21)** 發**布** <a href="#onestoreinapp-zhi-fu-fa-bu-shuo-ming-onestoreinapp-zhi-fu-libraryapiv7sdkv21-fa-bu" id="onestoreinapp-zhi-fu-fa-bu-shuo-ming-onestoreinapp-zhi-fu-libraryapiv7sdkv21-fa-bu"></a>

ONE store In-App支付library API V7(SDK V21.00)現已發布，主要變更事項如下。 &#x20;

新商品必須應用ONE store In-App支付library API V7(SDK V21)。&#x20;

應用ONE store In-App支付API V5(SDK V17)以上的應用軟件可以遷移到API V7(SDK V21)。&#x20;

由於ONE store In-App支付API V4(SDK V16)的設計結構與之後的版本完全不同，因此無法遷移到ONE store In-App支付API V6(SDK V19)。&#x20;

#### 訂閱型商品 <a href="#onestoreinapp-zhi-fu-fa-bu-shuo-ming-ding-yue-xing-shang-pin" id="onestoreinapp-zhi-fu-fa-bu-shuo-ming-ding-yue-xing-shang-pin"></a>

代替SDK V19以下版本中使用的包月型商品而提供訂閱型商品。&#x20;

訂閱型商品不僅提供用戶在ONE store應用軟件内直接管理定期支付商品的多種功能，還為開發者提供各種功能，例如為新用戶流入的促銷活動、定期支付狀態變更的通知功能等。 \
&#x20;

### **ONE store In-App支付library API V6(SDK V19)** 發**布** <a href="#onestoreinapp-zhi-fu-fa-bu-shuo-ming-onestoreinapp-zhi-fu-libraryapiv6sdkv19-fa-bu" id="onestoreinapp-zhi-fu-fa-bu-shuo-ming-onestoreinapp-zhi-fu-libraryapiv6sdkv19-fa-bu"></a>

ONE store In-App支付library API V6(SDK V19.00)現已發布，主要變更事項如下。&#x20;

新商品必須應用ONE store In-App支付library API V6(SDK V19)。&#x20;

應用ONE store In-App支付API V5(SDK V17)的應用軟件可以遷移到API V6(SDK V19)。&#x20;

由於ONE store In-App支付API V4(SDK V16)的設計結構與之後的版本完全不同，因此無法遷移到ONE store In-App支付API V6(SDK V19)。&#x20;

<br>

#### 刪除ONE store In-App支付API版本 <a href="#onestoreinapp-zhi-fu-fa-bu-shuo-ming-shan-chu-onestoreinapp-zhi-fu-api-ban-ben" id="onestoreinapp-zhi-fu-fa-bu-shuo-ming-shan-chu-onestoreinapp-zhi-fu-api-ban-ben"></a>

現在，您無需在應用軟件的manifest中添加In-App API版本。&#x20;

In-App支付SDK V19將添加API Version meta-data。&#x20;

#### 確認購買 <a href="#onestoreinapp-zhi-fu-fa-bu-shuo-ming-que-ren-gou-mai" id="onestoreinapp-zhi-fu-fa-bu-shuo-ming-que-ren-gou-mai"></a>

如果軟件使用的是ONE store In-App支付library API  v6（SDK 19）以上版本，則必須在3天内進行購買確認。&#x20;

如果在3天内無法確認購買，將被認為item無法正常支付，並取消購買。&#x20;

可以使用以下method之一確認購買：&#x20;

* 對於消耗性產品，請使用PurchaseClient.consumeAsync()。&#x20;
* 非消耗性產品，請使用PurchaseClient.acknowledgeAsync()。&#x20;

對於包月型商品，只需確認首次支付的購買即可。

{% hint style="info" %}
如果應用了ONE store In-App API V6(SDK V19)，則必須在3天内進行購買確認。&#x20;

請注意，如果3天内未確認購買，購買將被取消。&#x20;
{% endhint %}

#### 獲取市場分類代碼 <a href="#onestoreinapp-zhi-fu-fa-bu-shuo-ming-huo-qu-shi-chang-fen-lei-dai-ma" id="onestoreinapp-zhi-fu-fa-bu-shuo-ming-huo-qu-shi-chang-fen-lei-dai-ma"></a>

從IAP library V6開始，為了使用Server to Server API，需要市場分類代碼。&#x20;

可以通過getStoreInfoAsync()獲取市場分類代碼。&#x20;

#### 變更PurchaseClient API <a href="#onestoreinapp-zhi-fu-fa-bu-shuo-ming-bian-geng-purchaseclientapi" id="onestoreinapp-zhi-fu-fa-bu-shuo-ming-bian-geng-purchaseclientapi"></a>

|                        | **V5 (SDK V17)**            | **V6(SDK V19)**             |
| ---------------------- | --------------------------- | --------------------------- |
| 與**支付模塊的連接**           | connect                     | startConnection             |
| **斷開與支付模塊的連接**         | terminate                   | endConnection               |
| 確認**是否支持**             | isBillingSupportedAsync     | X                           |
| 購買**In-App商品**         | launchPurchaseFlowAsync     | launchPurchaseFlow          |
| **使用In-App商品**         | consumeAsync                | consumeAsync                |
| **In-App商品購買確認**       | X                           | acknowledgeAsync            |
| **未使用商品的訂單（包括每月自動支付）** | queryPurchasesAsync         | queryPurchasesAsync         |
| **In-App商品詳情**         | queryProductsAsync          | queryProductDetailsAsync    |
| **更改每月自動支付狀態**         | manageRecurringProductAsync | manageRecurringProductAsync |
| **更新或安裝支付模塊**          | launchUpdateOrInstallFlow   | launchUpdateOrInstallFlow   |
| 調**用ONE store登錄**      | launchLoginFlowAsync        | launchLoginFlowAsync        |
| **確認市場分類代碼**           | X                           | getStoreInfoAsync           |

#### 變更Server API  <a href="#onestoreinapp-zhi-fu-fa-bu-shuo-ming-bian-geng-serverapi" id="onestoreinapp-zhi-fu-fa-bu-shuo-ming-bian-geng-serverapi"></a>

| 區**分** | **API目錄**             | **API URI**                                                               |                                                                                        | **变更事项**                                                                                                              |
| ------ | --------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
|        |                       | **V6 (SDK V19)**                                                          | **V6 (SDK V19)**                                                                       |                                                                                                                       |
| 變更     | 發放OAuth token         | /v2/oauth/token                                                           | /v6/oauth/token                                                                        | <p>在响应规格里删除status字段<br>使用Http response code检查是否正常(200)</p>                                                            |
| 刪除     | 購買商品詳情查詢              | /v2/purchase/details/{purchaseId}/{packageName}                           | N/A                                                                                    | <p>为加强安全性，删除购买商品详情查询API<br>整合为购买商品详情查询By In-App商品ID</p>                                                               |
| 變更     | 購買商品詳情查詢By In-App商品ID | /v2/purchase/details-by-productid /{purchaseId}/{packageName}/{productId} | /v6/apps/{packageName}/purchases/inapp/products /{productId}/{purchaseToken}           | 在响应规格里添加 purchaseId, acknowledgeState 字段                                                                              |
| 變更     | 包月型商品購買詳情查詢           | /v2/purchase/recurring-details/{purchaseId}/{packageName}                 | /v6/apps/{packageName}/purchases/auto/products /{productId}/{purchaseToken}            | <p>在响应规格里添加 acknowledgeState, lastPurchaseId, lastPurchaseState<br>在响应规格里删除price, developerPayload, purchaseState</p> |
| 刪除     | 包月型商品最後購買訂單詳情查詢       | /v2/purchase/last-recurring-details/{purchaseId}/{packageName}            | N/A                                                                                    | 整合为包月型商品购买详情查询API                                                                                                     |
| 變更     | 解除自動支付                | /v2/purchase/manage-payment-status/{purchaseId}/{packageName}/cancel      | /v6/apps/{packageName}/purchases/auto/products /{productId}/{purchaseToken}/cancel     | 变更成功处理响应规格                                                                                                            |
| 變更     | 取消解除自動支付              | /v2/purchase/manage-payment-status/{purchaseId}/{packageName}/reactivate  | /v6/apps/{packageName}/purchases/auto/products /{productId}/{purchaseToken}/reactivate | 变更成功处理响应规格                                                                                                            |
| 變更     | 取消購買訂單查詢              | /v2/purchase/voided-purchases/{packageName}                               | /v6/apps/{packageName}/voided-purchases                                                | <p>为了提高API的易用性，购买取消订单查询标准(startTime, endTime)从购买日变更为购买取消日<br>在响应规格添加 purchaseToken, marketCode</p>                    |
| 變更     | 使用購買商品                | /v2/purchase/consume/{purchaseId}/{packageName}                           | /v6/apps/{packageName}/purchases/all/products/ {productId}/{purchaseToken}/consume     | 变更成功处理响应规格                                                                                                            |
| 添加     | 購買確認                  | N/A                                                                       | /v6/apps/{packageName}/purchases/all/products/ {productId}/{purchaseToken}/acknowledge | 添加新的购买确认API                                                                                                           |

&#x20;\
&#x20;

#### 變更PNS消息規格  <a href="#onestoreinapp-zhi-fu-fa-bu-shuo-ming-bian-geng-pns-xiao-xi-gui-ge" id="onestoreinapp-zhi-fu-fa-bu-shuo-ming-bian-geng-pns-xiao-xi-gui-ge"></a>

* 為了支持韓幣以外的貨幣，支付金額（price）的數據類型從Number變更為String。&#x20;
* 為了支持韓幣以外的貨幣，增加了支付金額的貨幣代碼（priceCurrencyCode）。&#x20;
* 為了支持韓幣以外的貨幣，按支付方式分類的金額（amount）的數據類型Number改為String。&#x20;
* 在回應規格中添加了purchaseToken，environment和marketCode字段。&#x20;

詳細規格可在[PNS消息詳細變更歷史紀錄](/dev/cht/tools/billing/v21/pns.md)中查看。\
&#x20;

### **ONE store In-App支付 library API V5(SDK V17)**   <a href="#onestoreinapp-zhi-fu-fa-bu-shuo-ming-onestoreinapp-zhi-fu-libraryapiv5sdkv17" id="onestoreinapp-zhi-fu-fa-bu-shuo-ming-onestoreinapp-zhi-fu-libraryapiv5sdkv17"></a>

* API版本必須在開發公司應用軟件的"AndroidManifest.xml"文件中如下注明。&#x20;

* 有關更多資訊，請參見應用In-App支付的前期準備頁上的"Android Manifest文件設置"部分。&#x20;

* API V5（SDK V17）中的改進包括:&#x20;

<table data-header-hidden><thead><tr><th width="145.33333333333331">項目</th><th> 詳細改進項目</th><th>說明</th></tr></thead><tbody><tr><td><strong>API</strong></td><td>引入Consume概念</td><td>發生未發放item情况時，提供從應用軟件中恢復的邏輯。</td></tr><tr><td></td><td>支持Custom PID</td><td>開發者可以直接輸入In-App商品ID(PID)，通過直觀的PID創建和操作。</td></tr><tr><td></td><td>提供通用的In-App支付interface</td><td>以其他市場為方向開發的應用軟件，無需在編碼投入開發時間，即可向ONE store方向啟動。</td></tr><tr><td><strong>支付測試環境</strong></td><td>分别提供開發環境和商用環境</td><td><p>提供與開發公司的驗證環境相同水平的ONE store支付環境。<br>在開發公司的開發環境中，可以與ONE store Sandbox聯合開發/測試，在開發公司的商用環境中，可以在ONE store商用環境中進行實際支付。<br>在ONE store開發者中心以測試ID註冊的ID登錄到ONE store後，在實際支付的情况下，開發者可以自由地取消購買。</p><table data-header-hidden><thead><tr><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td>區分</td><td><br></td><td>開發者</td><td><br></td></tr><tr><td><br></td><td><br></td><td><strong>開發環境</strong></td><td><strong>商用環境</strong></td></tr><tr><td>ONE store支付環境</td><td><strong>Sandbox</strong></td><td>O</td><td>-</td></tr><tr><td><br></td><td><strong>商用環境 (實際支付)</strong></td><td>-</td><td>O</td></tr></tbody></table></td></tr><tr><td><strong>支付窗口UI</strong></td><td>可選擇全屏支付和彈窗支付界面</td><td>您可以選擇全屏支付或彈窗支付（彈窗支付指南）。<br>支付界面設置請參考應用In-App支付的前期準備页的"Android Manifest文件設置"部分。</td></tr><tr><td><strong>連動方式</strong></td><td>可選擇IAP SDK, AIDL</td><td>除了傳統的SDK方法，您還可以使用AIDL直接與OSS進行聯動。<br>但是，在沒有安裝ONE store service（OSS）應用軟件的智能手機上，In-App支付不能正常工作。<br>有關安裝ONE store service應用軟件的内容，請參考應用In-App支付的前期準備頁上的"ONE store應用軟件安裝"部分。</td></tr><tr><td><p></p><p><strong>開發者中心</strong></p></td><td>改進其他應用市場應用軟件商品資訊抓取功能</td><td><p>您可以輕鬆地將已註冊的其他用市場的應用軟件商品註冊到ONE store。</p><p><br></p></td></tr><tr><td></td><td>提供其他應用市場In-App商品資訊導入功能</td><td></td></tr><tr><td><strong>認證中心</strong></td><td>OAuth發放/認證/管理</td><td>加強開發者伺服器與ONE store In-App支付伺服器聯動時的數據安全性。</td></tr></tbody></table>