商户支付接入流程如下:

支付是否成功可以通过回调通知中的orderStatus的返回状态判断:
商户服务器通过调用APP预下单获取预支付ID(prepayId)后商户服务器需要构建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,一个商户可配置多套证书,请妥善保管 |
String orderStr = "{\"app_id\":\"***\",\"merc_no\":\"***\",\"prepay_id\":\"1230331185102089244382635044\",\"timestamp\":\"1680259863114\",\"noncestr\":\"1487b8a60ed9f9ecc0ba759fbec23f4f\",\"sign\":\"****\",\"auth_id\":\"***\"}";
public void payApi(Activity activity, Handler handler) {
Runnable runnable = () -> {
AggrPayClient client = Pay.getPayClient(activity);
PayResult result = client.pay(orderStr);
handler.post(() -> {
//处理结果,页面跳转等操作,返回示例见下表
});
};
Thread payThread = new Thread(runnable);
payThread.start();
}
支付接口需要在线程中调用。
| 参数 | 类型 | 描述 | 参考示例 |
|---|---|---|---|
| returnCode | string | 返回状态码 | “0”:表示成功,具体返回参考错误码 |
| returnMsg | string | 返回描述 | “success”:表示签约成功 |
若支付成功,不建议以客户端返回作为用户的支付结果,需以服务器接收到的结果通知或者查询API返回为准。
APP支付API列表
| 功能列表 | 描述 |
|---|---|
| 通过本接口提交华为支付APP支付订单信息,同时获取华为支付预交易订单号。 | |
| 商户服务器通过APP预下单获取必要参数prepayId,按照接口规则组参orderStr返回给客户端,客户端通过鸿蒙支付服务SDK拉起APP支付。 | |
| 通过本接口查询某笔交易订单状态。 | |
| 华为支付服务器调用APP预下单传入的callbackUrl回调接口,将用户支付成功的消息通知给商户。 | |
| 商户可以调用此接口将订单金额退还给用户。 | |
| 调用退款申请后,调用此接口查询退款订单状态。 | |
| 华为支付服务器调用申请退款请求传入的callbackUrl回调接口,将退款成功消息通知给商户。 | |
| 商户通过此接口获取华为支付对账单表格下载地址。 | |
| 商户通过此接口获取华为支付结算账单表格下载地址。 |