Android_Google Play结算库(应用内支付)billing 3.0接入实战

 

一、接入摘要
时间:2021-04-19
版本:billing 3.0
语言:java
内容:一次性消耗型商品
老版本比较:当前客户端接入版本对比aidl方式区别巨大,支付透传字段也被废弃,需要开发者做好订单和google订单关联;服务端支付验证也改了流程,开发者需要做更多的操作。
关于google 支付新版本,了解到好多开发者还是用的老版本,为什么不更新?哈哈,因为太坑了。不过现在强制更新,给了具体的时间限制


二、接入流程
Google Play开发者后台创建应用(Google Play)
开发者后台对应项目配置相关信息
安卓端接入(结算库接入文档)
后端商品验证
三、客户端接入
集成依赖库
module的 build.gradle 添加下面代码

dependencies {
...
implementation "com.android.billingclient:billing:3.0.3"
 

dependencies {
    ...
    implementation "com.android.billingclient:billing:3.0.3"
    ...
}

 


支付流程
初始化 BillingClient
与 Google Play 建立连接
自己服务端生成订单再调起 google 购买操作
购买成功拿到相关信息去服务端验证购买合法性
服务端验证商品后进行发货并返回客户端信息,客户端消耗商品
初始化 BillingClient
/**
 

/**
 * 初始化billingClient
 */
private void initBillingClient() {
    mBillingClient = BillingClient.newBuilder(this)
            .setListener(new PurchasesUpdatedListener() {
                @Override
                public void onPurchasesUpdated(@NonNull BillingResult billingResult, @Nullable List<Purchase> purchases) {
                    //交易更新将会在这里回调
                    int responseCode = billingResult.getResponseCode();
                    if (responseCode == BillingClient.BillingResponseCode.OK && purchases != null) {
                        for (Purchase purchase : purchases) {
                            String googlePayOrderId = purchase.getOrderId();
                            String purchaseToken = purchase.getPurchaseToken();
                            //服务器验证
                            verifyPayment(orderId, googlePayOrderId, productId, purchaseToken);
                        }
                    } else if (responseCode == BillingClient.BillingResponseCode.USER_CANCELED) {
                        //取消支付
                    } else if (responseCode == BillingClient.BillingResponseCode.ITEM_ALREADY_OWNED) {
                        //已存在这个未完成订单,查询订单验证然后消耗掉
                        queryPurchases();
                    } else {
                        //还有很多其他状态,判断进行相应处理
                    }
                }
            })
            .enablePendingPurchases()
            .build();

}
 

 

与 Google Play 建立连接
/**
* 与Google Play建立连接
*/

private void startConnection() {
mBillingClient.startConnection(new BillingClientStateListener() {
@Override
public void onBillingSetupFinished(@NonNull BillingResult billingResult) {
//链接成功最好去查询订单,做掉单处理
if (billingResult.getResponseCode() == BillingClient.BillingResponseCode.OK) {
queryPurchases();
}
}

 

@Override
public void onBillingServiceDisconnected() {
// Try to restart the connection on the next request to
// Google Play by calling the startConnection() method.
//建议断开时重连或在使用时判断连接状态,没有连接就手动再调一次 startConnection,确保在执行任何方法时都与 BillingClient 保持连接。
}
});

 

发起购买
先展示商品再发起购买

/**
* 购买商品
*/

private void purchase() {
//先展示商品
List<String> skuList = new ArrayList<>();
skuList.add(productId);
SkuDetailsParams.Builder params = SkuDetailsParams.newBuilder();
params.setSkusList(skuList).setType(BillingClient.SkuType.INAPP);//INAPP应用内支付
mBillingClient.querySkuDetailsAsync(params.build(),
new SkuDetailsResponseListener() {
@Override
public void onSkuDetailsResponse(BillingResult billingResult, List<SkuDetails> skuDetailsList) {
if (billingResult.getResponseCode() == BillingClient.BillingResponseCode.OK && skuDetailsList != null) {
for (SkuDetails skuDetails : skuDetailsList) {
String sku = skuDetails.getSku();
if (productId.equals(sku)) {
//启动购买
BillingFlowParams purchaseParams =
BillingFlowParams.newBuilder()
.setSkuDetails(skuDetails)
.build();
mBillingClient.launchBillingFlow(TestBilling.this, purchaseParams);
//购买状态将在PurchasesUpdatedListener.onPurchasesUpdated返回
}
}
}
}
});
//
}

 

服务端验证
这一步骤具体逻辑在服务端,接入是跟服务端人员沟通配合完成

/**
* 验证支付,需要后端处理
*
* @param orderId 我们自己的订单号,一般客户端调起支付前会在自己服务端下单
* @param gpOrderId google商品订单号
* @param productId 商品id
* @param purchaseToken 商品token
*/
private void verifyPayment(String orderId, String gpOrderId, String productId, String purchaseToken) {
//这一步操作就是写个网络请求,把支付相关信息传到后端进行验证合法性,后端验证返回客户端,验证成功将消耗商品

}
 
查询购买
/**
* 查询购买交易,以确保所有购买交易都得到成功处理,如购买未发货,或者未消耗
*/
private void queryPurchases() {
if (mBillingClient != null && mBillingClient.isReady()) {
Purchase.PurchasesResult result = mBillingClient.queryPurchases(BillingClient.SkuType.INAPP);
List<Purchase> purchasesList = result.getPurchasesList();
if (purchasesList != null) {
for (int i = 0; i < purchasesList.size(); i++) {
if (purchasesList.get(i).isAcknowledged()) {
//已确认/已验证,消耗即可
consume(purchasesList.get(i).getPurchaseToken());
} else {
//TODO 因google支付新版没有透传字段,所以我们的订单号需要手动关联,
// 数据库查询gp订单对应的我方订单号或者服务端进行订单关联
// 关于这一块后续看是否google有新的改动优化
Purchase purchase = purchasesList.get(i);
String gpOrderId = purchase.getOrderId();
String orderId = "";//我们自己的订单号,如果是程序刚启动进来补单的,那么我们的订单就拿不到,因为google不携带透传,自己做处理吧
String sku = purchase.getSku();
String purchaseToken = purchase.getPurchaseToken();
verifyPayment(orderId, gpOrderId, sku, purchaseToken);
}
}
}

}
}
 
消耗商品
/**
* 消耗商品
*
* @param purchaseToken 商品token
*/
private void consume(String purchaseToken) {
if (mBillingClient != null && mBillingClient.isReady()) {
ConsumeParams consumeParams =
ConsumeParams.newBuilder()
.setPurchaseToken(purchaseToken)
.build();
ConsumeResponseListener listener = new ConsumeResponseListener() {
@Override
public void onConsumeResponse(BillingResult billingResult, String purchaseToken) {
if (billingResult.getResponseCode() == BillingClient.BillingResponseCode.OK) {
// Handle the success of the consume operation.
}
}
};
mBillingClient.consumeAsync(consumeParams, listener);
}
}
 
断开连接
@Override
public void onDestroy(Activity activity) {
if (mBillingClient!= null && mBillingClient.isReady()) {
mBillingClient.endConnection();
}
}
 

四、服务端验证流程
初次接入新版本也是相当麻烦,如不懂流程在官方文档上会摸不着头脑
总结有几个步骤

1、创建 API 项目
Google Play 开发者后台对应项目新建API项目(Google Play Developer API)并启动API服务和关联到Google Play 项目

参考地址:https://developers.google.cn/android-publisher/getting_started

2、创建 OAuth 客户端
API 项目下新建OAuth 客户端,应用类型选择网页应用,其他的看情况填写,确认创建之后获取到客户端ID(client_id)和客户端秘钥(client_secret)还有client_secret_xxx.json文件,内容如下:

{
"web":{
"client_id":"916683014888-479gobska5u85hho2hnb03296lcr9pii.apps.googleusercontent.com",
"project_id":"api-8972885819834575872-739232",
"auth_uri":"https://accounts.google.com/o/oauth2/auth",
"token_uri":"https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url":"https://www.googleapis.com/oauth2/v1/certs",
"client_secret":"5J8jjMVx4o5bvvkqzku1DzMl",
"redirect_uris":[
"xxx"
],
"javascript_origins":[
"xxx"
]
}
}
 
以上参数都是用在服务端调用google api,客户端ID和客户端秘钥并非Android客户端参数,服务端这里的所以参数都跟Android端没有啥关系

3、获取code
这一步的操作是需要开发者账号登录网页,然后在网页打开这个链接(https://accounts.google.com/o/oauth2/auth?scope=https://www.googleapis.com/auth/androidpublisher&response_type=code&access_type=offline&redirect_uri=xxx&client_id=xxx)进行授权,redirect_uri就是创建 OAuth 客户端填写的重定向链接。授权成功后会把code通过redirect_uri返回。如果redirect_uri是随便填的,访问出现404页面或者无法访问的提示,这时候请将地址栏中的链接地址复制出来,把code=4/xxx的值取出来,这里就获得了code的值4/wtedvcqw-yui5CNNb-m2iI83KQx1d.yp6198ti5Zc7dJ3UXOl0T3aRLxWrtgbn

4、 通过 code 获取 refresh_token
重要的事情说三遍 保存 保存 保存 第一次授权的时候才会返回refresh_token(长令牌,一般情况下永久有效) ,请妥善保存。
不过在调试阶段没保存的小伙伴也不用太过担心,可以在 OAuth 客户端选择重置秘钥或者新建 OAuth 客户端,记得服务端把参数替换哦。这时候再走一遍流程就可以再次授权获得refresh_token

POST请求到https://accounts.google.com/o/oauth2/token

请求参数:

grant_type:authorization_code
code:步骤 3 获取到的code
client_id:客户端id
client_secret:客户端秘钥
redirect_uri:重定向地址

结果返回:

{
"access_token":"xxx",
"expires_in":3599,
"refresh_token":"1//xxx",
"scope":"https://www.googleapis.com/auth/androidpublisher",
"token_type":"Bearer",
"created":16193255555
}
 
5、通过 refresh_token 获取 access_token
POST方式调用https://accounts.google.com/o/oauth2/token

请求参数:

grant_type:refresh_token
client_id:客户端id
client_secret:客户端秘钥
refresh_token:步骤 4 获取的refresh_token值

结果返回:

{
"access_token":"xxx",
"token_type":"Bearer",
"expires_in":3600
}
 
6、查询订单信息
其实就是所谓的验证
一次性消耗型商品参考官网地址:https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.products/get

GET方法调用以下接口: https://www.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/products/{productId}/tokens/{token}?access_token=access_token

packageName:该应用的包名, 如com.google.demo

productId:商品ID

token:Android端充值获取的token值

access_token:步骤 5 获取的access_token

如果订单有效会返回相关信息

{
"kind": “androidpublisher#productPurchase”,
"purchaseTimeMillis": “支付时间”,
"purchaseState": 0,// 是否付费: 0 已支付, 1 取消
"consumptionState": 0, // 是否被消费: 0 未消费, 1 已消费,
"developerPayload": "",//透传字段,新版这个客户端没法传了
"orderId": “GPA-XXX”,//google的订单号
"purchaseType": 0, // 支付类型: 0 测试, 1 真实
"acknowledgementState": 0,//商品的确认状态, 0 尚未被确认, 1 确认
"purchaseToken": "token",//购买令牌,即客户端支付商品token
"productId": “sss”,//商品id
"quantity": 1,//数量
"obfuscatedExternalAccountId": “”,
"obfuscatedExternalProfileId": “”,
"regionCode": “”
}

 
可根据返回的信息作相应的验证

如果订单无效会返回400错误

如果返回403错误
1、检查api项目启动状态
2、检查api项目关联状态
3、OAuth 客户端参数与服务端使用是否一致
4、谷歌服务的 bug,这时候只要在该应用的商店内,随意增加一个内购商品,再试一次看看是否可行,新增的内购商品可以删除。

{
"error": {
"errors": [{
"domain": "androidpublisher",
"reason": "projectNotLinked",
"message": "The project id used to call the Google Play Developer API has not been linked in the Google Play Developer Console."
}],
"code": 403,
"message": "The project id used to call the Google Play Developer API has not been linked in the Google Play Developer Console."
}
}
 
五、收工
————————————————
版权声明:本文为CSDN博主「kincai」的原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/hqiong208/article/details/116162203

上一篇:win11安卓子系统virtwifi无法访问互联网


下一篇:规划并优化能在 Google Play 上取得更大成功的游戏