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