适用于 Web 应用的 IAP API


适用于 Web 应用的 IAP API

使用亚马逊服务 JavaScript 将应用内购买添加到您的 Web 应用中。

API 结构

适用于 Web 应用的应用内购买包含三个元素:

  • 亚马逊服务 JavaScript - 管理 Web 应用和亚马逊的原生 API 之间的交互的类/API。
  • 购买处理程序 - Web 应用提供用于响应来自亚马逊服务 JavaScript 的回调的对象。它们作为观察器注册到亚马逊服务应用内购买 API。
  • Receipt Verification Service - 可用于验证客户的购买收据的 HTTP 服务。

与应用内购买 API 的集成包括向亚马逊服务 JavaScript 注册购买处理程序、调用 API 和响应回调。根据运行方式,回调可由您的应用的调用触发,也可异步调用,因此您的应用应能够处理这两种操作模式。由于回调随时可发生,您必须将应用构造为无状态,并且不依赖任何特定执行状态。例如,您的应用的上一个会话可能已发出购买请求,但因应用关闭而没有传送。当应用重新启动并注册其购买处理程序时,它将传送已排队的购买。

下图显示了使用亚马逊服务 JavaScript 的 Web 应用的 IAP 流程:

下面的列表对应于上图中的注解:

  1. 实施购买处理程序方法。
  2. 在亚马逊服务库中注册您的购买处理程序。
  3. 应用启动应用内购买。
  4. 响应通知由您的购买处理程序方法处理。

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

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

亚马逊服务 JavaScript

亚马逊服务 JavaScript 是应用内购买 API 不可或缺的部分。在您通过应用内购买 API 发起购买后,库将显示亚马逊品牌的用户界面来完成交易。此流程供所有选择使用应用内购买 API 的 Web 应用使用。

要包括该库,请向您的 Web 应用添加以下 <script> 标签:

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

在从亚马逊 HTML5 框架触发 amazonPlatformReady 事件后,必须使用任何使用亚马逊应用内购买 API 的代码。

document.addEventListener('amazonPlatformReady', function () {
    if(amzn_wa.IAP) {
        //API usage code goes here
    }
});

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

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

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