Android App sdk-集成Google Pay

概述

Asiabill Android Payment SDK version2.1.2已集成 Google Pay 功能

Google Pay 支付流程

1. 用户点击 Google Pay 按钮

2. Google Pay 弹出支付界面

3. 用户确认支付

4. SDK 调用 services/v3/payment_methods（创建支付方式）

5. 后端返回 paymentMethodId

6. SDK 调用 services/v3/confirmCharge（确认扣款）

7. 后端处理并返回结果（可能含 3DS URL）

8. 如需 3DS：打开 WebView 认证

9. 返回最终支付结果

快速集成

1. 添加依赖

   在项目build.gradle里面添加配置

   repositories {
      jcenter()
      maven{
          url "https://raw.githubusercontent.com/Asiabill/asiabill_android/main"
       }
    }

   在 app 模块的 build.gradle 中添加：

   dependencies {
      implementation "com.asiabill.payment:android_payment:2.1.2"//具体版本号根据你的需求来确定
   }

2. 获取 Google Pay Merchant ID

   在Google Pay Business Console (https://pay.google.com/business/console) 注册并完成审核后获取

3. application实现sdk初始化

public class AsiabillApplication extends Application {
   @Override
   public void onCreate() {
       super.onCreate();
       //SDK initialization and set up the payment environment.
       AsiaBillMobileSdk.init(this,PaymentEnvironment.PRODUCT);
   }
}

使用示例

1. 构建支付参数

   商户收集sessionToken 等相关支付信息，构建PayInfoBean，通过调用SDK里payTask.pay(PayInfoBean)方法传递支付信息。

    PayInfoBean payInfoBean = new PayInfoBean.Builder(SESSION_TOKEN) //会话令牌
   
   // 基础参数
   payInfoBean.setGatewayNo("your_gateway_no");           // 网关编号
   payInfoBean.setMerNo("your_merchant_no");              // 商户编号
   payInfoBean.setSignkey("your_sign_key");               // 签名密钥
   payInfoBean.setCustomerID("cus_123456");               // 用户的customerId
   payInfoBean.setOrderNo("ORDER20260122001");            // 订单号
   payInfoBean.setOrderAmount("99.99");                   // 订单金额
   payInfoBean.setOrderCurrency("USD");                   // 货币代码
   
   // Google Pay 专用参数
   payInfoBean.setGooglepayMerchName("your_googlepay_merchant_name")  //Google Pay Merchant Name
   payInfoBean.setGooglepayMerchId("01234567890123456789");           // Google Pay Merchant ID
   payInfoBean.setTokenPayType("0");                                  // "0" 启用 Google Pay
   
   // 持卡人信息
   payInfoBean.setFirstName("John");
   payInfoBean.setLastName("Doe");
   payInfoBean.setEmail("[e-mail]");
   payInfoBean.setPhone("[phone]");
   
   // 账单地址
   payInfoBean.setAddress("123 Main Street");
   payInfoBean.setCity("New York");
   payInfoBean.setState("NY");
   payInfoBean.setZip("10001");
   payInfoBean.setCountry("US");
   
   // 其他参数
   payInfoBean.setCallbackUrl("https://your-domain.com/callback");
   payInfoBean.setGoodsDetail("Product Description");

2. 启动支付

   商户发起支付后，会进入sdk里的付款界面,点击Gpay支付按钮，拉起谷歌支付控件。

   
3. 处理支付结果

   PayTask payTask = new PayTask(activity);
   String result = payTask.pay(payInfoBean);
   PayResult payResult = new PayResult(result) 
   String code = payResult.getCode();  //支付返回码
   String message = payResult.getMessage();  //支付描述

通过调用上面SDK的支付方法可以返回支付返回码和描述,相关支付返回码状态如下：

payResult.code（返回码）	payment result（订单结果）
9900	Successful purchase （支付成功）
7700	ProFailure purchase （支付失败）
6600	Order pending （交易待处理）
5500	Order canceled （支付取消）

支付过程中，返回结果中redirectUrl为空，则不需要进行3DS验证，将解析后的交易结果返回给SDK端，SDK端跳转用户到交易结果展示页面。

支付过程中，返回结果中redirectUrl不为空，则需要进行3DS验证，将解析后的redirectUrl返回给SDK端，SDK端跳转用户到3DS页面进行验证， 3DS验证完成后，AsiaBill将跳转到商户的returnUrl地址（请参阅 支付结果跳转 ），商户端验证签名并解析数据后，将解析结果（成功、失败）返回给SDK端，SDK端跳转用户到交易结果展示页面。