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