苹果内购(IAP)从入门到精通(4)- 订阅、续订、退订、恢复订阅

27,389 阅读14分钟

该系列的其他文章:

【1】苹果内购(IAP)从入门到精通(1)-内购商品类型与配置

【2】苹果内购(IAP)从入门到精通(2)-银行卡与税务信息配置

【3】苹果内购(IAP)从入门到精通(3)- 商品充值流程(非订阅型)

【5】苹果内购(IAP)从入门到精通(5)- 掉单处理、防hook以及一些坑

【6】苹果内购(IAP)从入门到精通(6)- 实际业务结合&线上异常情况处理

1. 充值流程(自动订阅)

1.1. 商品购买

等同于消耗型商品的购买。无非也是添加支付队列监听,初始化SKPayment并添加到支付队列中,然后付款,回调Purchased状态。在这里不再赘述。详细看上一篇文章:苹果内购(IAP)从入门到精通(3)- 商品充值流程(非订阅型)。主要的区别是在后面。

1.2. 票据校验

请求苹果票据校验时,请求参数需要传一个新的参数,叫“共享秘钥”。这个在苹果后台配置商品ID的地方生成,如下所示:

image.png 自动订阅商品的票据,与消耗型商品的票据有很多不同点。

{
    environment = Sandbox;
    "latest_receipt" = "很长一串,是请求时的加密票据";
    "latest_receipt_info" =     (
                {
            "expires_date" = "2019-09-18 06:44:15 Etc/GMT";
            "expires_date_ms" = 1568789055000;
            "expires_date_pst" = "2019-09-17 23:44:15 America/Los_Angeles";
            "is_in_intro_offer_period" = false;     
            "is_trial_period" = true;       
            "original_purchase_date" = "2019-09-18 06:41:16 Etc/GMT";       
            "original_purchase_date_ms" = 1568788876000;
            "original_purchase_date_pst" = "2019-09-17 23:41:16 America/Los_Angeles";
            "original_transaction_id" = 1000000569412514;       
            "product_id" = "com.auto.pay6";     
            "purchase_date" = "2019-09-18 06:41:15 Etc/GMT";
            "purchase_date_ms" = 1568788875000;
            "purchase_date_pst" = "2019-09-17 23:41:15 America/Los_Angeles";
            quantity = 1;
            "subscription_group_identifier" = 20548697;
            "transaction_id" = 1000000569412514;
            "web_order_line_item_id" = 1000000046978708;
        }
    );
    "pending_renewal_info" =     (
                {
            "auto_renew_product_id" = "com.auto.pay6";      //自动订阅商品ID
            "auto_renew_status" = 1;        //自动订阅状态(0说明订阅已关闭)
            "original_transaction_id" = 1000000569412514;
            "product_id" = "com.auto.pay6";
        }
    );
    receipt =     {
        "adam_id" = 0;
        "app_item_id" = 0;
        "application_version" = 1;
        "bundle_id" = "com.mytest.0522";
        "download_id" = 0;
        "in_app" =         (
                        {
                "expires_date" = "2019-09-18 06:44:15 Etc/GMT"; need    //订阅到期时间
                "expires_date_ms" = 1568789055000;      //订阅到期时间戳
                "expires_date_pst" = "2019-09-17 23:44:15 America/Los_Angeles";     //订阅到期时间(美国)
                "is_in_intro_offer_period" = false;     //是否在享受优惠价格期间
                "is_trial_period" = true;       //是否享受免费试用
                "original_purchase_date" = "2019-09-18 06:41:16 Etc/GMT";       //原始购买时间
                "original_purchase_date_ms" = 1568788876000;        //原始购买时间戳
                "original_purchase_date_pst" = "2019-09-17 23:41:16 America/Los_Angeles";       //原始购买时间(美国)
                "original_transaction_id" = 1000000569412514;       //原始购买票据ID
                "product_id" = "com.auto.pay6";     //商品ID
                "purchase_date" = "2019-09-18 06:41:15 Etc/GMT";        //购买时间
                "purchase_date_ms" = 1568788875000;     //购买时间戳
                "purchase_date_pst" = "2019-09-17 23:41:15 America/Los_Angeles";        //购买时间(美国)
                quantity = 1;       //购买商品数量
                "transaction_id" = 1000000569412514;        //票据ID
                "web_order_line_item_id" = 1000000046978708;        ////跨设备购买事件(包括订阅更新事件)的唯一标识符。此值是识别订阅购买的主键
            }
        );
        "original_application_version" = "1.0";
        "original_purchase_date" = "2013-08-01 07:00:00 Etc/GMT";
        "original_purchase_date_ms" = 1375340400000;
        "original_purchase_date_pst" = "2013-08-01 00:00:00 America/Los_Angeles";
        "receipt_creation_date" = "2019-09-18 06:41:16 Etc/GMT";
        "receipt_creation_date_ms" = 1568788876000;
        "receipt_creation_date_pst" = "2019-09-17 23:41:16 America/Los_Angeles";
        "receipt_type" = ProductionSandbox;
        "request_date" = "2019-09-18 06:42:32 Etc/GMT";
        "request_date_ms" = 1568788952928;
        "request_date_pst" = "2019-09-17 23:42:32 America/Los_Angeles";
        "version_external_identifier" = 0;
    };
    status = 0;
}

在in_app内,多了以下几个字段

"expires_date" = "2019-09-18 06:44:15 Etc/GMT"; //订阅到期时间
"expires_date_ms" = 1568789055000; //订阅到期时间戳
"expires_date_pst" = "2019-09-17 23:44:15 America/Los_Angeles"; //订阅到期时间(美国)
"is_in_intro_offer_period" = false; //是否在享受优惠期间
"web_order_line_item_id" = 1000000046978708; ////跨设备购买事件(包括订阅更新事件)的唯一标识符。此值是识别订阅购买的主键

排查其他商品类型的票据后,我发现,即使是“非续期订阅”商品,也没有这几个字段。所以,可以判定,拥有这几个字段,就说明这个商品是自动订阅商品。(服务端可以用这5个字段来判断,这个票据是不是自动订阅的票据)

校验票据是否合法的逻辑同理于消耗型商品,如果校验通过了。就通知后台下发道具、更新客户端UI等。

2. 订阅续期

“自动订阅”商品,顾名思义,苹果会自动扣款续费。

最常见的有两种情况自动订阅商品会失效:

(1)用户手动取消订阅。需要用户手动去“设置”里去取消订阅。取消后,从下一个订阅周期开始,将不再扣费。同时,游戏内需要处理这个逻辑,停止下个周期的订阅服务的下发。

(2)购买订阅的AppleID绑定的银行卡或者信用卡没钱了。苹果会反复尝试扣款。如果都没有扣款成功,将停止订阅。(有坑,后面会说)

除此之外,苹果都会自动扣款去续订。有两种方式去判断续订是否成功:

一、每次启动app时,客户端主动获取receipt_data,上传给服务器做票据校验,服务器检查票据内是否有新的续订交易(时间可以判断),有则下发新的订阅商品。

二、server to server的校验方式,也是 苹果推荐的校验方式 ,由苹果主动告知我们状态。需要在appstore connect后台配置订阅状态URL,具体参考苹果官方文档启用针对自动续期订阅的服务器通知,同时也需要用到共享秘钥(上面有说到)。

参考上面的官方文档可以发现,苹果提供了两个server to server的接口,V1和V2。两个版本的接口、参数、回调都不一样。业界内主要用的还是V1版本,更加稳定(听说V2有一些bug),因此我们这里介绍V1版本的:

如果这样配置了server to server的通知,后台就会收到下面的几种状态更新通知类型:

NOTIFICATION_TYPE描述
INITIAL_BUY首次订阅
CANCEL取消订阅
DID_RENEW自动续订成功
INTERACTIVE_RENEWALApp或者设置内交互式续订
DID_FAIL_TO_RENEW计费问题未能续订
DID_RECOVER已成功续订过去未能续订的过期订阅
DID_CHANGE_RENEWAL_STATUS续订状态发生变化
DID_CHANGE_RENEWAL_PREF续订降级
CONSUMPTION_REQUEST发起退款申请
REFUND退款成功
PRICE_INCREASE_CONSENT提价状态
INTERACTIVE_RENEWALApp或者设置内以交互方式续订
REVOKE不能继续家庭共享

通过server to server,服务端开发可以通过状态和回调的original_transaction_id匹配的订单与用户,进行相应的逻辑。

注意:服务端最好处理CANCEL类型。因为IAP存在黑产:比如买了一年会员,然后打电话给苹果客服退款,如果服务端不处理,这一年会员是生效的。

(1)更新票据:

在续费的前10天,Apple会进行续费的前期检查,尽量确保用户能够正常扣款。如果前期检查出了问题,会提醒用户应该处理对应的问题。

在续费的前24小时,Apple会尝试扣款,Apple会尝试几次扣款,如果一直扣款失败会停止扣款,订阅被动取消。注意,如果是支付相关的问题,Apple可能会进行长达60天的尝试。可以通过收据中的is_in_billing_retry_period判断Apple是否还在尝试中。

同一个订单凭据是可以一直使用的,不管你后面续订了多少次,随便这些中的一个凭据发给苹果验证,就能得到所有的订单信息和订阅状态。服务端需要保存这笔订单的recipt_data,并在每个周期结束之前请求苹果票据校验接口,根据返回的票据信息去得到用户是否仍然续订的信息。

续订后,in_app内会多一组新的票据数据。代表新的续订。如下所示:

{
    environment = Sandbox;
    "latest_receipt" = "==========很长串票据字符============";
    "latest_receipt_info" =     (
        {
            "expires_date" = "2019-09-23 09:18:17 Etc/GMT";
            "expires_date_ms" = 1569230297000;
            "expires_date_pst" = "2019-09-23 02:18:17 America/Los_Angeles";
            "is_in_intro_offer_period" = false;
            "is_trial_period" = true;
            "original_purchase_date" = "2019-09-23 09:15:18 Etc/GMT";
            "original_purchase_date_ms" = 1569230118000;
            "original_purchase_date_pst" = "2019-09-23 02:15:18 America/Los_Angeles";
            "original_transaction_id" = 1000000571201990;
            "product_id" = "com.auto.pay6";
            "purchase_date" = "2019-09-23 09:15:17 Etc/GMT";
            "purchase_date_ms" = 1569230117000;
            "purchase_date_pst" = "2019-09-23 02:15:17 America/Los_Angeles";
            quantity = 1;
            "subscription_group_identifier" = 20548697;
            "transaction_id" = 1000000571201990;
            "web_order_line_item_id" = 1000000047083065;
        },
        {
            "expires_date" = "2019-09-23 09:21:17 Etc/GMT";
            "expires_date_ms" = 1569230477000;
            "expires_date_pst" = "2019-09-23 02:21:17 America/Los_Angeles";
            "is_in_intro_offer_period" = false;
            "is_trial_period" = false;
            "original_purchase_date" = "2019-09-23 09:15:18 Etc/GMT";
            "original_purchase_date_ms" = 1569230118000;
            "original_purchase_date_pst" = "2019-09-23 02:15:18 America/Los_Angeles";
            "original_transaction_id" = 1000000571201990;
            "product_id" = "com.auto.pay6";
            "purchase_date" = "2019-09-23 09:18:17 Etc/GMT";
            "purchase_date_ms" = 1569230297000;
            "purchase_date_pst" = "2019-09-23 02:18:17 America/Los_Angeles";
            quantity = 1;
            "subscription_group_identifier" = 20548697;
            "transaction_id" = 1000000571203602;
            "web_order_line_item_id" = 1000000047083066;
        }
    );
    "pending_renewal_info" =     (
                {
            "auto_renew_product_id" = "com.auto.pay6";
            "auto_renew_status" = 1;
            "original_transaction_id" = 1000000571201990;
            "product_id" = "com.auto.pay6";
        }
    );
    receipt =     {
        "adam_id" = 0;
        "app_item_id" = 0;
        "application_version" = 1;
        "bundle_id" = "com.mytest.0522";
        "download_id" = 0;
        "in_app" =         (
            {
                "expires_date" = "2019-09-23 09:21:17 Etc/GMT";
                "expires_date_ms" = 1569230477000;
                "expires_date_pst" = "2019-09-23 02:21:17 America/Los_Angeles";
                "is_in_intro_offer_period" = false;
                "is_trial_period" = false;
                "original_purchase_date" = "2019-09-23 09:15:18 Etc/GMT";
                "original_purchase_date_ms" = 1569230118000;
                "original_purchase_date_pst" = "2019-09-23 02:15:18 America/Los_Angeles";
                "original_transaction_id" = 1000000571201990;
                "product_id" = "com.auto.pay6";
                "purchase_date" = "2019-09-23 09:18:17 Etc/GMT";
                "purchase_date_ms" = 1569230297000;
                "purchase_date_pst" = "2019-09-23 02:18:17 America/Los_Angeles";
                quantity = 1;
                "transaction_id" = 1000000571203602;
                "web_order_line_item_id" = 1000000047083066;
            },
             {
                "expires_date" = "2019-09-23 09:18:17 Etc/GMT";
                "expires_date_ms" = 1569230297000;
                "expires_date_pst" = "2019-09-23 02:18:17 America/Los_Angeles";
                "is_in_intro_offer_period" = false;
                "is_trial_period" = true;
                "original_purchase_date" = "2019-09-23 09:15:18 Etc/GMT";
                "original_purchase_date_ms" = 1569230118000;
                "original_purchase_date_pst" = "2019-09-23 02:15:18 America/Los_Angeles";
                "original_transaction_id" = 1000000571201990;
                "product_id" = "com.auto.pay6";
                "purchase_date" = "2019-09-23 09:15:17 Etc/GMT";
                "purchase_date_ms" = 1569230117000;
                "purchase_date_pst" = "2019-09-23 02:15:17 America/Los_Angeles";
                quantity = 1;
                "transaction_id" = 1000000571201990;
                "web_order_line_item_id" = 1000000047083065;
            }
        );
        "original_application_version" = "1.0";
        "original_purchase_date" = "2013-08-01 07:00:00 Etc/GMT";
        "original_purchase_date_ms" = 1375340400000;
        "original_purchase_date_pst" = "2013-08-01 00:00:00 America/Los_Angeles";
        "receipt_creation_date" = "2019-09-23 09:20:00 Etc/GMT";
        "receipt_creation_date_ms" = 1569230400000;
        "receipt_creation_date_pst" = "2019-09-23 02:20:00 America/Los_Angeles";
        "receipt_type" = ProductionSandbox;
        "request_date" = "2019-09-23 09:20:10 Etc/GMT";
        "request_date_ms" = 1569230410417;
        "request_date_pst" = "2019-09-23 02:20:10 America/Los_Angeles";
        "version_external_identifier" = 0;
    };
    status = 0;
}

我们关注in_app内的如下几个字段:

  • purchase_date:代表当前这笔订单的扣款时间。续订也是扣款。如果是续订,这个时间正好是上一笔扣款数据里purchase_date+订阅周期。
  • original_purchase_date:代表这个自动订阅商品的第一次购买的时间。服务端可以用来判断这个用户是什么时候开启订阅的。
  • original_transaction_id:表示第一次订阅的时候的票据ID。因为服务端肯定用自己的订单号(orderId)和这个票据ID进行的绑定。所以要想跟踪是哪笔订单的续订,就使用这个。transaction_id每次都会改变,即使是恢复订阅,transaction_id也会改变,所以不要使用这个字段。

(2)票据合法性校验

一般情况下,只要实现了server to server的通知,苹果都会在续订后告知你。但有小概率出现不告知的情况。所因此建议,服务端记录下来最后一个收据(receipt_data),在订阅过期时间expires_date前24小时,定时用最后一条收据轮询,如果用户续费未成功,检查is_in_billing_retry_period,如果这个为true,那么放到下个轮训队列里继续检查,直到is_in_billing_retry_period为false,表示Apple已经放弃了扣款。如果续订成功,服务端拿到最新的票据后,判断时间、商品ID是否合法,原始票据ID对应的订单ID是否合法。之后,给这个订单ID对应的用户进行订阅续期操作,发放相应道具或者权限。

(3)sandbox环境下的订阅周期

在沙盒环境下,测试自动续期订阅时,时限会缩短。此外,每天的订阅次数最多仅能自动续期12次(包括首次订阅)。

实际时限测试时限
1 周3 分钟
1个月5 分钟
2 个月10 分钟
3 个月15 分钟
6 个月30 分钟
1 年1 小时

而取消订阅,苹果是没办法模拟的。所以一般是采用新建一个新的沙盒账号去解决。

3. 恢复订阅

比如一个用户(人),他在A设备上购买了App的VIP(自动订阅商品)。他买了一台新的手机B,重新下载了这个App。但这个App的VIP是本地Keychain缓存设置。换了设备后,keychain没有了缓存,这个用户在设备B上不享有VIP。但用户付了钱,肯定需要享受服务,所以苹果提供了“restore”服务,恢复订阅的权限。这个是正常的逻辑。

但还有一种情况,是苹果允许,但却很bug的设定。订阅服务是跟AppleID绑定的。但我们每个app基本都是有自己的用户系统,这个用户系统跟AppleID无关(实际上iOS开发者也拿不到用户的AppleID)。所以,苹果要求:只要当前App是由一个已订阅过的AppleID下载的,这个App下的任何App账号,都可以享受这个订阅权限。

是不是很绕?我们举个最简单的例子(真的是最简单的):

用户A,有AppleID_A给这个APP下的账号A购买了会员(自动订阅);这时,用户A换了一个账号B。那么这个账号B也需要享受会员。如果没有享受,APP内可以开放一个“恢复订阅”功能,让用户A可以操作给账号B恢复订阅服务。

因为苹果这个不讲道理的要求,实际上的场景要复杂很多。AB用户、AB设备、AB苹果ID、AB账号、AB角色......我们不在这个地方过分展开说,具体场景需要结合自己的APP进行调试。

恢复流程如下所示。

开启恢复订阅:

[[SKPaymentQueue defaultQueue] restoreCompletedTransactions]; //恢复已订阅商品

点击恢复按钮后,支付队列开启监听订阅商品状态。

- (void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray *)transactions
{
    for (int i = 0; i < [transactions count]; ++i)
    {
        SKPaymentTransaction *transaction = [transactions objectAtIndex:i];
        switch (transaction.transactionState)
        {
            case SKPaymentTransactionStatePurchasing: //消费中
                //...
                break;
            case SKPaymentTransactionStatePurchased: //消费成功
                //...
                break;
            case SKPaymentTransactionStateFailed:    //消费失败
                //...
                break;
            case SKPaymentTransactionStateRestored:  //恢复已购买的商品(消耗型产品不能恢复)
            {
            _isRestoring = YES;
            NSLog(@"恢复订阅商品:%@;订阅购买时间:%@",transaction.originalTransaction.originalTransaction,transaction.transactionDate);
            }
                break;
            default:            //购买处于待定状态
                break;
        }
    }
}

updatedTransactions代理方法中,SKPaymentTransactionStateRestored状态代表了订阅恢复状态。如果商品A从购买到续订总共支付3次(即续订2次),那么这个时候transactions内会有3个transaction。但这些transactions都在一个票据里,所以建议是在这里不做太多处理。

那在哪儿告知服务器去重新校验票据合法性呢?如下方法:

//代理方法来自于SKPaymentTransactionObserver
// 从用户的购买历史记录中的所有事务成功添加回队列时发送
- (void)paymentQueueRestoreCompletedTransactionsFinished:(SKPaymentQueue *)queue
{
    //有待恢复的订阅
    if (_isRestoring) {
        _isRestoring = NO;  //恢复到默认值
        [self verifyTransactionReceiptWithQueue:queue];  //票据校验
    }
}

//模拟服务器校验票据的逻辑(这个最好都交给服务器去处理)
- (void)verifyTransactionReceiptWithQueue:(SKPaymentQueue *)paymentQueue
{
    NSString *localTestRequestUrl = @"https://sandbox.itunes.apple.com/verifyReceipt";
    NSData *receiptData = [NSData dataWithContentsOfURL:[[NSBundle mainBundle] appStoreReceiptURL]];
    NSString *receiptNewStr = [receiptData base64EncodedStringWithOptions:0];
    
    [self localReceiptVerifyingWithUrl:localTestRequestUrl AndReceipt:receiptNewStr AndPaymentQueue:paymentQueue];
}

//校验恢复票据
- (void)localReceiptVerifyingWithUrl:(NSString *)requestUrl AndReceipt:(NSString *)receiptStr AndPaymentQueue:(SKPaymentQueue *)paymentQueue
{
    NSDictionary *requestContents = @{
                                      @"receipt-data": receiptStr,
                                      @"password" : @"48f920000fd8440d98262000003370e3"
                                      };
    NSError *error;
    // 转换为 JSON 格式
    NSData *requestData = [NSJSONSerialization dataWithJSONObject:requestContents
                                                          options:0
                                                            error:&error];
    NSString *verifyUrlString = requestUrl;
    NSMutableURLRequest *storeRequest = [NSMutableURLRequest requestWithURL:[[NSURL alloc] initWithString:verifyUrlString] cachePolicy:NSURLRequestUseProtocolCachePolicy timeoutInterval:10.0f];
    [storeRequest setHTTPMethod:@"POST"];
    [storeRequest setHTTPBody:requestData];
    
    // 在后台对列中提交验证请求,并获得官方的验证JSON结果
    NSURLSession *session = [NSURLSession sharedSession];
    NSURLSessionDataTask *task = [session dataTaskWithRequest:storeRequest completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
        if (error) {
            NSLog(@"链接失败");
            for (SKPaymentTransaction *transaction in paymentQueue.transactions) {
                [[SKPaymentQueue defaultQueue] finishTransaction:transaction];
            }
        } else {
            NSError *error;
            NSDictionary *jsonResponse = [NSJSONSerialization JSONObjectWithData:data options:0 error:&error];
            if (!jsonResponse) {
                NSLog(@"验证失败");
                for (SKPaymentTransaction *transaction in paymentQueue.transactions) {
                    [[SKPaymentQueue defaultQueue] finishTransaction:transaction];
                }
            }
            NSLog(@"验证成功");
            //TODO:取这个json的数据去判断,道具是否下发
        }
    }];
    [task resume];
}

paymentQueueRestoreCompletedTransactionsFinished:方法只会调用一次。而所有恢复的票据信息都在[[NSBundle mainBundle] appStoreReceiptURL]里。所以在这个位置去请求服务器做校验。

4. 退订

不用客户端去监听,由服务器server to server的形式,等待苹果回调。如果用户退订,苹果会回调一个CANCEL状态的票据。 之后告知客户端取消App对应账号的订阅服务(也可以通过如下形式去处理订阅商品:每次续订告知客户端下发商品,如果退订了则不告知即不做操作,客户端未收到消息,则不再继续下发商品)。

注意:苹果的接口,有小概率出现“续订或退订不主动告知”的坑。所以建议App服务端在每次订阅即将到期前的24h,轮询校验票据的receipt_data,判断是否有续订或者退订。

用户退款过的订单依然会在receipt中出现,因此App服务器实现验证的时候需要能够识别出已经被退款的订单,不至于给退款的订单发货。

被退款订单的唯一标识是:它带有一个cancellation_date字段。服务端验证凭据时,如果有这个字段,则不分发商品。

参考资料:

【1】iOS 自动订阅开发

【2】iOS内购IAP(十八) —— 自动续订订阅(一)

【3】内购之恢复购买记录