适用于 Web 应用的 IAP API


适用于 Web 应用的 IAP API

您可以向 Web 应用程序添加应用内购买 (IAP) 功能。Amazon Services 库为您的应用提供了一个简单 API,并管理与原生 IAP API 的交互。

API 概览

面向 Web 应用的应用内购买包含三个主要元素:

  • Amazon Services 库 - 一个 JavaScript 类,用于管理您的 Web 应用与亚马逊原生 IAP API 之间的交互。
  • 购买处理程序 - 您在 Web 应用中提供用于响应来自 Amazon Services 库的回调的方法。
  • Receipt Verification Service - 一项可用于验证客户购买收据的亚马逊服务。

执行以下任务以将您的应用与应用内购买 API 集成:

  • 向 Amazon Services 库注册购买处理程序。
  • 在您的应用中的适当位置调用 IAP API 方法。
  • 响应回调方法。

回调可以由您的应用触发,也可以异步调用,因此您的应用必须处理这两种情况。将您的应用的构造为无状态,并且不依赖于任何特定的执行状态。例如,您的应用的上一个会话可能已发出购买请求,但因应用关闭而没有传送。当应用重新启动并注册购买处理程序时,已排队的购买将被传递到新会话。

API 流程

以下列表详细列出了使用 Amazon Services 库的 Web 应用的流程。列表项编号对应于列表后面的图中的标注:

  1. 实现购买处理程序方法。
  2. 在 Amazon Services 库中注册您的购买处理程序。
  3. 应用启动应用内购买。
  4. 响应通知由您的购买处理程序方法处理。

    上面的步骤代表所需的最少步骤。我们建议您为实际实现执行以下附加步骤:

  5. 您的应用会保留收据。
  6. 您的应用将收据发送给您的应用服务器。
  7. 您的应用服务器将收据发送到亚马逊 RVS 进行验证,并收到响应。
  8. 您的应用服务器将响应发送到您的应用。
  9. 您的应用会保留结果。

Amazon Services 库

Amazon Services 库是应用内购买 API 不可或缺的部分。在您通过应用内购买 API 发起购买后,库将显示亚马逊品牌的用户界面来完成交易。

要在应用中包含 JS 库,请在 Web 应用的主 HTML 文件中添加以下 <script> 标签:

<script src="https://resources.amazonwebapps.com/v1/latest/Amazon-Web-App-API.min.js">
</script>

使用亚马逊应用内购买 API 的代码需要等待 amazonPlatformReady 事件,该事件由亚马逊 HTML5 框架生成。

document.addEventListener('amazonPlatformReady', function () {
    if(amzn_wa.IAP) {
        //此处放置 API 使用代码
    }
});

如果您的应用在用户未经亚马逊验证身份的情况下调用 IAP API,Amazon Services 库将验证用户身份。为确保良好的用户体验并确认用户已登录到亚马逊的服务,请在您的应用启动后立即检查权利。

库和亚马逊的服务为购买工作流程的所有方面显示用户界面。它们提供逻辑以显示可购买项目,执行一键式购买本身,并处理出现的任何前提条件或错误场景。

如果购买未成功,则客户端将向客户显示消息;您的应用不应向客户显示消息。例如,如果客户的存档中没有有效的信用卡,则库会将客户重定向到一个页面,他们可以在其中更新其付款信息。您无需向客户提供有关购买流程的确认或其他插播对话框。