管理中心
我的
指南应用内支付服务VR支付服务客户端开发

客户端开发

本文只介绍Android侧集成应用内支付的方法,以帮助您快速了解华为支付提供的客户端接口及其调用方法。开发者进行VR应用开发时需编写java中间件,将集成好HMS的module打成jar包或aar包放入3D开发引擎中。

对于使用自定义价格支付pay接口的您需要完成如下开发步骤:

  1. 连接HuaweiApiClient;
  2. 调用pay自定义价格支付接口完成支付;
  3. 处理支付结果。

另外对于有自己应用服务器的您需要完成支付回调服务器的开发工作,详细步骤参见服务端开发。

商品购买流程

当前版本的VR支付调用pay自定义价格支付接口完成支付,购买流程图如下:

连接HuaweiApiClient

调用支付接口之前需构建并连接HuaweiApiClient,确保HMS Core SDK和HMS Core APK的连接,方法如下:
收起
自动换行
深色代码主题
复制
  1. Context context = this.getApplicationContext();
  2. mClient = getApiClient(context);
  3. if (mClient != null && !mClient.isConnected()) {
  4. startConnect();
  5. }
  6. private void startConnect() {
  7. Log.i("IAP", "startConnect");
  8. // 执行连接
  9. mClient.connect(MainActivity.this);
  10. }
  11. // 获取Api Client
  12. private HuaweiApiClient getApiClient(Context context) {
  13. return new HuaweiApiClient.Builder(context)
  14. .addApi(HuaweiPay.PAY_API)
  15. .addConnectionCallbacks(new HuaweiApiClient.ConnectionCallbacks() {
  16. @Override
  17. public void onConnected() {
  18. Log.i("IAP", "onConnected");
  19. onConnectResult(CONNECT_STATUS_SUCCUSS);
  20. }
  21. @Override
  22. public void onConnectionSuspended(int i) {
  23. Log.i("IAP", "onConnectionSuspended");
  24. onConnectResult(CONNECT_STATUS_SUSSPAND);
  25. }
  26. })
  27. .addOnConnectionFailedListener(new HuaweiApiClient.OnConnectionFailedListener() {
  28. @Override
  29. public void onConnectionFailed(ConnectionResult connectionResult) {
  30. Log.i("IAP", "onConnectionFailed");
  31. onConnectResult(CONNECT_STATUS_FAILED);
  32. }
  33. })
  34. .build();
  35. }
  36. // 连接结果处理
  37. private void onConnectResult(int connectStatus) {
  38. if (connectStatus == CONNECT_STATUS_SUCCUSS) {
  39. if (mClient != null && mClient.isConnected()) {
  40. Log.i("IAP", "connect success");
  41. // 连接成功,开始支付
  42. startPay();
  43. }
  44. } else if (connectStatus == CONNECT_STATUS_SUSSPAND) {
  45. Log.i("IAP", "connect suspend");
  46. startConnect();
  47. } else if (connectStatus == CONNECT_STATUS_FAILED) {
  48. Toast.makeText(this, "client connect failed", Toast.LENGTH_SHORT).show();
  49. }
  50. }

封装PayReq支付请求参数

创建并封装PayReq对象。PayReq对象属性的详细信息请参见pay。

收起
自动换行
深色代码主题
复制
  1. private PayReq createPayReq(String productName, String productDesc, String amount) {
  2. Map<String, Object> params = new HashMap<String, Object>();
  3. params.put(HwPayConstant.KEY_MERCHANTID, Constant.getMerchantID());
  4. params.put(HwPayConstant.KEY_APPLICATIONID, Constant.getAppID());
  5. params.put(HwPayConstant.KEY_PRODUCTNAME, productName);
  6. params.put(HwPayConstant.KEY_PRODUCTDESC, productDesc);
  7. requestID = Util.getRequestID();
  8. params.put(HwPayConstant.KEY_REQUESTID, requestID);
  9. params.put(HwPayConstant.KEY_SDKCHANNEL, 1);
  10. params.put(HwPayConstant.KEY_URLVER, "2");
  11. params.put(HwPayConstant.KEY_AMOUNT, Util.getAmount(amount));
  12. params.put(HwPayConstant.KEY_URL, "https://selfURL.cn");
  13. params.put(HwPayConstant.KEY_COUNTRY, "CN");
  14. params.put(HwPayConstant.KEY_CURRENCY, "CNY");
  15. // 强烈建议在商户服务端做签名处理,且私钥存储在服务端
  16. // PaySignUtil为自定义签名工具类,实现方法可参加示例代码
  17. String noSign = PaySignUtil.getSignData(params);
  18. String sign = PaySignUtil.rsaSign(noSign);
  19. PayReq payReq = new PayReq();
  20. // 商品名称,必填。此名称将会在支付时显示给用户确认。注意:该字段中不能包含特殊字符,包括# " & / ? $ ^ *:) \ < > ,
  21. payReq.productName = (String) params.get(HwPayConstant.KEY_PRODUCTNAME);
  22. // 商品描述,必填。注意:该字段中不能包含特殊字符,包括# " & / ? $ ^ *:) \ < > , |
  23. payReq.productDesc = (String) params.get(HwPayConstant.KEY_PRODUCTDESC);
  24. // 商户ID,必填。由华为开发者联盟分配
  25. payReq.merchantId = Constant.getMerchantID();
  26. // 应用ID,必填。由华为开发者联盟分配
  27. payReq.applicationID = (String) params.get(HwPayConstant.KEY_APPLICATIONID);
  28. // 待支付金额,必填。格式为:元.角分,最小金额为分, 例如:20.00,此金额将会在支付时显示给用户确认),保留到小数点后两位
  29. payReq.amount = (String) params.get(HwPayConstant.KEY_AMOUNT);
  30. // 请求订单号,必填。其值由商户定义生成,用于标识一次支付请求,每次请求需唯一,不可重复。
  31. // 支付平台在服务器回调接口中会原样返回requestId的值。
  32. // 注意:该字段中不能包含特殊字符,包括# " & / ? $ ^ *:) \ < > , |
  33. payReq.requestId = (String) params.get(HwPayConstant.KEY_REQUESTID);
  34. // 支付结果回调URL,选填。华为服务器收到后检查该应用有无在开发者联盟配置回调URL,如果配置了则使用应用配置的URL,否则使用此url
  35. // 作为该次支付的回调URL
  36. // 建议直接以配置在华为开发者联盟的回调URL为准
  37. payReq.url = (String) params.get(HwPayConstant.KEY_URL);
  38. // 渠道信息,选填。取值如下:0代表自有应用,无渠道;1代表智汇云渠道;2代表预装渠道;3代表游戏
  39. payReq.sdkChannel = (Integer) params.get(HwPayConstant.KEY_SDKCHANNEL);
  40. // 回调接口版本号,选填。建议传值2,额外回调信息,具体参见接口文档
  41. payReq.urlVer = (String) params.get(HwPayConstant.KEY_URLVER);
  42. // 国家/地区码,选填。建议无特殊需要,不传
  43. payReq.country = (String) params.get(HwPayConstant.KEY_COUNTRY);
  44. // 币种,选填。建议无特殊需要不传此参数。目前仅支持CNY,默认CNY
  45. payReq.currency = (String) params.get(HwPayConstant.KEY_CURRENCY);
  46. /* 以上字段皆需要参与签名 * */
  47. // 签名字段 必填。采用华为开发者联盟分配的私钥进行签名,强烈建议在服务端进行签名 .
  48. // 【注意】以下参数不参与签名:
  49. // a)sign参数
  50. // b)参数说明中标识不参与签名的参数
  51. // c)没有值的参数,包括null和“”两种情况
  52. // 2、排序完成之后,再把所有参数名和参数值的键值对以“&”字符连接起来,得到的字符串即为待签名串。如:
  53. // amount=XXX&applicationID=XXX&country=XXX&currency=XXX&merchantId=XXX&productDesc=XXX&productName=XXX&requestId=XXX&
  54. //sdkChannel=XXX&url=XXX&urlver=XXX
  55. // 3、将待签名字符串使用RSA私钥进行签名,采用 SHA256WithRSA签名算法 得到的字符串即为sign参数的值
  56. payReq.sign = sign;
  57. // 商户名称,必填,不参与签名。会显示在支付结果页面
  58. payReq.merchantName = getString(R.string.merchantName);
  59. // 分类,选填,不参与签名。该字段会影响风控策略
  60. // X4:主题 X5:应用商店 X6:游戏 X7:天际通 X8:云空间 X9:电子书 X10:华为学习 X11:音乐 X12 视频
  61. // X31 话费充值 X32 机票/酒店 X33 电影票 X34 团购 X35 手机预购 X36 公共缴费 X39 流量充值
  62. payReq.serviceCatalog = "X6";
  63. return payReq;
  64. }

对于有服务器的非单机应用,强烈建议您在自己的应用服务器端保存签名私钥,并在服务器端完成签名操作,避免私钥的泄露,参见服务端开发。但是对于没有服务器的单机应用,您可以本地封装方法获取支付签名信息,此时请您自行确保私钥的安全性,签名方法如下。

签名方法:

  1. 构造源串。

    将支付参数中需要参与签名的参数(参与签名的参数是指payReq中标识需要签名的参数,值为空<包括null和"">的不参与签名),按参数名的ASCII码的增序排序,若遇到相同首字母,则看第二个字母,以此类推。

    例如:BankId=JUNNETNET&amount=2.00&ifyTime=1353317037173&orderId=918370122485714G&payType=2&productName=珍珠项链&requestId=1352286825177&result=0&userName=lilan

  2. 生成签名值。
    1. 将源串使用RSA算法(SHA256WithRSA)进行签名。
    2. 将签名后的字符数组经过Base64.encode编码,生成签名值。

调用pay自定义价格支付接口

自定义价格pay支付接口仅限于国内开放,适用您对单个国家/地区提供的商品或服务自行定价或随时修改价格的场景,您无需使用华为PMS系统进行商品全球定价。可以帮助您快速实现应用内支付功能。

收起
自动换行
深色代码主题
复制
  1. private void startPay() {
  2. PendingResult<PayResult> payResult =
  3. HuaweiPay.HuaweiPayApi.pay(mClient, createPayReq("黄金会员", "开通会员服务", "0.01"));
  4. payResult.setResultCallback(new ResultCallback<PayResult>() {
  5. @Override
  6. public void onResult(PayResult payResult) {
  7. if (payResult == null) {
  8. Log.e("IAP", "payResult is null");
  9. return;
  10. }
  11. Status status = payResult.getStatus();
  12. if (status == null) {
  13. Log.e("IAP", "status is null");
  14. return;
  15. }
  16. int rstCode = status.getStatusCode();
  17. if (rstCode == PayStatusCodes.PAY_STATE_SUCCESS) {
  18. //启动支付流程
  19. try {
  20. status.startResolutionForResult(MainActivity.this, REQUEST_PAY);
  21. } catch (IntentSender.SendIntentException e) {
  22. Log.e("IAP", "SendIntentException");
  23. }
  24. } else {
  25. Log.e("IAP", "pay state failed");
  26. }
  27. }
  28. });
  29. }

支付结果处理

在onActivityResult中获取支付结果,调用getPayResultInfoFromIntent接口解析支付结果。

收起
自动换行
深色代码主题
复制
  1. @Override
  2. protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
  3. super.onActivityResult(requestCode, resultCode, data);
  4. if (requestCode == REQUEST_PAY) {
  5. if (resultCode == Activity.RESULT_OK) {
  6. // 获取支付完成信息
  7. PayResultInfo payResultInfo = HuaweiPay.HuaweiPayApi.getPayResultInfoFromIntent(data);
  8. dealPayResult(payResultInfo);
  9. }
  10. }
  11. }
  12. private void dealPayResult(PayResultInfo payResultInfo) {
  13. if (payResultInfo == null) {
  14. return;
  15. }
  16. int retuenCode = payResultInfo.getReturnCode();
  17. if (retuenCode == PayStatusCodes.PAY_STATE_SUCCESS) {
  18. Toast.makeText(this, "支付成功", Toast.LENGTH_SHORT).show();
  19. boolean checkRst = PaySignUtil.checkSign(payResultInfo, Constant.getPublicKey());
  20. if(checkRst){
  21. // 支付成功且验签成功,发放商品
  22. Log.i("IAP", "pay success");
  23. } else {
  24. // 签名失败,需要查询订单状态:对于没有服务器的单机应用,调用查询订单接口查询;其他应用到开发者服务器查询订单状态
  25. startQueryOrder();
  26. }
  27. } else {
  28. dealPayResultErrCode(retuenCode);
  29. }
  30. }
  31. /**
  32. * 支付失败处理
  33. * @param returnCode
  34. */
  35. public void dealPayResultErrCode(int returnCode) {
  36. Log.e("IAP", "dealPayResultErrCode");
  37. switch (returnCode) {
  38. case PayStatusCodes.PAY_STATE_CANCEL:
  39. // 用户取消支付
  40. break;
  41. case PayStatusCodes.PAY_STATE_NET_ERROR:
  42. // 网络连接异常
  43. break;
  44. case PayStatusCodes.PAY_STATE_PARAM_ERROR:
  45. // 参数错误,包括无参
  46. break;
  47. case PayStatusCodes.PAY_STATE_TIME_OUT:
  48. // 支付结果查询超时(建议此时客户端去服务器查询订单是否支付成功)
  49. break;
  50. default:
  51. break;
  52. }
  53. }

支付结果校验说明:

当出现以下情况时需要查询订单实际状态:

  • 支付过程异常中断

  • 支付结果码为-1005、30005、30002

  • 结果码为0但是验签失败

对于非单机应用(应用有自己的服务器端)由于支持支付结果回调自己的应用服务器,客户端需要访问自己的服务器确认是否支付成功的情况,具体开发者客户端和开发者服务器的支付验证接口协议,由开发者客户端和开发者服务器自行协定。

对于单机应用(应用无自己的服务器端)需要自己封装接口进行签名操作,封装方法可以参见服务端开发。

订单查询(单机应用)

对于一些单机应用,由于没有服务器的支持,在用户支付之后可能由于出现异常(网络错误、进程被杀等等)导致应用无法知道用户实际是否支付成功,即出现所谓的漏单情况。针对这种情况,华为支付提供了订单查询能力。在发起支付请求时,应用需持久保存requestId,在可能丢单的情况下,调用订单查询能力来查询实际支付结果。

封装OrderRequest订单请求参数,调用getOrderDetail接口查询订单:

收起
自动换行
深色代码主题
复制
  1. private void startQueryOrder() {
  2. PendingResult<OrderResult> orderDetail = HuaweiPay.HuaweiPayApi.getOrderDetail(mClient, createOrderRequest(requestID));
  3. orderDetail.setResultCallback(new ResultCallback<OrderResult>() {
  4. @Override
  5. public void onResult(OrderResult orderResult) {
  6. Log.i("IAP", "startQueryOrder success");
  7. if (orderResult.getReturnCode() == OrderStatusCode.ORDER_STATE_SUCCESS) {
  8. // 订单查询成功
  9. boolean orderSignCheck = PaySignUtil.checkSign(orderResult, Constant.getPublicKey());
  10. if (orderSignCheck) {
  11. // 支付成功且验签成功,发放商品
  12. } else {
  13. // 订单验签失败
  14. Log.i("IAP", "orderResult checkSign failed");
  15. }
  16. } else {
  17. // 订单查询失败
  18. Log.i("IAP", "getOrderDetail failed");
  19. }
  20. }
  21. });
  22. }
  23. private static OrderRequest createOrderRequest(String requestId) {
  24. String merchantId = Constant.getMerchantID();
  25. String time = String.valueOf(System.currentTimeMillis());
  26. OrderRequest orderRequest = new OrderRequest();
  27. orderRequest.setRequestId(requestId);
  28. orderRequest.setKeyType("1");
  29. orderRequest.setMerchantId(merchantId);
  30. orderRequest.setTime(time);
  31. //以上信息按照一定规则进行签名,建议CP在服务器端储存签名私钥,并在服务器端进行签名操作。
  32. Map<String, Object> params = new HashMap<>();
  33. // 商户ID
  34. params.put(HwPayConstant.KEY_MERCHANTID, merchantId);
  35. // 商户订单号,支付前生成用来唯一标识一次支付请求
  36. params.put(HwPayConstant.KEY_REQUESTID, requestId);
  37. // 固定值,请填写:1
  38. params.put("keyType", "1");
  39. params.put("time", time);
  40. String noSign = PaySignUtil.getSignData(params);
  41. String sign = PaySignUtil.rsaSign(noSign);
  42. orderRequest.setSign(sign);
  43. return orderRequest;
  44. }