支付

has.requestPayment

has.requestPayment(Object object)

拉起华为支付或跳转三方支付。

需要权限： 开发前需要配置支付业务规则，接入流程详见接入支付服务。

起始版本： 1.0.0

参数：

参数为Object对象，包括以下字段。

success返回值：

拉起华为支付success的返回值为空，跳转三方支付success的返回值包括以下字段。

错误码：

示例：

拉起华为支付：

has.requestPayment({
  orderStr: '{"app_id":"***","merc_no":"***","prepay_id":"xxx","timestamp":"1680259863114","noncestr":"1487b8a60ed9f9ecc0ba759fbec23f4f","sign":"****","auth_id":"***"}',
  success: (res) => {
    console.info('requestPayment success', res);
  },
  fail: (err) => {
    console.error('requestPayment fail', err);
  },
  complete: (res) => {
    console.info('requestPayment complete', res);
  }
});

拉起混合支付：

has.requestPayment({
  orderStr: '{"app_id":"***","merc_no":"***","prepay_id":"xxx","timestamp":"1680259863114","noncestr":"1487b8a60ed9f9ecc0ba759fbec23f4f","sign":"****","auth_id":"***"}',
  payload: '',
  success: (res) => {
    console.info('requestPayment success', res);
  },
  fail: (err) => {
    console.error('requestPayment fail', err);
  },
  complete: (res) => {
    console.info('requestPayment complete', res);
  }
});

跳转三方支付：

has.requestPayment({
  orderStr: '{"nextAction":"L","linkUrl":"https://www.***.pay.com/h5pay?prepay_id=***&sign=***","scheme":"","clientToken":"***"}',
  payload: 'AP',
  success: (res) => {
    console.info('requestPayment success', res);
  },
  fail: (err) => {
    console.error('requestPayment fail', err);
  },
  complete: (res) => {
    console.info('requestPayment complete', res);
  }
});

has.cashierPicker

has.cashierPicker(Object object)

拉起通用收银台。

需要权限： 开发前需要配置支付业务规则，接入流程详见接入支付服务。

起始版本： 1.0.9

参数：

参数为Object对象，包括以下字段。

success返回值：

错误码：

示例：

has.cashierPicker({
  tradeSummary: '',
  amount: 100,
  currency: 'CNY',
  extraInfo: '',
  success: (res) => {
    console.info('cashierPicker success', res);
  },
  fail: (err) => {
    console.error('cashierPicker fail', err);
  },
  complete: (res) => {
    console.info('cashierPicker complete', res);
  }
});

has.requestContract

has.requestContract(Object object)

调起华为支付签约服务。

需要权限： 开发前需要配置支付业务规则，接入流程详见支付并签约场景。

起始版本： 1.0.10

参数：

参数为Object对象，包括以下字段。

错误码：

示例：

has.requestContract({
  contractStr: 'xxx',
  success: () => {
    console.info('requestContract success');
  },
  fail: (err) => {
    console.error('requestContract fail', err);
  },
  complete: (res) => {
    console.info('requestContract complete', res);
  }
});

has.createThirdPayClient

has.createThirdPayClient(string payMethod, string thirdAppId)：ThirdPayClient

构建支付请求客户端。

需要权限： 开发前需要配置支付业务规则，接入流程详见支付并签约场景。业务流程详见混合支付场景基于接口方式拉起。

起始版本： 1.0.17

参数：

返回值：

返回ThirdPayClient对象。

示例：

// 示例代码传入字符串类型不会影响当前接口，但是开发中pay方法只支持上述三种方式
const thirdPayClient = has.createThirdPayClient('payMethod', 'third_appid_123456');

ThirdPayClient

支付请求客户端。

起始版本： 1.0.17

[h2]ThirdPayClient.pay

ThirdPayClient.pay()

拉起三方支付收银台的支付接口。

该方法提供拉起三方支付方式收银台等功能，调用方法前请确保网络已连接。调用该方法后会拉起三方支付收银台，完成后使用Promise异步返回。商户客户端根据接口has.requestPayment或者has.cashierPicker返回结果，按照三方支付平台接入要求构建三方支付信息payInfo调用ThirdPayClient.pay接口拉起三方支付收银台。

需要权限： 开发前需要配置支付业务规则，接入流程详见支付并签约场景，业务流程详见混合支付场景基于接口方式拉起。

起始版本： 1.0.17

依赖关系： HarmonyOS SDK版本≥6.0.0(20)且ROM版本≥6.0.0

参数：

参数为Object对象，包括以下字段。

错误码：

示例：

const thirdPayClient = has.createThirdPayClient('payMethod', 'third_appid_123456');
// 不同支付方式参数构建参考示例如下：
// wechat_pay：'{"appId":"***","partnerId":"***","prepayId":"***","packageValue":"***","nonceStr":"***","timeStamp":"***","sign":"***","extData":"***","token":"***"}'
// ali_pay：'{"orderInfo":"***", "token":"***"}'
// wechat_mini_program：'{"userName":"原始id", "path":"小程序启动路径", "miniProgramType":"小程序的类型，0-正式版 1-开发版 2-体验版 默认0", "extData":"***", "token":"***"}'
thirdPayClient.pay({
  payInfo: 'xxx',
  success: () => {
    console.info('thirdPayClient.pay success');
  },
  fail: (err) => {
    console.error('thirdPayClient.pay fail', err);
  },
  complete: (res) => {
    console.info('thirdPayClient.pay complete', res);
  }
});