IAP概述

开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅最新的发布说明。

应用内购买 (IAP) API允许您的应用在应用内呈现、处理和完成数字内容和订阅的购买。亚马逊支持适用于Vega应用的IAP API。本页简要介绍了IAP API以及预览版中可用的功能。

注意： Vega 0.24 SDK要求keplerscript-appstore-iap-lib2.13.0或更高版本，支持使用React Native 0.72或0.83构建的应用。早期发布的keplerscript-appstore-iap-lib（2.12.x及更早版本）不支持RN 0.83应用。

有关如何升级的更多详细信息，请参阅以下说明。

什么是应用内购买 (IAP)？

通过应用内购买 (IAP)，应用的用户可以在应用中购买各类数字商品，例如游戏中的额外生命或优质内容的订阅。

下面是一些可能会用到IAP的案例：

为您的应用创建“免费增值”模式，其中，应用本身是免费的，但对高级服务或功能收费。
允许您的客户购买商品来增强他们的游戏体验，例如货币、额外的移动次数或生命。
允许用户购买此内容的访问权，从而解锁奖励关卡或迷你游戏。
使客户能够订阅应用中提供的内容。

IAP API可处理有关购买流程、付款处理、应用收据和可购买内容管理权的详细信息。您不必亲自编写这些功能的代码。

提示： 如果您已安装Amazon Devices Builder Tools MCP服务器，则可向AI代理下达“帮我在Vega应用内集成IAP”命令，以获取有关应用内购买设置的Vega专属指南。

在应用中包含必要的程序包依赖项

在package.json文件中，添加@amazon-devices/keplerscript-appstore-iap-lib程序包作为依赖项。

已复制到剪贴板。

{
  "dependencies": {
    "@amazon-devices/keplerscript-appstore-iap-lib": "~2.13.0",
  }
},

Fire OS与Vega的IAP方法

API	描述	Fire OS对象 (Java)	Vega对象 (JS)	Vega与Fire OS是否有区别	具体区别
`getUserData`	发起检索当前登录用户的用户ID的请求。	`UserDataRequest` `UserDataResponse`	`UserDataRequest` `UserDataResponse`	否	不适用
`getProductData`	发起检索多达100个SKU的商品数据的请求。	作为`getProductData` API调用的一部分发送SKU列表。`ProductDataResponse`提供响应。	`ProductDataRequest` `ProductDataResponse`	是	1. 价格在Fire OS中是一个字符串，但在Vega中，它是一个对象，包含以微单位表示的`currencyFormattedPrice`、`currencyCode`、`promotionPrice`和`priceValue`。 2. `Promotion`对象内的`promotionPlans`字段在Vega中更改为`plans`。 3. `promotionPrice`、`promotionPriceCycles`、`promotionPricePeriod`更改为`price`、`priceCycles`和`period`。
`purchase`	发起产品的购买流程。	作为购买API调用的一部分发送单个SKU。`PurchaseResponse`提供响应。	`PurchaseRequest` `PurchaseResponse`	否	不适用
`getPurchaseUpdates`	发起请求以检索客户已购买或取消的商品的更新信息。请参阅此表末尾的“关于设备缓存的注意事项”。	作为getPurchaseUpdates API调用的一部分发送重置标记。`PurchaseUpdatesResponse`提供响应。	`PurchaseUpdatesRequest` `PurchaseUpdatesResponse`	否	不适用
`modifySubscription`	发起针对订阅的`modifySubscription`请求。	向modifySubscription API调用发送SKU和按比例分配模式。`ModifySubscriptionResponse`提供响应。	`ModifySubscriptionRequest` `ModifySubscriptionResponse`	否	不适用
`notifyFulfillment`	将有关购买履行的信息通知亚马逊。	在请求中发送`receiptId`和`FulfillmentResult`。它不会发送响应。这是一个无效的调用。	`NotifyFulfillmentRequest`	是	会发送`NotifyFulfillmentResponseCode`

关于设备缓存的注意事项

getPurchaseUpdates() 方法的行为取决于客户端（设备）缓存中的可用数据。客户在新设备上登录或清除当前设备的缓存后，第一次getPurchaseUpdates() 调用会返回所有收据，而不考虑reset的值。reset设置为false的后续调用仅返回自上次调用以来的最新收据。

某些场景（例如用户在其他设备上登录或用户重置设备）可能会清除客户端设备上的数据。这些场景会导致getPurchaseUpdates() 返回所有历史收据。您的应用必须能够识别新收据和旧收据并正确处理每个收据。

适用于Fire OS的IAP与适用于Vega的IAP

在Fire OS上，IAP SDK适用于用Java编写的Android应用。在Vega上，IAP API与用JavaScript编写的Vega SDK集成在一起。可以向亚马逊应用商店提交应用内商品以实现该API，用于生产功能（如动态应用测试）。

下表列出了Vega支持的当前IAP组件。

IAP组件	描述	文档
IAP API	用于运行和履行应用内购买的API	IAP API概述
App Tester	用于在本地测试应用的工具	配置App Tester
收据验证服务 (RVS) 云沙盒	在沙盒模式中验证交易收据的有效性	适用于IAP应用的RVS

Last updated: 2026年8月6日