快速接入

h5Url处理

通过H5预下单接口获取h5Url后可对参数做进一步处理：

1. query参数拼接paymentTools=wechat_micropay，则会自动跳转微信支付（需商户已开通间联微信支付能力）。
2. query参数拼接paymentTools=petalpay，则会自动使用华为支付。
3. query参数不拼接paymentTools参数，则h5Url将根据加载环境显示页面。

不同的参数拼接处理，支付时h5Url加载效果会有所区别，具体可参见浏览器环境加载h5Url。

App内webView加载h5Url

商户客户端获取h5Url后通过应用webView组件加载该URL来拉起华为支付收银台完成支付。

1. h5Url可能会通过deeplink链接的方式拉起华为支付收银台、华为钱包、微信app，建议对hms://、petlapay://、weixin:// 协议的请求放通。

• HarmonyOS应用WebView处理加载h5Url后的重定向示例如下：

  // API 9以下的代码示例
  webView.setWebAgent(new WebAgent() { 
          @Override 
          public boolean isNeedLoadUrl(WebView webView, ResourceRequest request) { 
              if (request == null || request.getRequestUrl() == null) { 
                  LogC.i(TAG,"WebAgent isNeedLoadUrl:request is null.", false); 
                  return false; 
              } 
              String url = request.getRequestUrl().toString(); 
              if (url.startsWith("hms:")) { 
                  Intent deepLinkIntent = new Intent(); 
                  Uri deeplink = Uri.parse(url); 
                  try { 
                      Operation operation = new Intent.OperationBuilder() 
                              .withUri(deeplink) 
                              .withDeviceId("") 
                              .withFlags(Intent.FLAG_NOT_OHOS_COMPONENT) 
                              .build(); 
                      deepLinkIntent.setOperation(operation); 
                      startAbility(deepLinkIntent); 
                      return  false; 
                  } catch (Exception e) { 
                      return false; 
                  } 
              } 
              webView.load(url); 
              return false; 
          } 
      });
  
  // API 9及以上的代码示例
   Web({
          src: '',
          controller: this.webviewController
        }).onInterceptRequest((event) => {
          // 拦截页面请求
          if (!event.request.getRequestUrl().startsWith("hms")) {
            return null;
          }
          payService.hwPayService.pay(getContext(this) as common.UIAbilityContext, event.request.getRequestUrl());
        })
  public async pay(context: common.UIAbilityContext, uri: string): Promise<void> {
      if (uri && context) {
        let want:Want =
          {
            action: "ohos.want.action.viewData",
            flags: 0x10000000,
            uri: uri // hmsdeeplink链接
          };
        await context.startAbility(want).then((data) => {
          Logger.info(HWPayServiceImpl.TAG, "aggr start pay");
        }).catch(e => {
          Logger.error(HWPayServiceImpl.TAG, "aggr start pay error: " + e.message);
        });
        return;
      }
      throw new Error('context or uri CANNOT be undefined or null');
    }

• Android应用webView处理加载h5Url后的重定向示例如下：

  public boolean shouldOverrideUrlLoading(WebView view, String url) { 
          Log.d(TAG, "WebView shouldOverrideUrlLoading" + url); 
          try { 
              if (url.startsWith("hms:")) { 
                  Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url)); 
                  startActivity(intent); 
                  return true; 
              } 
          } catch (Exception e) { 
              return true; 
          } 
          view.loadUrl(url); 
          return true; 
      }

h5Url加载效果

[h2]浏览器环境加载h5Url

根据h5Url处理中通过不同参数拼接处理指定支付环境后，浏览器环境h5Url具体加载效果如下：

[h2]扫码加载h5Url

支付结果获取

1. 商户在构建“直连商户H5预下单”请求时通过参数传入callbackUrl。在华为支付服务器完成支付后，将以POST方式调用callbackUrl，将支付结果返回给商户服务器。参见支付结果回调通知。
2. 商户可通过查询支付订单接口主动查询华为支付服务器获取支付结果。
3. 商户在预下单传递了returnUrl参数（即加载h5url时携带returnUrl），用户在端侧完成支付操作后将携带结果重定向回returnUrl。

   结果信息为：result={resultCode:xxx; resultDesc:xxx, 其他业务参数信息}。

   结果含义如下：

   resultCode	resultDesc	说明
   000000	success	SUCCESS（成功）
   -1	common error	FAIL（通用错误）
   30000	user cancel payment	CANCEL（用户取消支付）

API列表

H5支付API列表