接口文档

签名算法 1.0

1. 协议规则

1.1 参数规范

交易金额：默认为人民币交易，单位为分，参数值不能带小数。

1.2 安全规范 · 签名算法

签名生成的通用步骤如下：

1. 第一步

   设所有发送或者接收到的数据为集合 M，将集合 M 内非空参数值的参数按照参数名 ASCII 码从小到大排序（字典序），使用 URL 键值对的格式（即 key1=value1&key2=value2…）拼接成字符串 stringA。

   特别注意

   • 参数名 ASCII 码从小到大排序（字典序）
   • 如果参数的值为空不参与签名
   • 参数名区分大小写
   • 验证调用返回或支付中心主动通知签名时，传送的 sign 参数不参与签名
   • 支付中心接口可能增加字段，验证签名时必须支持增加的扩展字段
2. 第二步

   在 stringA 最后拼接上 key（即 StringA + "&key=" + 私钥）得到 stringSignTemp 字符串，并对 stringSignTemp 进行 MD5 运算，再将得到的字符串所有字符转换为大写，得到 sign 值 signValue。

下单接口

1.1 统一下单接口 · 标准

接口流程：机构调用预下单接口生成跳转支付订单页面。

请求参数

响应参数

以下字段在 retCode=0 时有返回

响应示例

{
  "prodTrace": "LF8202412020020070001",
  "payUrl": "http://170.33.8.116:8182/payurl?orgTrace=Pnull2024021211314049724732&transAmt=888.99",
  "retCode": "0",
  "sign": "3251661E4B84AAB6BAA1A6A025F40036"
}

1.2 查询订单接口 · 标准

接口流程：业务系统通过查询支付订单接口获取最新的支付订单状态，并根据状态结果进一步处理业务逻辑。

请求参数

响应参数（retCode=0 时）

响应示例

{
  "retCode": "0",
  "sign": "35CD50041BCC2D6D4F445C2F6F22D36B",
  "orgMerCode": "20000010",
  "appId": "aad3f9ac7cff4ccf8235b4ed30c12b51",
  "orgTermNo": "8045",
  "prodTrace": "LF8202412070454420001",
  "orgTrace": "TEST1733518477095",
  "transAmt": "100",
  "status": "2",
  "paySuccTime": "1733518845000"
}

1.3 支付结果通知

当订单支付成功时，支付中心会向商户的 notifyUrl 地址发起回调。该链接通过统一下单接口的 notifyUrl 参数设置。

通知参数

代付接口

1. 申请代付

商户通过代付接口发起代付申请，支付系统收到请求后同步返回申请结果，申请成功并不代表代付成功。确定代付结果的方式：

1. 发起代付时传递代付结果回调地址，支付系统处理完成后向该地址发起通知
2. 商户系统主动发起代付查询，以查询到的最终结果确定代付是否成功

注意：商户访问该接口需要申请 IP 白名单。

请求参数

响应参数（retCode=0 时）

2. 代付确认

当商户通过接口发起代付请求后，如果商户开启代付二次确认，支付平台会向商户配置的代付确认地址发起请求，等待商户系统返回确认结果。

请求参数

3. 查询代付订单

商户通过该接口查询代付订单结果，并根据状态结果进一步处理业务逻辑。

请求参数

响应参数（retCode=0 时）

4. 查询余额

商户可通过该接口查询代付账户余额。

请求参数

响应参数（retCode=0 时）

5. 代付结果通知

当代付处理完成后，支付系统会通过该接口向商户发起通知。链接由代付申请接口的 notifyUrl 参数设置。

通知参数

6. 错误码