iOS IAP 自动更新的订阅服务

自动更新的订阅服务

In-App Purchase提供了自动更新型订阅服务的标准方式。自动更新型订阅有如下新的显著特征：

1. 当你在iTunes Connect中配置自动更新型订阅服务时，需要同时指定更新周期和其他的促销选项。
2. 自动更新型订阅服务会被自动恢复（使用Store Kit中恢复非消费型商品一样的函数）。原始的交易信息会和更新的交易信息一起发送给你的程序。详情请查看“Restoring Transactions”一节。
3. 当你的服务器向App Store验证收据（receipt），订阅服务被激活并更新时，App store会向你的app返回更新后的收据信息。

3.为你的商店添加自动更新型订阅服务

按以下步骤来实现自动更新型订阅服务：

1. 连接iTunes Connect网站，并创建一个共享密钥。共享密钥是一个密码，你的服务器在验证自动更新型订阅服务的时候必须提供这个密码。共享密钥为App Store的交易增加了一层保护。（详情，请参考iTunes Connect Developer Guide文档）

2. 在iTunes Connect中创建并配置新的自动更新型订阅服务商品。

3. 修改服务器端关于验证收据部分的代码，添加共享密钥到验证信息用的JSON数据中。服务器的验证代码需要可以解析App store的返回数据以判断订阅是否过期。如果订阅服务已经被用户更新，最新的收据也会返回给你的server。

设计iOS客户端

大多数情况下，iOS客户端程序应做出最小新改来支持自动更新型订阅服务。事实上，客户端程序需要做的更简单，你可以使用非消费型（non-consumable）商品的流程来做自动更新型订阅服务的事情。你的程序在不同时期会收到单独的交易信息来告知订阅已被更新。程序应该单独验证每一条收据。

验证自动更新型订阅服务的收据

验证自动更形型订阅服务的收据和之前讲到的“验证收据”的方式一致。你的程序创建一个JSON对象并把它发送给App Store。自动更新型订阅服务的JSON对象必须包含另外的参数——就是你在iTunes Connect中创建的共享密钥。

{
“receipt-data” : “(actual receipt bytes here)”
“password” : “(shared secret bytes here)”
}

返回内容包含了状态信息，用来标识收据是否验证有效。

{
“status” : 0,
“receipt” : { … }
“latest_receipt” : “(base-64 encoded receipt)”
“latest_receipt_info” : { … }
}

如果用户的收据是有效的，订阅被激活，则status的值为0。receipt对应的值为解码后的收据信息。如果你的服务器收到了非零值的状态码，对照表7-1查看：

表7－1 自动更新型订阅服务返回状态码
状态码 描述
21000 App Store无法读取你提供的JSON数据
21002 收据数据不符合格式
21003 收据无法被验证
21004 你提供的共享密钥和账户的共享密钥不一致
21005 收据服务器当前不可用
21006 收据是有效的，但订阅服务已经过期。当收到这个信息时，解码后的收据信息也包含在返回内容中
21007 收据信息是测试用（sandbox），但却被发送到产品环境中验证
21008 收据信息是产品环境中使用，但却被发送到测试环境中验证
注意：在这里的非零状态码只是针对自动更新型订阅服务，不能将这些状态码用在测试其他类型产品的返回值中。

JSON数据中的receipt栏位包含了解析过的收据信息。自动更新型订阅服务包含了一些新加的信息。请参考表7-2：

表7－2 自动更新型订阅服务的信息：

键名 描述
expires_date 订阅的过期时间，显示方式是从Jan 1, 1970, 00:00:00 GMT计算到过期时间的毫秒数。这个键不包含在恢复的交易信息中。
original_transaction_id 初次购买的交易标识。所有订阅的更新和恢复交易都共享这个标识
original_purchase_date 初次购买（订阅）的日期。
purchase_date 交易的日期。对于更新订阅的交易来说，这个日期表示更新日期。如果从App Store解析的数据是最新的订阅收据，这个值表示最近更新订阅的日期。

除了receipt-Data信息外，返回内容还可能包含另外两个信息。如果用户的订阅服务被激活并更新。则latest_receipt信息会被以base-64方式编码并包含在返回内容中。解码后的新的收据信息也会在latest_expired_receipt_info包含。你的服务器可以使用新的收据来维护最新更新订阅的信息。

4. 如果交易是恢复过来的（restore），我们用这个方法来处理：

– (void) restoreTransaction: (SKPaymentTransaction *)transaction
{
[self recordTransaction: transaction];
[self provideContent: transaction.payment.productIdentifier];

[[SKPaymentQueue defaultQueue] finishTransaction: transaction];
}
这个过程完成购买的过程类似。 恢复的购买内容提供一个新的交易信息，这个信息包含了新的transaction的标识和receipt数据。 如果需要的话，你可以把这些信息单独保存下来，供追溯审(我们的)查之用。但更多的情况下，在交易完成时，你可能需要覆盖原始的transaction数据，并使用其中的商品标识。