google 内购需要注意的点 -- 持续更新

前言

之前项目有用到了一些第三方支付，包括 paypal, google iap, stripe, apple iap, 还有国内的 alipay。其中每个支付类型都有一些坑，本章讲的是google 内购支付，即 google iap 的一些需要注意的点，或者是一些踩过的坑，将会持续更新。

创建商品的最低价钱

之前有一个需求，就是服务端要调用google的 iap API 来动态创建商品项， API INSERT DOC, 打算建一个 $0.5 的订单，后面发现竟然报错了：

1
2
3

[2018-04-12 08:22:26] GoogleIap.INFO: start create google plan,0.5,0.1,1 [] []
[2018-04-12 08:22:28] GoogleIap.ERROR: insert google plan error:{  "error": {   "errors": [    {     "domain": "androidpublisher",     "reason": "inAppProductDefaultPriceTooLow",     
"message": "Default price is too low."    }   ],   "code": 403,   "message": "Default price is too low."  } }  [] []

价钱太低了。后面试了一下： 0.9 刚好可以建

1
2
3

[2018-04-12 08:38:18] GoogleIap.INFO: start create google plan,0.9,0.1,1 [] []
[2018-04-12 08:38:20] GoogleIap.DEBUG: create plan:{"defaultLanguage":"en-US","packageName":"...","purchaseType":"managedUser","sku":"....9","status":"active","subscriptionPeriod":null,"trialPeriod":null} [] []
[2018-04-12 08:38:21] GoogleIap.INFO: start insert google plan,0.9,....9 [] []

0.89 都不行：

1
2
3

[2018-04-12 08:41:01] GoogleIap.INFO: start create google plan,0.89,0.1,1 [] []
[2018-04-12 08:41:03] GoogleIap.ERROR: insert google plan error:{  "error": {   "errors": [    {     "domain": "androidpublisher",     
"reason": "inAppProductDefaultPriceTooLow",     "message": "Default price is too low."    }   ],   "code": 403,   "message": "Default price is too low."  } }  [] []

所以最低都要是 $0.9

测试账号和正式账号的支付差距

我们知道google iap其实是没有沙盒环境的，但是它可以设置某一个账号为测试账号，用这个所谓的测试账号来支付，是不用真正花钱的。但是用测试账号来支付和用正常账号来支付的话，其实是有差距，如果是循环的话，假设是循环一个月，那么如果是测试账号的话，5分钟就过期了，就会再续了。具体如下：

所以最好告知你们的测试人员，不然他会很疑惑

使用GCP平台集成webhook

google iap 还有一个很不好的地方就是，就是没有 webhook 通知，但是我们可以通过他们的 GCP 平台来集成 webhook 功能，具体看：
google iap webhook 接入(2) - 项目接入GCP webhook

取消订阅的神奇逻辑

google 内购 取消订阅 有一个很神奇的逻辑:
假设这个用户在4月1号订阅了一个产品，但是在 4月15号的时候，取消了订阅。但是这时候google是不受理的，他还是会等到这个循环周期结束的时候，也就是5月1号的时候，当再去扣钱的时候，这时候再去判断是否有取消订阅。如果有取消，那么就不扣钱，如果没有取消，那么就扣钱。
也就是说假设一个用户在4月15号，取消了订阅，但是在4月20号的时候，又购买了同一个订阅商品，这时候的订单号肯定是会变的，但是这时候google还是会认为这个用户还在循环周期内，所以根本不会扣款，还是要等到5月1号才扣款，但是程序要特别注意，不能因为用户购买了循环，订单号变了，就给他升级，而是要判断他有没有之前就购买过，并且有在循环周期内，不然就会给他升两次了
服务端判断的条件可以是这样子，比如判断服务端有没有存在相同过期时间的有效循环，如果有的话，一般都是再购买的，因为过期时间是精确到毫秒的，基本上不会有重复的两个不同的支付用户存在，而这时候这个循环是不会扣钱的。

订阅超过一年之后，手续费降为15%

我们知道google 内购的手续费贵的要死，他会收30%的平台费，也就是说，用户支付$10,事实上到达我们的账户只有 $7。
好消息就是如果对于循环支付订单，如果超过了12个支付月之后，那么过了12个月之后，用户再支付之后，只会收15%的平台费。也就是假设用户买了一个年循环，价格 $10, 第一年事实上我们只收到$7, 那么第二年我们就可以收到$8.5。

对于通过 Google Play 提供的应用以及应用内商品，均须支付交易费用（相当于相应售价的 30%）。您会收到 70% 的付款，剩下的 30% 将用于投放合作伙伴分成和支付运营费用。
自 2018 年 1 月 1 日起，对于您在 12 个付费月后留住的任何订阅者，相应订阅商品的交易费用将降至 15%。如果订阅者自该日期起一直处于活跃状态，此时间将被计入统计信息。例如，如果订阅者处于活跃状态的时间达到 4 个月，则交易费用将在 8 个付费月后降至 15%。
以下信息将计入用户的 12 个付费月中：
* 处于宽限期内的订阅者
* 从帐号保留或宽限期状态恢复订阅的订阅者
* 享受入门价格的订阅者
* 升级或降级至其他方案的订阅者
* 在取消订阅两个月内重新注册的订阅者
以下信息将不会计入用户的 12 个付费月中：
* 免费试用
* 已退款的购买交易
* 帐号保留时间
* 已推迟时间（通过 Google Play Developer API 使用延期结算功能）
https://support.google.com/googleplay/android-developer/answer/112622?hl=zh-Hans

订阅商品一旦激活就没法取消

我们知道有API可以创建商品订单，并且可以设置是单次购买还是循环订阅。但是这边要注意一点的是，一旦创建商品订单，并且激活之后，那么接下来就没法针对这个订阅的商品进行取消激活，也没法删除这个商品，更不能修改订单价格。

1	$postBody->setStatus(self::STATUS_ACTIVE);

他有一个update配置的接口：API PATCH DOC, 然后我之前写了一个指令，看能不能将已经激活订阅的商品，给他取消掉激活

// todo 悲伤的是，这个根本实现不了，因为已经激活的订阅，根本没法取消激活，会报这个错误  Subscription cannot be deactivated.
private function doHandle($sku)
{
    // api: https://developers.google.com/android-publisher/api-ref/inappproducts/get
    try {
        $ap = Factory::newApClient();
        $packageName = config('google.package_name');
        $postBody = new \Google_Service_AndroidPublisher_InAppProduct();
        $postBody->setSku($sku);
        $postBody->setStatus("inactive");
        $postBody->setPackageName($packageName);
        $autoConvertMissingPrices = true;
        $data = $ap->inappproducts->patch($packageName, $sku, $postBody, [
            'autoConvertMissingPrices' => $autoConvertMissingPrices
        ]);
        $this->log->debug(json_encode($data));
    } catch (\Exception $ex) {
        $this->log->error("change google status error:" . $ex->getMessage());
    }
    return null;
}

但是执行结果是这样子的： Subscription cannot be deactivated.

1
2

[2018-04-09 07:25:32] Pay.INFO: google iap change status to  inactive... [] []
[2018-04-09 07:25:34] Pay.ERROR: change google status error:{  "error": {   "errors": [    {     "domain": "androidpublisher",     "reason": "inAppProductDeactivateSubscription",     "message": "Subscription cannot be deactivated."    }   ],   "code": 403,   "message": "Subscription cannot be deactivated."  } }  [] []

~~所以如果要修改价格的话，只能重新创建一个新的订阅商品了~~。
ps: 现在是2019-05-27, 现在循环订阅是可以修改价格了，只不过对于已经订阅的用户来说，还是依然继续用旧价格，新的用户才用新价格了。

单次购买的商品没法复用

我们知道已经激活的订阅商品是不能再被取消激活和修改价钱的，也不能删除。但是单次购买的商品是可以删除的。可以在google play 后台删除。但是删除之后，这个商品id就不能再复用了。
也就是说，假设之前有一个 id 是 month_1 的商品id，那么后台删掉了。这时候你是不能再建一个同样名称的 month_1 的商品的，会报错。也就是说，只要创建商品了，不管这个商品有没有被删掉，这个商品id都是唯一的。后来者都不能再复用

退款问题

google 内购是可以退款的，但是只能退循环订阅的那一种，普通支付不能退款，退款API: API refund DOC,而且很神奇的是，他只能退当期循环支付的钱，并不会把订阅取消掉。也就是说，如果没有把循环取消掉，那么当下一期的循环周期来临的时候，google还是会继续的扣钱的。
所以你如果要退款，并且要终止循环的话，就不能用这个api，而是要用这个api: API revoke DOC, 这个就会把退款和终止循环一起处理。

单次订阅的最长周期

google iap 的单次订阅的最长周期是一年。另外 paypal 和 stripe 的最长单次订阅周期也是一年。

如果是测试账号的订阅，最多可续订6次

如果是用测试账号来进行订阅的话，因为周期非常短，一个月循环5分钟就会到期，而一年的循环30分钟分钟就会到期。
而且这种测试订阅最多可续订6次，也就是从刚开始订阅 {subId} 到 {subId}..5 这样子，最多6单过来之后，接下来 google 那边就会发过来取消循环的 webhook 了，然后就取消循环了。
具体的文档：测试订阅续订

怎么在线上环境判断google iap 是测试账号

之前有遇到一个比较困惑的问题，因为测试原因，所以有时候我们的测试人员会在我们的线上环境用测试账号进行 iap 支付。虽然在6单之后就取消了循环。但是这些支付账单的支付的钱其实是假的，并不会扣钱。
所以最好我们的支付项目要能够区别出来，那些支付属于测试账号支付的，如果是测试账号支付的，那么就要把入库的结算的订单的钱设置为0，这样才不会影响到财务的结算。而google那边 webhook 过来的信息并没有一个字段是说明是测试账号支付的，因此我们很难从 webhook 的信息来判断。
后面想出来的方案就是，因为测试账号的循环周期非常短，而且只能续6次，就会自动取消循环了。所以我们可以根据这个特点去判断是不是测试账号，具体分为以下步骤：

收到取消循环的 webhook
判断这个订阅从创建到取消，中间的间隔不足一天，因为测试账号的续费周期很短，就算一年的，也是 30 分钟续一次，所以一天的时间已经足够测试账号走完全部流程了
判断这个时间段之内，是否有超过 4 单的成功订单，如果有的话，就说明这个是续费账号
找出这些成功订单，然后将库里面的价钱全部改为 0

具体的代码如下：

/**
     * @param FeeGoogleIapRecurring $recurring
     * 处理 测试账号的问题，将fee设置为0，免得影响财务结算
     */
    private function doHandleWhenPayIsTestAccount(FeeGoogleIapRecurring $recurring)
    {
        $createTime = strtotime($recurring->created_at);
        if (time() - $createTime < 86400) {
            // 说明不到一天就取消循环了。这时候就检查一下这段时间有几单是循环支付成功的
            $orders = FeeLog::where('recurring_payment_id', $recurring->base_order_id)
                ->where('status', FeeLog::StatusCompleted)
                ->get();
            $countLen = count($orders);
            $this->log->info("find exist valid: {$recurring->base_order_id}, count: $countLen");
            // 事实上总共会有 6 次，但是如果是超过 4 次的话，基本就是有问题的
            if($countLen > 4){
                $this->log->info("start set fee to 0, account: {$recurring->account_id}");
                foreach ($orders as $order) {
                    $this->log->info("start change fee to 0, fee log id: {$order->id}");
                    $order->fee = 0;
                    $order->save();
                }
            }
        }
    }

这样就可以解决测试账号影响我们的线上数据的问题了。

google iap 的请求数超出限制

早期在没有接入 GCP 的时候，是没有 webhook 的，所以我们早期就做了定时脚本，用来定时检查订单的续费情况。不过有一次发现报了这个错误：

{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "reason": "dailyLimitExceeded",
    "message": "Daily Limit Exceeded. The quota will be reset at midnight Pacific Time (PT). You may monitor your quota usage and adjust limits in the API Console: https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/quotas?project=1000238825303",
    "extendedHelp": "https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/quotas?project=1000238825303"
   }
  ],

后面查了一下，发现是因为今天的api请求连接数已经满了，所以返回错误。而且这个请求次数，每天可以有 20万次，我们竟然把他用完了，也是厉害。

配额
对于使用 Google Play Developer API 的应用来说，初始免费配额被限制为每天 200000 次请求（每款应用）。此配额应当可以满足发布 Activity 和正常的订阅验证需求。

https://developer.android.com/google/play/developer-api.html#quota

如果还想要更多的话，就要单独申请。

关于支付的 developerPayload 字段

在 google 支付的时候，有一个字段可以让google 的内购系统和我们自己的内部订单系统相联系，这个字段就是 developerPayload，它会在 android 客户端进行支付的时候，可以设置，并且在服务端验证的时候，从 google 服务器的返回值 json 中，就可以得到这个字段：

public function getDeveloperPayload()
{
  return $this->developerPayload;
}

之前在做 stripe 支付相关的时候：stripe 支付需要注意的点 -- 持续更新，他们也有一个可以保存用户数据的字段： metadata。
所以我们可以在支付的时候，在 developerPayload 传入我们自己的内部订单号，这样子，就算有时候出现漏单了，但是接收到 webhook 的时候，也可以从这个内部订单号，找到当时支付的记录，从而补订单。
– update 2019-08-16

关于暂停订阅的事情

为了降低取消循环的概率，决定启用暂停订阅这个设置，根据google那边的报告，订阅暂停功能能有效减少大约25%的自愿取消订阅。具体文档。
看了一下文档，这边列个几个需要注意的几个细节：

用户随时可以进行暂停操作，但是真正生效是在当前结算周期结束后才会生效。
暂停期可以选择一周到3个月的时间范围
启用暂停选项后，该选项将在订阅中心和取消流程中显示
一周和三个月的暂停限制随时可能更改，可以随时更改暂停的时间周期
月订阅才能暂停，年订阅不能暂停
要启用暂停功能，您还必须启用帐号保留功能，同时暂停功能要在 play 后台开启
在暂停期结束时，订阅将恢复，并且 Google 会尝试续订订阅。如果恢复成功，订阅将再次变为活动状态。如果由于付款问题导致恢复失败，则用户将进入帐号保留状态。账号保留期只有 30 天，如果在保留期间有恢复订阅，那么 webhook 就会推送 SUBSCRIPTION_RECOVERED 这个消息，如果在此保留期内未恢复订阅，则订阅会被取消，并且用户必须购买新订阅。
在暂停期内，可以选择在暂停期内随时手动恢复订阅，当用户手动恢复订阅时，结算日期将更改为手动恢复日期（这时候结算周期会变）

至于改代码的话，需要改的不多，不过需要注意一点的是，不能因为很长时间用户不付款就取消掉用户的循环，因为用户有可能是出于暂停订阅的状态。
– update 2019-08-16