ONE store In-App支付概要

ONE store In-App支付是什么？

One store的In-App支付(In-App Purchase, IAP)是一种利用One store认证和支付系统，向用户销售android应用程序内商品，并向开发者付费的服务。

In-App商品支付需要与One store服务(ONE store service, OSS) 应用软件进行联动，One store服务应用软件与One store支付服务器联合执行In-App商品的支付。

为了使用One store的In-App支付，需要应用"One store IAP SDK(In-App Purchase Software Development Kit)"。

In-App商品的类型

One store In-App支付API V7（SDK V21）提供管理型商品和订阅型商品两种类型的In-App商品。首先，请您确认每个类型都具有哪些特性，然后尝试构建符合您所提供的App商品的In-App商品目录。

区分	内容
管理型商品	在购买后消费(consume)之前不会再购买的App商品。要想重新购买该App商品，需要进行消费(consume)处理。利用管理型商品的特性，可提供消费性/永久性/固定期限类型的In-App商品。
包月型商品 (Deprecated)	一旦加入，每月自动支付一定金额的App商品，自动支付更新（再支付）由One store处理。应用SDK V21 (API V7)后，无法创建新的包月型商品。(现有包月型商品可继续使用。) 可使用订阅型商品提供定期支付商品。
订阅型商品	从SDK V21(API V7)开始提供的定期支付商品类型。按照规定的周期在One store进行定期支付，为吸引新客户提供促销功能及变更支付手段等用户便利功能。订阅型商品的详细内容请参考适用定期支付的页面。

区分

内容

管理型商品

在购买后消费(consume)之前不会再购买的App商品。要想重新购买该App商品，需要进行消费(consume)处理。利用管理型商品的特性，可提供消费性/永久性/固定期限类型的In-App商品。

包月型商品 (Deprecated)

一旦加入，每月自动支付一定金额的App商品，自动支付更新（再支付）由One store处理。应用SDK V21 (API V7)后，无法创建新的包月型商品。(现有包月型商品可继续使用。) 可使用订阅型商品提供定期支付商品。

订阅型商品

从SDK V21(API V7)开始提供的定期支付商品类型。按照规定的周期在One store进行定期支付，为吸引新客户提供促销功能及变更支付手段等用户便利功能。订阅型商品的详细内容请参考适用定期支付的页面。

支付流程

One store In-App支付大致由以下四个流程组成。

One store会员登录

为了使用One store In-App支付服务，必须已经注册成One store会员并处于登录的状态。如果收到与登录失败相关的错误代码(RESULT_NEED_LOGIN)，请调用登录过程以便登录到One store，或者引导客户运行One store应用软件登录。

引导用户运行One store应用软件登录

利用dialog等，将"您需要登录One store会员"传递给用户。该方法为用户提供简单的指南，并引导用户直接运行One store应用软件。

使用launchLoginFlowAsync调用登录流程

开发公司将使用launchLoginFlowAsync API来调用登录画面。用户完成登录后，可以通过IapResultLIstener（在调用API时将其放入parameter中）传递结果值。如果在验证结果代码值后确认为成功，之后就可以使用One store In-App支付SDK的API。下图显示了开发公司应用软件和One store之间的登录流程。

请求购买In-App商品

如果想要购买App商品，请先调用商品详细信息(queryProductDetailAsync) API，然后拿着收集到的商品信息，通过launchPurchaseFlow API调用购买页面。支付完成后，您可以通过在初始化PurchaseClient对象时输入的PurchasesUpdatedListener获得购买信息。验证结果代码值后，如果确认成功，之后进行发放相当于In-App商品的item的流程。下图是购买开发公司应用软件和One store之间In-App商品的流程。

确认购买In-App商品

使用One store IAP library V6以上版本，需要3天内确认购买。如果没有确认购买，购买金额将退还给客户。使用以下两种方法可以确认购买。

消费 (consume)
- 管理型商品的特征是，在购买后消费（consume）前不能再购买。因此，提供管理型商品中可重复购买的消费性商品时，必须使用PurchaseClient.consumeAsync（）进行消费处理后，客户才能重新购买该商品。
- 安装启动消费性类型的商品时，需要在购买流程完成后立即消费掉购买的商品，并在消费完成后发放item。
- 建议用户在运行应用软件（游戏）时或登录应用软件（游戏）时调用上述API，事先确认是否存在未支付的App商品，并添加支付App商品的流程。

确认购买商品 (acknowledge)
- 不是消费性商品时，请使用PurchaseClient.acknowledgeAsync（）。可以不进行消费处理，仅通过购买确认的方法实现永久性商品。
- 安装启动永久性类型商品时，需进行确认购买（acknowledge）而不是消费。
- 订阅类商品也需要确认购买，仅需对首次支付进行确认购买即可。