Android Google应用内支付

Aridvian

前言

之前阅读过一篇通过AIDL方式集成Google支付的文档，想看的，可以去阅读一下。但是呢？这个文档只能适用于API3.0以前的版本，不适用于新版的API，所以还是不推荐去阅读。新的API已经不再支持AIDL的方式。所以现在来说说现在新的集成方式，准备工作这边就不做介绍，有需要的可以参考一下官方Google支付文档，该文档主要讲解的是Google 支付的订阅功能。

准备工作

1.准备 Google Console 官方开发者账号

2.准备支持Google 服务，带Google Play商店的手机

首先

准备工作完成后，这时候需要在 Google Play Console 官方配置一下商品信息，同时在Google Play console页面添加一下沙盒测试，推荐先使用沙盒测试，然后再通过真实环境测试。

注：
   * 商品信息配置的时候，一旦商品生效后，将无法被删除，但是可以修改
   * 从未上传Google 的App，上传内部测试时间几乎和上正式版的时间差不多
   * 添加测试，在应用外，"许可测试"里需要添加人员和在内部测试里添加测试人员

支付流程

引入Google Play支付的包

implementation "com.android.billingclient:billing-ktx:3.0.1"

1.初始化 BillingClient

初始化一下支付方法，在初始化里添加一个监听，主要是用于接收应用中所有交易的更新以及当用户支付完成后，刷新一个购买信息状态

private fun initBillingClient() {
   Log.d(TAG, "startDataSourceConnections")
        if (billingClient == null) {
            billingClient = BillingClient.newBuilder(context)
                .enablePendingPurchases()
                .setListener { billingResult, purchases ->
                    onPurchasesUpdated(billingResult, purchases)
                .build()
        connectToPlayBillingService()
    }

2.与 Google Play 建立连接

连接到 Google Play 的过程是异步操作，所以是需要使用BillingClientStateListener监听，确保能够成功的连接到Google Play

private fun connectToPlayBillingService(): Boolean {
        Log.d(TAG, "connectToPlayBillingService")
        if (billingClient?.isReady != true) {
            billingClient?.startConnection(object : BillingClientStateListener {
                override fun onBillingServiceDisconnected() {
                    Log.d(TAG, "onBillingServiceDisconnected")
                    connectToPlayBillingService()
                override fun onBillingSetupFinished(billingResult: BillingResult) {
                    billingSetup(billingResult)
            return true
        return false
    }

3.与Google Play连接结束

连接结束后，Google Play将会返回 BillingResponseCode 官方文档。连接成功后，展示当前可以购买的商品(即商品信息)，消耗掉上一次购买操作未消耗的商品(也叫确认交易)。 注：连接成功后，必须要核销一下商品，否则会导致商品购买不成功

fun billingSetup(billingResult: BillingResult) {
        when (billingResult.responseCode) {
            BillingClient.BillingResponseCode.OK -> {
                Log.d(TAG, "onBillingSetupFinished successfully")
                querySkuDetailsAsync(BillingClient.SkuType.SUBS, skuS)
                queryPurchasesHistory()
            BillingClient.BillingResponseCode.BILLING_UNAVAILABLE -> {
                Log.d(TAG, billingResult.debugMessage)
            else -> {
                Log.d(TAG, billingResult.debugMessage)
    }

4.展示可供购买的商品

根据 SkuType 官方文档类型来查询对应的商品详情，查询的结果将会返回本地化商品信息(即将查询的信息赋值到本地的List)。请求成功后，调用一下invoke方法，它是kotlin的中一个函数，可能换个写法，这个函数可能看起来比较懵，那就换个写法，它就相当于onSkuDetails(skuDetailsList) 注:在配置应用内商品时创建的唯一商品 ID 将用于向 Google Play 异步查询应用内商品详情

private fun querySkuDetailsAsync(
        @BillingClient.SkuType skuType: String,
        skuList: List<String>
        val params = SkuDetailsParams.newBuilder()
            .setSkusList(skuList)
            .setType(skuType)
            .build()
        Log.d(TAG, "querySkuDetailsAsync for $skuType")
        billingClient?.querySkuDetailsAsync(params) { billingResult, skuDetailsList ->
            when (billingResult.responseCode) {
                BillingClient.BillingResponseCode.OK -> {
                    if (skuDetailsList.orEmpty().isNotEmpty()) {
                        if (skuDetailsList != null) {
                            onSkuDetails?.invoke(skuDetailsList)
                else -> {
                    Log.d(TAG, billingResult.debugMessage)
    }

5.启动购买流程

从支付按钮发起请求，调用成功后，页面将会显示Google Play支付页面，即如图G1:

无法调起以下页面原因：
1.该手机不支持Google服务
2.该手机未安装Google服务三件套
3.Google Play商店“后台弹出界面”的权限被关闭
4.Google Play商店获取手机信息权限被关闭了

区别：

这里和旧的API是不一样的，旧的API，在这里是使用AIDL的方法，将userId绑定到商品信息里。新API是可以直接通过setObfuscatedAccountId(String)的方法，将userId绑定到对应的商品信息内。

fun launchBillingFlow(activity: Activity, skuDetails: SkuDetails, userId: String) {
        val purchaseParams = BillingFlowParams
            .newBuilder()
            .setObfuscatedAccountId(userId)
            //skuDetails对应的商品
            .setSkuDetails(skuDetails)
            .build()
        Log.d(TAG, "launchBillingFlow ${skuDetails.originalJson}")
        billingClient?.launchBillingFlow(activity, purchaseParams)
    }

6.确认购买,支付

Google Play在支付完成后会再调用onPurchasesUpdated()，然后会将结果通过接口返回，用户支付成功后。

Google Play将会生成购买令牌(唯一标识)，同时用户将会收到对应订单的邮件，订单ID(退款需要)，以及扣款通知，同时也可以在Google Play商店看到对应的订单。 BillingResponseCode 官方文档

private fun onPurchasesUpdated(
        billingResult: BillingResult,
        purchases: MutableList<Purchase>?
        Log.d(TAG, "onPurchasesUpdated ${billingResult.responseCode} ${billingResult.debugMessage}")
        when (billingResult.responseCode) {
            BillingClient.BillingResponseCode.OK -> {
                purchases?.apply {
                    for (purchase in purchases) {
                        handlePurchase(purchase)
            BillingClient.BillingResponseCode.ITEM_ALREADY_OWNED -> {
                //购买失败，因为该物品已被拥有，该商品需要被消耗
                Log.d(TAG, billingResult.debugMessage)
                queryPurchasesHistory()
            BillingClient.BillingResponseCode.SERVICE_DISCONNECTED -> {
              //购买失败，Google服务断开，可能网络原因 
                connectToPlayBillingService()
            else -> {
                Log.d(TAG, billingResult.debugMessage)
    }

做到这一步，你是不是感觉已经流程已经结束了，这边可以准确告诉你，它还没有结束，它还需要调用一个消耗交易操作(即确认交易)，如果没有这一步，正常用户会在3天内退款，并且取消这一笔订单，测试用户会在5分钟内取消订单。

7.处理购买交易(消耗，确认交易)

在确认交易之前要判断一下 PurchaseState 官方文档，当购买交易只有处于PURCHASED的状态下，才可以确认交易，不在此状态下的交易，是没有办法进行确认操作的处理交易方式： 1.验证当前购买交易 2.提供内容给用户,并且将"确认内容"传送给用户，并且标志成已消费

注：
如果您在三天内未确认购买交易，用户会自动收到退款，并且 Google Play 会撤消该购买交易
Api2.0以后都是需要确认交易，2.0以前是不需要消耗的

private fun handlePurchase(purchase: Purchase) {
        Log.d(TAG, "handlePurchase ${purchase} isAcknowledged: ${purchase.isAcknowledged}")
        if (purchase.purchaseState == Purchase.PurchaseState.PURCHASED) {
            GlobalScope.launch(Dispatchers.Main) {
                if (!purchase.isAcknowledged) {
                    val acknowledgePurchaseParams = AcknowledgePurchaseParams.newBuilder()
                        .setPurchaseToken(purchase.purchaseToken)
                    withContext(Dispatchers.IO) {
                        billingClient?.acknowledgePurchase(acknowledgePurchaseParams.build()) {}
    }

8.提取购买交易(查询购买交易，也可以叫恢复购买)

当用户进入App的时候，建议在在onResume()和onCreate()调用此方法，主要用于处理用户在App以外购买成功，为什么这么说？因为订阅用户是可以在Google Play商店里，进行续订，购买等操作的，但是购买成功后，同事也会提示用户需要重新回到App，进行确认交易的操作步骤。

存在漏单多种原因:
1.在购买过程中出现网络问题,收到购买交易的通知之前失去了网络连接
2.多台设备：用户在一台设备上购买了一件商品，然后在切换设备时看到该商品
3.处理在您的应用外进行的购买交易(在App外交易)

private fun queryPurchasesHistory() {
        val result = billingClient?.queryPurchases(BillingClient.SkuType.SUBS)
        result?.purchasesList?.apply {
            forEach {
                handlePurchaseHistory(it)
        Log.d(TAG,"queryPurchasesHistory results:${result?.purchasesList} size: ${result?.purchasesList?.size} "
    }

9.调用消耗方法

调用方法之前，先判断一下该订单是否处于可被消耗的状态，在该订单消耗之前，将purchaseToken发送给后端。

private fun handlePurchaseHistory(purchase: Purchase) {
        Log.d(
            TAG,
            "handlePurchaseHistory $purchase handlePurchase.purchaseState: ${purchase.purchaseState} isAcknowledged: ${purchase.isAcknowledged}"
        if (purchase.purchaseState == Purchase.PurchaseState.PURCHASED) {
             GlobalScope.launch(Dispatchers.Main) {
                if (!purchase.isAcknowledged) {
                  // 向后端发送purchaseToken
                          ·····
                    withContext(Dispatchers.IO) {
                        val acknowledgePurchaseParams = AcknowledgePurchaseParams.newBuilder()
                            .setPurchaseToken(purchase.purchaseToken)