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
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
區分
API目錄
API URI
变更事项
V6 (SDK V19)
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