商户支付接入流程:

支付是否成功可以通过回调通知中的orderStatus的返回状态判断:
商户服务器通过调用快应用预下单获取预支付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));
}) 回调结果说明
| 参数 | 参数类型 | 描述 | 参考示例 |
|---|---|---|---|
| errCode | string | 返回码 | |
| errMsg | string | 返回信息描述 | 示例:"{\"PayResult\":\"{\\\"returnCode\\\":\\\"0\\\",\\\"returnMsg\\\":\\\"pay success\\\"}\"}" returnCode为0时表示成功,具体返回参考错误码 |
若支付成功,不建议以客户端返回作为用户的支付结果,需以服务器接收到的结果通知或者查询API返回为准。
快应用支付API列表
| 功能列表 | 描述 |
|---|---|
| 通过本接口提交华为支付快应用支付订单信息,同时获取华为支付预交易订单号。 | |
| 商户服务器通过快应用预下单获取必要参数prepayId,按照接口规则组参orderStr返回给客户端,客户端通过鸿蒙支付服务 JS SDK拉起快应用支付。 | |
| 通过本接口查询某笔交易订单状态。 | |
| 华为支付服务器调用快应用预下单传入的callbackUrl回调接口,将用户支付成功的消息通知给商户。 | |
| 商户可以调用此接口将订单金额退还给用户。 | |
| 调用退款申请后,调用此接口查询退款订单状态。 | |
| 华为支付服务器调用申请退款请求传入的callbackUrl回调接口,将退款成功消息通知给商户。 | |
| 商户通过此接口获取华为支付对账单表格下载地址。 | |
| 商户通过此接口获取华为支付结算账单表格下载地址。 |