目录

快速接入

接入流程

商户支付接入流程如下:

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

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

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

客户端开发

商户服务器通过调用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,一个商户可配置多套证书,请妥善保管

首先要获取AggrPayClient对象,通过AggrPayClient对象去调用支付接口pay(orderStr),代码示例如下:
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();
}

支付接口需要在线程中调用。

  1. 调用pay接口后同步返回支付结果PayResult,通过Handler发送消息在主线程处理支付结果。

    参数

    类型

    描述

    参考示例

    returnCode

    string

    返回状态码

    “0”:表示成功,具体返回参考错误码

    returnMsg

    string

    返回描述

    “success”:表示签约成功

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

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

API列表

APP支付API列表

功能列表

描述

APP预下单

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

APP调起支付

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

查询交易订单

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

支付结果通知

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

申请退款

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

查询退款订单

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

退款结果通知

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

查询对账单

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

查询结算账单

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