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