支付系统接口文档

商户接入前需获取以下信息（请联系管理员开通）：

所有接口均采用统一的签名算法，规则如下：

协议规范

签名生成步骤

第一步：将所有非空参数值的参数（不含 sign）按参数名 ASCII 码从小到大排序（字典序），使用 URL 键值对格式拼接成字符串。

第二步：在拼接字符串末尾追加 &key=商户密钥，对该字符串进行 MD5 运算，得到 32 位签名值（不区分大小写）。

签名示例

假设请求参数如下：

{
  "mchId": "10001",
  "productId": "8001",
  "outTradeNo": "SH20260308001",
  "amount": 10000,
  "reqTime": 1772956800000,
  "notifyUrl": "https://www.example.com/notify",
  "returnUrl": "https://www.example.com/return"
}

待签名字符串（参数名字典序排列）：

amount=10000&mchId=10001&notifyUrl=https://www.example.com/notify&outTradeNo=SH20260308001&productId=8001&reqTime=1772956800000&returnUrl=https://www.example.com/return&key=YOUR_SECRET_KEY

对上述字符串执行 md5() 得到 32 位密文，即为 sign 的值。

产品ID即我方通道类型（通道编码），商户在创建订单时需传入对应的 productId 参数。具体可用产品ID以接口返回或客服提供为准，联系客服获取即可。

查询可用产品接口

https://www.lubankeji.fyi/payment/api/product_list

HTTP GET，无需签名，返回当前启用的通道类型列表（product_id 即通道类型编码，product_name 为名称，remark 为备注）：

{
  "code": 0,
  "data": [
    { "product_id": "defaultpay", "product_name": "默认支付", "remark": "" },
    { "product_id": "kuaijie", "product_name": "快捷支付", "remark": "" }
  ]
}

接口说明

商户业务系统通过统一下单接口发起支付收款订单，支付网关会根据商户传入的产品ID选择对应的支付方式完成支付下单，并返回对应的支付参数。

本接口支持两种返回形态：链接形态（返回 payUrl，引导用户访问链接完成支付）与 payData 形态（部分通道如银行卡转账会返回 payData、payDataType，内容可能为银行卡信息等 JSON 字符串，商户解析后展示给用户）。

请求URL

https://www.lubankeji.fyi/payment/api/pay/v2/unifiedOrder

请求方式

POST/JSON   Content-Type: application/json   字符编码：UTF-8

请求参数

返回参数

成功响应示例（链接形态）

{
  "code": 0,
  "message": "success",
  "data": {
    "mchId": "10001",
    "tradeNo": "PAY20260308123456",
    "outTradeNo": "SH20260308001",
    "amount": 10000,
    "payUrl": "https://pay.example.com/cashier/abc123",
    "sign": "f52ab92457b1a97c1dbbc794de8dea8e"
  }
}

成功响应示例（payData 形态，如银行卡信息）

{
  "code": 0,
  "message": "success",
  "data": {
    "mchId": "10001",
    "tradeNo": "PAY20260308123456",
    "outTradeNo": "SH20260308001",
    "amount": 10000,
    "payUrl": "",
    "payData": "{\"accNo\":\"6222031512008267248\",\"accName\":\"池贤贵\",\"bankName\":\"工商银行\"}",
    "payDataType": "bankCard",
    "sign": "a1b2c3d4..."
  }
}

失败响应示例

{
  "code": -1,
  "message": "验证签名不正确"
}

接口说明

当订单支付成功时，支付网关会向商户系统发起回调通知。如果商户系统没有正确返回，支付网关会延迟再次通知。

请求方式

POST/JSON   Content-Type: application/json   字符编码：UTF-8

请求URL：该URL是通过【统一下单API】中提交的参数 notifyUrl 设置。

通知参数

签名验证

签名方法与请求签名一致：所有非空参数（不含 sign）按参数名字典序排序后拼接，追加 &key=商户密钥，做 MD5。

响应要求

商户收到通知后，请验证签名并处理业务逻辑，然后返回 SUCCESS 或 OK（不区分大小写）。

接口说明

商户通过该接口查询订单，支付网关会返回订单最新的数据。

请求URL

https://www.lubankeji.fyi/payment/api/pay/queryOrder

请求方式

POST/JSON   Content-Type: application/json   字符编码：UTF-8

请求参数

返回参数

成功响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "mchId": "10001",
    "productId": "8001",
    "tradeNo": "PAY20260308123456",
    "outTradeNo": "SH20260308001",
    "amount": 10000,
    "payAmount": 10000,
    "state": 1,
    "createTime": "2026/03/08 12:00:00",
    "payTime": "2026/03/08 12:00:05",
    "sign": "f52ab92457b1a97c1dbbc794de8dea8e"
  }
}

• 所有接口请求/回调均为 POST JSON，UTF-8 编码
• 平台所有涉及金额的参数，均以人民币「分」为单位，请务必注意
• 签名规则：所有非空参数按参数名 ASCII 字典序排序，拼接后追加 &key=商户密钥，再做 MD5（32位，不区分大小写）
• 接口可能增加字段，验证签名时必须支持增加的扩展字段
• 异步通知由平台出口 IP 93.177.77.44、18.162.53.156 发起，建议商户对回调来源 IP 做校验或白名单
• 商户收到回调通知后返回 SUCCESS 或 OK（不区分大小写），否则平台将重试通知
• 请以异步通知作为订单状态变更的唯一依据
• notifyUrl 和 returnUrl 必须为可公网访问的完整 URL