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