谷歌 Google Play 内购支付

小艾

PHP/Tutorial

发布于：Jan 21, 2024

2.1k words

7 min

谷歌支付相较于苹果支付，会麻烦许多，需要配置和注意的东西比较多。

这篇笔记会把遇到的一些坑，一一列举出来，以下是正文。

支付流程

谷歌支付流程和苹果支付流程有很多相似的地方，下面是谷歌支付流程：

App 从 Google Play 获取产品信息
用户选择需要购买/订阅的产品
App 发送支付请求到 Google Play
Google Play 处理支付请求，返回 Purchase Token 等信息
App 将 Purchase Token 发送到服务端
服务端收到收据后，发送到 Google Play 验证收据的有效性
Google Play 返回收据的验证结果
根据 Google Play 返回的结果，决定用户是否购买成功

Google Play Developer Api 身份认证

在上面的过程中，需要请求 Google Play Developer Api，这里就需要解决一个问题：如何进行身份认证。

Google Play Developer Api 提供两种方式进行身份认证：

OAuth 2.0
服务账号

OAuth2.0

网上许多教程都是使用 OAuth2.0 方式授权 Api，虽然也是能实现，但是需要通过 Web 页面进行授权，因此并不适用于 App 的使用场景，后面会在另外一篇笔记中，详细记录如何通过该方式进行身份认证。

更多有关 OAuth2.0 的介绍，可以查看 Google 官方的说明——使用OAuth 2.0 授权。

服务账号

通俗点说，服务账号是一种特殊的账号，用于进行身份认证，使用它可以访问该服务账号有权访问的所有资源。

更多有关服务账号的介绍，可以查看 Google 官方的说明——服务账号概览。

下面将介绍如何创建服务账号以及授权 Google Play Developer Api。

正式开始之前，首先得有一个 Google 开发者账号，如果没有直接去注册一个，不过需要注意的是，注册需要支付 25 美元的一次性注册费。

在 Google Cloud Console 中启用 Google API

转到Google Cloud Console
从项目列表中选择项目或创建一个新项目
转到API & Services，然后单击 Enable Apis and Services 按钮

在API Library中，搜索Google Play Android Developer Api和Google Play Developer Reporting Api。

为项目启用这两个Api

创建服务账号

转到Google Cloud Console => IAM 和管理 => 服务帐户
单击创建服务帐户

输入服务帐户名称，复制其ID，然后单击创建并继续
授予此服务账号访问权限

Pub/Sub 管理员（启用Google 开发者通知）

监控查看器（允许监控通知队列）

跳过最后一步并单击完成

创建并下载服务密钥

转到Google Cloud Console 中的服务帐户部分，选择最近创建的密钥，选择管理密钥。

单击添加密钥按钮，然后创建新密钥

在弹出窗口中，确保选择 JSON，然后单击创建，以生成 JSON 密钥并将其下载

下载的密钥要保存好，后续会用到。

授权对应用的访问

导航至Google Play Console 中的用户和权限部分，然后单击邀请新用户。

输入之前创建的服务账号的邮箱地址，添加到应用程序，然后单击应用
授予账户权限，然后单击页面底部的邀请用户，下一步会被引导至用户和权限部分，授予下图中勾选的权限即可。

至此，服务账号的准备工作就全部做完了，但是这个服务账号还不能马上使用。

这是因为 Google 服务凭证最多需要 24 小时，才能与 Google Developer Api 正常工作。

在此期间，如果使用了该服务账号，Google Play Developer Api 可能会返回以下错误当前用户没有足够的权限来执行请求的操作。

此时需要做的事情就是，等待就好了。

刚开始接入 Google Play Developer Api 时，并不知道这个坑，毕竟过往几乎所有的配置，都是实时生效的。

所以就导致，总以为是自己的问题，哪里的什么权限没有给到。

查阅各种资料，联系Google 技术支持，在这个地方，耗费了大量时间。。。

使用服务帐户进行身份验证

等待 24 小时之后，找到前面下载的 JSON 密钥文件。

可以使用 Google Api 官方提供的 google-api-php-client，也可以使用 Laravel In-App purchase，进行身份验证。

这里以 Laravel In-App purchase 为例：

use Imdhemy\Purchases\Facades\Subscription;

class IAP {
    public function iapSubscribe () {
      $subscriptionReceipt = Subscription::googlePlay()->id($params['product_id'])->token($params['purchase_token'])->get();
      
      // 谷歌订单号
      $orderId = $subscriptionReceipt->getOrderId();
      //购买状态，0. 付款待处理 1. 付款已收讫 2. 免费试用 3. 待推迟升级/降级
      $purchaseState = $subscriptionReceipt->getPaymentState();

      // 订阅的购买类型, 0. 测试（即通过许可测试帐号购买）1.促销（即使用促销代码购买）
      $purchaseType = $subscriptionReceipt->getPurchaseType();

      // acknowledgementState，是否已经确认，0. 尚未确认 1. 已确认
      $acknowledgementState = $subscriptionReceipt->getAcknowledgementState();

      // cancelReason，订阅被取消或未自动续订的原因，0. 用户取消订阅，1. 系统（例如由于结算问题）取消订阅 2. 订阅被替换为新订阅 3. 开发者已取消订阅

      if ($purchaseState == 1) { 
          // todo 购买成功业务逻辑
      }
  }
}