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后，在实际支付的情况下，开发者可以自由地取消购买。

区分

开发者

开发环境

商用环境

ONE store支付环境

Sandbox

商用环境 (实际支付)

支付窗口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