目录

快速接入

接入流程

商户支付接入流程:

  1. 商户客户端请求商户服务器创建商品订单。
  2. 商户服务器调用华为支付提供的快应用预下单接口获取预下单号(prepayId),然后组建orderStr返回给客户端。
  3. 商户客户端调用pay接口调起华为支付客户端收银台。
  4. 用户在华为支付客户端收银台完成支付。
  5. 华为支付客户端展示支付结果页,用户关闭支付结果页后华为支付客户端会返回支付状态给商户客户端。
  6. 支付成功后,华为支付服务器会调用回调接口返回支付结果信息给商户服务器;支付失败场景可能不会有支付结果回调通知。
  7. 商户服务器收到支付结果回调响应后,使用SM2验签方式对支付结果进行验签。

支付是否成功可以通过回调通知中的orderStatus的返回状态判断:

  • TRX_SUCCESS:交易成功
  • TRX_FAILED:交易失败

客户端开发

商户服务器通过调用快应用预下单获取预支付ID(prepayId)后商户服务器需要构建orderStr返回给客户端。

orderStr参数说明

参数

参数类型

是否必填

描述

app_id

String

否

应用ID。

merc_no

String

是

商户号

prepay_id

String

是

预下单id,使用预下单请求生成,有效期2小时。

timestamp

String

是

当前时间戳,标准北京时间,时区为东八区,自1970年1月1日 0点0分0秒以来的毫秒数,13位。示例值:1666230721315

noncestr

String

是

随机字符串,不长于32位。推荐随机数生成算法。

每笔订单都需要重新生成。

sign

String

是

签名,使用除了sign字段以外的其他字段计算签名值。可参考签名章节

auth_id

String

是

开放平台分配的鉴权id,一个商户可配置多套证书,请妥善保管

开发者可使用@hw-hmscore/hms-payment的HMSPAYMENT对象方法拉起支付页面。

// 快应用appId
const appId = "****";
const orderStr = "{\"merc_no\":\"***\",\"prepay_id\":\"1230331185102089244382635044\",\"timestamp\":\"1680259863114\",\"noncestr\":\"1487b8a60ed9f9ecc0ba759fbec23f4f\",\"sign\":\"****\",\"auth_id\":\"***\"}";
HMSPAYMENT.pay(orderStr, appId).then(res => {
  console.info("res: "+ JSON.stringify(res)); 
  // 参考下表解析res,此处可以处理支付结果,界面刷新和跳转等操作 
}).catch(err => {
    console.error("err: "+ JSON.stringify(err));
  })
  1. 调用pay接口后同步返回支付结果 ,通过Handler发送消息在主线程处理支付结果。

    回调结果说明

    参数

    参数类型

    描述

    参考示例

    errCode

    string

    返回码

    见HMS Core SDK错误码说明

    errMsg

    string

    返回信息描述

    示例:"{\"PayResult\":\"{\\\"returnCode\\\":\\\"0\\\",\\\"returnMsg\\\":\\\"pay success\\\"}\"}"

    returnCode为0时表示成功,具体返回参考错误码

  2. 商户在构建支付请求参数时,传入了一个callbackUrl。在华为支付服务器完成支付后,将以post方式调用callbackUrl,将支付结果返回给商户服务器。

若支付成功,不建议以客户端返回作为用户的支付结果,需以服务器接收到的结果通知或者查询API返回为准。

API列表

快应用支付API列表

功能列表

描述

快应用预下单

通过本接口提交华为支付快应用支付订单信息,同时获取华为支付预交易订单号。

快应用调起支付

商户服务器通过快应用预下单获取必要参数prepayId,按照接口规则组参orderStr返回给客户端,客户端通过鸿蒙支付服务 JS SDK拉起快应用支付。

查询交易订单

通过本接口查询某笔交易订单状态。

支付结果通知

华为支付服务器调用快应用预下单传入的callbackUrl回调接口,将用户支付成功的消息通知给商户。

申请退款

商户可以调用此接口将订单金额退还给用户。

查询退款订单

调用退款申请后,调用此接口查询退款订单状态。

退款结果通知

华为支付服务器调用申请退款请求传入的callbackUrl回调接口,将退款成功消息通知给商户。

查询对账单

商户通过此接口获取华为支付对账单表格下载地址。

查询结算账单

商户通过此接口获取华为支付结算账单表格下载地址。