ONE store In-App支付發布说明

ONE store In-App支付SDK 21.01 發行

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

主要變更事項如下。

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

ONE store In-App支付library API V7(SDK V21) 發布

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

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

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

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

訂閱型商品

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

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

ONE store In-App支付library API V6(SDK V19) 發布

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

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

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

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

刪除ONE store In-App支付API版本

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

In-App支付SDK V19將添加API Version meta-data。

確認購買

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

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

可以使用以下method之一確認購買：

對於消耗性產品，請使用PurchaseClient.consumeAsync()。
非消耗性產品，請使用PurchaseClient.acknowledgeAsync()。

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

如果應用了ONE store In-App API V6(SDK V19)，則必須在3天内進行購買確認。

請注意，如果3天内未確認購買，購買將被取消。

獲取市場分類代碼

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

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

變更PurchaseClient API

V5 (SDK V17)

V6(SDK V19)

與支付模塊的連接

connect

startConnection

斷開與支付模塊的連接

terminate

endConnection

確認是否支持

isBillingSupportedAsync

購買In-App商品

launchPurchaseFlowAsync

launchPurchaseFlow

使用In-App商品

consumeAsync

In-App商品購買確認

acknowledgeAsync

未使用商品的訂單（包括每月自動支付）

queryPurchasesAsync

In-App商品詳情

queryProductsAsync

queryProductDetailsAsync

更改每月自動支付狀態

manageRecurringProductAsync

更新或安裝支付模塊

launchUpdateOrInstallFlow

調用ONE store登錄

launchLoginFlowAsync

確認市場分類代碼

getStoreInfoAsync

變更Server API

區分

API目錄

API URI

变更事项

V6 (SDK V19)

變更

發放OAuth token

/v2/oauth/token

/v6/oauth/token

在响应规格里删除status字段使用Http response code检查是否正常(200)

刪除

購買商品詳情查詢

/v2/purchase/details/{purchaseId}/{packageName}

N/A

为加强安全性，删除购买商品详情查询API 整合为购买商品详情查询By In-App商品ID

變更

購買商品詳情查詢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}

在响应规格里添加 acknowledgeState, lastPurchaseId, lastPurchaseState 在响应规格里删除price, developerPayload, purchaseState

刪除

包月型商品最後購買訂單詳情查詢

/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

为了提高API的易用性，购买取消订单查询标准(startTime, endTime)从购买日变更为购买取消日在响应规格添加 purchaseToken, marketCode

變更

使用購買商品

/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

變更PNS消息規格

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

詳細規格可在PNS消息詳細變更歷史紀錄中查看。

ONE store In-App支付 library API V5(SDK V17)

API版本必須在開發公司應用軟件的"AndroidManifest.xml"文件中如下注明。
有關更多資訊，請參見應用In-App支付的前期準備頁上的"Android Manifest文件設置"部分。
API V5（SDK V17）中的改進包括:

API

引入Consume概念

發生未發放item情况時，提供從應用軟件中恢復的邏輯。

支持Custom PID

開發者可以直接輸入In-App商品ID(PID)，通過直觀的PID創建和操作。

提供通用的In-App支付interface

以其他市場為方向開發的應用軟件，無需在編碼投入開發時間，即可向ONE store方向啟動。

支付測試環境

分别提供開發環境和商用環境

提供與開發公司的驗證環境相同水平的ONE store支付環境。在開發公司的開發環境中，可以與ONE store Sandbox聯合開發/測試，在開發公司的商用環境中，可以在ONE store商用環境中進行實際支付。在ONE store開發者中心以測試ID註冊的ID登錄到ONE store後，在實際支付的情况下，開發者可以自由地取消購買。

支付窗口UI

可選擇全屏支付和彈窗支付界面

您可以選擇全屏支付或彈窗支付（彈窗支付指南）。支付界面設置請參考應用In-App支付的前期準備页的"Android Manifest文件設置"部分。

連動方式

可選擇IAP SDK, AIDL

除了傳統的SDK方法，您還可以使用AIDL直接與OSS進行聯動。但是，在沒有安裝ONE store service（OSS）應用軟件的智能手機上，In-App支付不能正常工作。有關安裝ONE store service應用軟件的内容，請參考應用In-App支付的前期準備頁上的"ONE store應用軟件安裝"部分。

開發者中心

改進其他應用市場應用軟件商品資訊抓取功能

您可以輕鬆地將已註冊的其他用市場的應用軟件商品註冊到ONE store。

提供其他應用市場In-App商品資訊導入功能

認證中心

OAuth發放/認證/管理

加強開發者伺服器與ONE store In-App支付伺服器聯動時的數據安全性。

Last updated 25 days ago