设置快速订阅

重要须知： 目前，快速订阅仅面向部分合作伙伴开放。

如需查看快速订阅的概述，请参阅快速订阅概述。当您准备好开始操作时，请联系您的亚马逊代表，让他们在您的账户上启用“快速订阅”。然后，按照本页面上的步骤进行操作。

先决条件
步骤1：在开发者控制台中配置快速订阅
步骤2：配置安全配置文件
步骤3：实现getPurchaseUpdates
步骤4：集成收据验证服务 (RVS)
步骤5：将履行结果发送给亚马逊
步骤6：集成实时通知 (RTN)
步骤7：集成一键账户信息共享功能
步骤8：使用LAT测试快速订阅
相关主题

先决条件

快速订阅是亚马逊应用商店应用内购买 (IAP) API中包含的一项功能。

在设置快速订阅之前，必须完成以下操作：

与Appstore SDK版本3.0.6或更高版本集成。有关详细信息，请参阅集成Appstore SDK。
拥有有效的应用内商品。

注意事项

在开始之前，请查看以下注意事项和建议：

优化应用的大小，以缩短下载和安装时间。

通常建议将应用的大小最小化到50MB或更小。减小应用大小可让更多用户安装应用，从而提升可用性，并减少安装和初始使用所需的时间。此外，由于存储空间限制，较小的应用被卸载的可能性也更低。
通过快速订阅提供的优惠最适合付费订阅。

快速订阅支持提供免费试用的应用。但是，如果应用使用“免费增值”模式进行获取，则快速订阅可能不是最适合应用的方式。在免费增值模式中，应用本身免费，用户无需付费订阅即可访问一组基本的内容和服务，但是要访问更多内容或高级功能，就需要支付额外费用。
通过快速订阅进行的购买发生在您的应用之外。

在没有采用快速订阅的标准IAP流程中，客户会登录您的应用，然后在应用内进行购买。但是，采用快速订阅后，客户首先在应用之外进行购买，然后应用会自动打开并让客户登录。

因此，快速订阅的实现与标准IAP的实现有所不同。如果在集成快速订阅方面需要帮助，请按照本页面上的步骤操作。

重要须知

不要提供任何只能通过快速订阅购买的订阅。通过快速订阅提供的订阅SKU必须与已在应用内提供的订阅SKU相同。但是，由于快速订阅最多只能提供四个商品，因此如果您在应用内提供了五个或更多订阅，则必须从中选择四个来通过快速订阅提供。

为应用配置快速订阅

前往开发者控制台主信息页面并登录您的账户。
选择应用与服务 > 我的应用程序，然后选择您的应用。
在应用内商品列中，单击链接打开“应用内商品”屏幕。
选择创建快速订阅。
随即出现一个叠加弹出窗口，如下图所示。
“创建新的快速订阅”对话框

选择默认订阅下拉列表中列出了现有IAP订阅。选择要启用快速订阅的订阅。
在选择期限下拉列表中，选择快速订阅的期限。
如果要为快速订阅提供其他订阅，请选择添加其他快速订阅。
重要须知： 您最多可以添加四个快速订阅。
勾选相应的复选框，选择快速订阅的目标设备。
选择是仅为动态应用测试 (LAT) 创建快速订阅，还是同时为LAT和上线应用创建快速订阅。
- 要仅为LAT创建快速订阅，请选择为测试创建快速订阅。
- 要为LAT和上线应用创建快速订阅，请选择为测试和上线创建快速订阅。
注意： 有关LAT和如何使用LAT测试快速订阅的更多详细信息，请参阅使用LAT测试快速订阅。

创建了快速订阅后，可以选择快速订阅商品对应的操作，删除或修改创建的快速订阅。

步骤2：配置安全配置文件

为了让快速订阅正常运行，必须为应用设置安全配置文件。安全配置文件必不可少，因为它让亚马逊能够安全地与您共享客户数据，还能让您自动创建账户并登录用户。

安全配置文件将亚马逊数据（包括安全凭证）与一个或多个应用相关联。例如，如果您有两个应用（如“我的游戏 - 免费”和“我的游戏 - 高清”），那么这两个应用可以通过使用相同的安全配置文件来共享数据。命名安全配置文件时，请采用有助于识别您的应用或应用系列的方式。有关更多详细信息，请参阅安全配置文件。

警告： 确保将正确的安全配置文件附加到您的应用。将安全配置文件附加到应用后，您将无法通过开发者控制台对其进行更改。如果您需要更新附加到应用的安全配置文件，则必须联系亚马逊代表。

为应用配置安全配置文件

前往开发者控制台主信息页面并登录您的账户。
选择应用与服务 > 我的应用程序，然后选择您的应用。
选择应用服务，然后滚动到安全配置文件部分。
单击选择现有安全配置文件或新建以展开相关选项。
通过下拉列表选择要映射到该应用的安全配置文件，然后单击启用安全配置文件。或者，也可通过单击创建安全配置文件来创建新的安全配置文件。

步骤3：实现getPurchaseUpdates

重要须知： 要正确实现快速订阅，您必须在onResume() 方法中调用getPurchaseUpdates()。

getPurchaseUpdates() 方法会检索客户的收据。当客户通过快速订阅进行购买时，购买发生在应用之外。因此，快速订阅要求您的应用调用getPurchaseUpdates() 来验证客户的购买状态。此项调用可确保客户在应用打开后收到所购买的内容。如果您未能正确实现getPurchaseUpdates()，可能会导致客户无法访问其所购买的内容。

在onResume() 方法中调用getPurchaseUpdates()。getPurchaseUpdates() 方法使用一个布尔参数：reset。将reset设置为false，可仅返回自上次调用此方法之后生成的新收据。将reset设置为true可返回此用户的所有收据。

关于设备缓存的注意事项

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

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

以下代码展示了如何调用getPurchaseUpdates() 方法。

@Override
protected void onResume() {
  super.onResume();

//...

  PurchasingService.getUserData();

//...

  PurchasingService.getPurchaseUpdates(false);
}

有关如何集成getPurchaseUpdates() 方法的更多信息，请参阅IAP API文档实施getPurchaseUpdates方法。

实现要求

请按照以下要求来正确实现getPurchaseUpdates() 方法。

必须在Android活动的onResume() 生命周期方法中调用getPurchaseUpdates()。
在onResume() 中调用getPurchaseUpdates()时，为了仅获取最新数据，请务必使用false标记。如果使用true标记，它将返回收据的完整历史记录，并且您必须添加额外的筛选逻辑来处理响应。
在您的应用中添加“Restore Purchases”（恢复购买）选项，当客户选择该选项时，该选项会使用true标记调用getPurchaseUpdates()。
务必持久存储通过getPurchaseUpdates() 收到的收据，并且必须将该收据映射到应用的登录ID。使用此映射在客户打开应用时解锁其订阅的内容。

步骤4：集成RVS

使用收据验证服务 (RVS)，可以验证您应用的用户进行的购买。有关RVS的详细信息，请参阅适用于Appstore SDK IAP的收据验证服务。向RVS服务器发出请求后，返回的JSON响应包含一个purchaseMetadataMap字段。如果使用快速订阅发起了购买，则purchaseMetadataMap会显示为{"QuickSubscribe":"true"}，如下例所示。

{
  "autoRenewing": true,
  "betaProduct": false,
  "binCountryCode": null,
  "cancelDate": 1641131573000,
  "cancelReason": 2,
  "countryCode": "US",
  "deferredDate": null,
  "deferredSku": null,
  "freeTrialEndDate": null,
  "fulfillmentDate": 1641131345000,
  "fulfillmentResult": "FULFILLED",
  "gracePeriodEndDate": null,
  "parentProductId": null,
  "productId": "IntroFreeTrial.sku",
  "productType": "SUBSCRIPTION",
  "promotions": null,
  "purchaseDate": 1641131345000,
  "purchaseMetadataMap": {
      "QuickSubscribe": "true"
  },
  "quantity": null,
  "receiptId": "k9om1rUS7gZJIg8RMfw7AlbxA3aP56ay-vdgeLU40zw=:3:11",
  "renewalDate": null,
  "term": "1个月",
  "termSku": null,
  "testTransaction": false
}

如果没有使用快速订阅发起购买，则purchaseMetadataMap会显示为null。下表提供了响应对象中所有字段的说明。

字段	数据类型	描述
`autoRenewing`	布尔值	表示客户的订阅是否会自动续订。
`betaProduct`	布尔值	指示所购买的产品是否是动态应用测试产品。
`cancelDate`	长整数	取消购买的日期，或订阅到期的日期。如果购买未取消，则此字段为null。时间以毫秒为单位。
`cancelReason`	整数	指示取消产品的原因。可能的值为null、0、1或2，其中每个整数分别代表一项取消原因： `null` - 购买未取消。 `0` - 当前无法提供取消原因，将在之后提供。 `1` - 客户取消了订单。 `2` - 亚马逊系统取消了购买。例如，客户用于购买订阅的付款无效，并且无法在宽限期内完成购买。如果亚马逊客户支持部门应客户要求取消订单，也会返回此代码。
`countryCode`	字符串	指示亚马逊记录中列出的用户居住的国家/地区。
`freeTrialEndDate`	长整数	表示订阅处于免费试用期内。提供订阅免费试用的结束日期，以epoch（毫秒）为单位。如果订阅不在免费试用期内，则此字段为null。
`fulfillmentDate`	长整数	在订阅购买中，为确认履行的日期。以纪元以后的毫秒数存储。如果未确认订阅履行，则为null。消费品和权利始终为null。
`fulfillmentResult`	字符串	在订阅购买中，履行的状态。有效值： `FULFILLED`：您提供了内容，并且客户使用了内容。 `UNAVAILABLE`：您无法向客户提供内容。如果未确认订阅履行，则为null。消费品和权利始终为null。
`gracePeriodEndDate`	长整数	表示订阅处于宽限期内。提供订阅宽限期的结束日期，以epoch（毫秒）为单位。如果订阅不在宽限期内，则此字段为null。
`parentProductId`	字符串	Null。预留以供将来使用。
`productId`	字符串	您在应用中为此商品定义的SKU。
`productType`	字符串	所购买产品的类型。有效产品类型为`CONSUMABLE`、`SUBSCRIPTION`和`ENTITLED`。
`promotions`	List<Promotion>	订阅购买的促销定价或留存优惠的详细信息。如果没有促销，则为Null。请参阅RVS中的促销。
`purchaseDate`	长整数	购买日期，以纪元以后的毫秒数存储。对于订阅商品，`purchaseDate`代表首次购买日期，而不是后续续订的购买日期。
`purchaseMetadataMap`	Map <String, String>	如果购买是通过快速订阅发起的，则值为 `{"QuickSubscribe":"true"}`。否则为null。
`quantity`	整数	购买的数量。始终为null或1。
`receiptId`	字符串	购买的全局唯一标识符。
`renewalDate`	长整数	需要续订订阅购买的日期。日期以纪元以后的毫秒数存储。
`term`	字符串	订阅IAP将保持有效的持续时间（期限从购买之日开始）。期限由数字和时间段（天、周、月、年）构成，如1周或2个月。
`termSku`	字符串	对应于订阅期的唯一SKU。
`testTransaction`	布尔值	表明此购买是否作为亚马逊发布和测试过程的一部分进行。

步骤5：将履行结果发送给亚马逊

重要须知： 要正确实现快速订阅，必须向亚马逊发送履行结果。

当您发送履行结果时，请确保亚马逊可以确认用户是否可以访问其付费购买的内容。务必将履行结果传达给亚马逊。为此，请使用Appstore SDK中包含的notifyFulfillment() 方法。如果您不发送履行结果，亚马逊会自动取消订阅，以确保客户不会继续为未履行的订阅付费。

客户登录后，在履行订阅后使用状态FULFILLED调用notifyFulfillment()。如果客户已经拥有并非通过亚马逊购买的订阅，则使用状态UNAVAILABLE调用notifyFulfillment()，表明客户已登录但购买不适用。有关notifyFulfillment() 方法的更多信息，请参阅将履行结果发送给亚马逊并向用户授予商品。

如果之前已集成确认收据API，则可以继续使用它来代替notifyFulfillment() 方法。必须在应用中使用notifyFulfillment() 方法或确认收据API来将履行结果传达给亚马逊。

实现要求

请按照以下要求来正确实现notifyFulfillment() 方法。

要将履行状态传达给亚马逊，每次处理来自PurchaseUpdatesResponse对象的收据时，都必须调用notifyFulfillment()。
调用notifyFulfillment() 时：
- 满足以下条件时发送FULFILLED：
  - 您成功将客户映射到收据并为该客户解锁订阅内容。
- 出现以下任一情况时发送UNAVAILABLE：
  - 您确定客户的现有订阅不是通过亚马逊购买的。
  - 客户没有资格针对您的服务注册账户。

自动取消

亚马逊使用自动取消来确保客户不会继续为未履行的订阅付款。如果您未在购买后的14天内使用notifyFulfillment() 或确认收据API将购买收据更新为FULFILLED状态，则亚马逊应用商店会自动取消订阅并退款。

确认收据API

注意： 如果这是您首次为应用添加快速订阅，请使用包含在Appstore SDK中的首选notifyFulfillment() 方法，而不是确认收据API。如果已经集成了确认收据API，则可以继续使用它。

确认收据API使用acknowledgeReceipt操作，可以通知亚马逊订阅购买已履行，这样客户就不会失去访问权限。

acknowledgeReceipt操作是一个REST API，很像RVS中使用的verifyReceiptId操作，但您必须使用PUT请求，而非GET请求。

PUT https://appstore-sdk.amazon.com/version/1.0/acknowledgeReceipt?developer={shared-secret}&user={user-id}=&receiptId={receipt-id}&fulfillmentResult={fulfillment-result}

acknowledgeReceipt操作的版本号为1.0。有关查询参数的更多详细信息，请查阅下表。

查询参数

确认收据API响应使用以下查询参数。

查询参数	描述	必填
`developer`	用于标识发出请求的开发者的共享密钥。您可以在亚马逊应用商店开发者账户的共享密钥页面上找到您的共享密钥。	是
`user`	代表亚马逊应用商店应用中不同亚马逊客户的ID： `PurchaseResponse.getUserData().getUserId()`。	是
`receiptId`	购买的唯一ID： `PurchaseResponse.getReceipt().getReceiptId()` 或`PurchaseUpdatesResponse.getReceipts()` → `Receipt.getReceiptId()`。	是
`fulfillmentResult`	履行状态。有效值： `FULFILLED`：您提供了内容，并且客户使用了内容。 `UNAVAILABLE`：您无法向客户提供内容。发送此值不会立即取消订单。将在14天后取消订单并退款。有关发送哪个`fulfillmentResult`的更多详细信息，请参阅调用notifyFulfillment的指南。	是

响应代码

提出HTTP请求后，确认收据API会使用以下代码之一进行响应。

响应代码	描述
HTTP 200	成功：收据ID、用户ID和共享密钥都是有效的。订阅被标记为已履行。
HTTP 400	此`receiptId`表示的交易无效，或没有找到此`receiptId`的交易。
HTTP 410	此`receiptId`表示的交易不再有效。请将其作为已取消的收据。
HTTP 429	该请求已被限制节流。请降低您的调用速率并稍后重试。
HTTP 496	共享密钥无效
HTTP 497	用户ID无效
HTTP 500	出现内部服务器错误。

确认收据常见问题解答

以下是关于确认收据API的常见问题解答 (FAQ)。

问：应在每次续订后调用确认收据API，还是仅在购买后调用？: 应在购买之后调用确认收据API。
问：已经确认后，如果调用的确认收据API状态为FULFILLED，会发送什么响应？: 多次调用状态为FULFILLED的确认收据API是一种幂等操作，每次都会得到相同的响应。
问：有没有可以还原acknowledgeReceipt操作的方法？如果acknowledgeReceipt的状态已更新为FULFILLED，是否可以将其设置为UNAVAILABLE？: 不可以，acknowledgeReceipt的状态可以从UNAVAILABLE转换为FULFILLED，但不能从FULFILLED转换为UNAVAILABLE。如果发现收据有错误，请联系我们寻求帮助。

步骤6：集成RTN

借助快速订阅，客户可以通过亚马逊订阅您的应用，不过购买发生在应用之外。这可能会导致您的应用缺少部分关于客户购买状态的信息。getPurchaseUpdates() 方法仅在应用打开时发送数据。

实时通知 (RTN) 可为所有交易提供客户购买信息，包括发生在您应用以外的交易。您的服务器收到来自亚马逊RTN服务器的购买通知后，请使用收据验证服务 (RVS) 验证收据。

借助RTN，亚马逊可以向您发送客户订阅事件最新信息（例如当客户购买、续订或取消订阅时）。这些信息可以确保应用始终拥有最新的用户订阅相关信息，因此对于采用快速订阅的应用非常重要。

有关如何设置RTN的详细信息，请参阅使用实时通知。

要在您的应用中集成一键账户信息共享功能，请遵循集成一键账户信息共享功能指南。

下图展示了采用一键账户信息共享功能的快速订阅代码流程。

注意： 要访问客户信息，requestUserProfileAccess()、获取访问令牌请求和获取用户配置文件请求必须成功。如果客户表示同意，但其中任一请求失败，您将无法获取创建账户所需的客户信息。在这种情况下，请向客户显示您应用的默认注册或登录体验。

设置一键账户信息共享功能的大致步骤如下所示。

更新应用清单。
实现getUserData()。
确定客户的同意状态。
- 如果客户不同意，请使用您的标准账户创建流程。
- 如果客户同意，请继续执行下一步。
要获取访问令牌，请使用Appstore SDK中的获取访问令牌REST API。
要获取客户的配置文件数据，请使用Appstore SDK中的获取用户配置文件REST API。
- 获取客户电子邮件地址。
- 使用客户电子邮件地址为您的服务创建一个账户。

借助亚马逊的动态应用测试 (LAT) 服务，您可以在上线前将要在亚马逊应用商店发布的应用分发给一组预设定的测试者进行测试。测试者可以针对亚马逊的生产环境对全套亚马逊服务进行采样，这样就可以确保您的应用按预期工作。

要使用动态应用测试 (LAT) 测试快速订阅，请先使用在开发者控制台中配置快速订阅中的步骤，在开发者控制台中为LAT配置快速订阅。您可以仅为LAT配置快速订阅，也可以为上线应用和LAT应用配置快速订阅，如下图所示。

如果您选择仅为LAT配置快速订阅，则稍后可以通过选择操作>升级为上线版本，将配置升级到上线应用，如下图所示。

如果您对LAT应用进行的快速订阅配置与对上线应用进行的配置不同，则LAT应用的快速订阅详细信息中会显示测试标签，如下图所示。

您可以通过亚马逊零售网站或Fire设备测试快速订阅流程。当您开始动态应用测试时，可以向测试者发送邀请。测试者会收到一封电子邮件，其中会附上提供LAT版本应用的亚马逊网站链接。

在LAT邀请电子邮件中，选择您所在市场的亚马逊网站。在应用详情页面上，选择订阅选项，该选项显示为订阅期限的付费选项，例如每月20.00美元。然后选择要交付至哪个设备，接着单击Get App（获取应用）。

要开始在设备上测试快速订阅，您可以使用LAT邀请电子邮件或设备通知。

通过LAT邀请进行测试

使用邀请电子邮件中的链接转到亚马逊网站上的应用详情页面。
选择App Only（仅限应用）选项。
如果您的账户关联了多台设备：
1. 单击Deliver to <设备名称>（交付至<设备名称>）中的设备名称。
2. 在Deliver to（交付至）对话框中，选择要将应用交付到哪个设备。
单击Get App。
在与亚马逊账户关联的Fire TV设备上，单击Your Apps & Channels（您的应用和频道）的图标（该图标在导航栏上显示为三个正方形和一个加号）。
找到您应用的LAT版本，该应用的图标上有一个TEST（测试）横幅。您可能需要单击App Library（应用库）才能查看该应用。
选择应用图标以打开设备上的应用详情页面。
选择Subscription Options（订阅选项）并下载应用。

通过通知进行测试

发送LAT邀请后，与测试者电子邮件相关联的测试设备会收到通知。如果您在通知出现时打开通知，则会进入LAT应用详情页面。此通知会显示5-10秒。如果您在通知首次出现时错过了通知，可以单击设置图标（齿轮图标）并选择Notifications（通知）来查看它。然后您可以阅读通知并转到应用详情页面。选择Subscription Options（订阅选项）并下载应用。

重要须知

在以下情况下，不支持通过LAT测试快速订阅：
- 当您选择要交付到哪个具体设备时，请使用网站上的App Only选项。
- 使用设备上的App Only选项。
要通过LAT就快速订阅以外的目的测试应用，您可以使用App Only选项并选择要将应用交付到哪个具体设备。
在测试快速订阅时关闭加速订阅。
要重置测试账号的快速订阅，可前往开发者控制台为LAT重置订阅。有关详细信息，请参阅为LAT中的所有测试者重置应用内商品或管理单个测试者。
如果您想将14天的取消时间范围缩短为1天的测试时间范围，请联系您的亚马逊代表。

Last updated: 2025年4月7日

设置快速订阅

先决条件

注意事项

步骤1： 在开发者控制台中配置快速订阅

步骤2： 配置安全配置文件

步骤3： 实现getPurchaseUpdates

实现要求

步骤4： 集成RVS

步骤5： 将履行结果发送给亚马逊

实现要求

自动取消

确认收据API

查询参数

响应代码

确认收据常见问题解答

步骤6： 集成RTN

步骤7： 集成一键账户信息共享功能

步骤8： 使用LAT测试快速订阅

为快速订阅设置LAT

在网站上测试快速订阅

在设备上测试快速订阅

相关主题

步骤1：在开发者控制台中配置快速订阅

步骤2：配置安全配置文件

步骤3：实现getPurchaseUpdates

步骤4：集成RVS

步骤5：将履行结果发送给亚马逊

步骤6：集成RTN

步骤7：集成一键账户信息共享功能

步骤8：使用LAT测试快速订阅