统一下单接口

更新时间：2026-07-01

接口说明

统一下单接口是聚合支付系统的核心支付接口，支持多种支付方式包括PC/H5/JSAPI（生成支付链接,商户可直接跳转或封装为二维码）、支付宝小程序、微信小程序等支付场景。

适用对象
直连商户
请求URL
https://api.example.com/openapi/v1/order/create
请求方法
POST
ℹ️ 公共参数说明详见「通用规则 - API公共参数」部分

下单流程图

下单流程图

业务参数

参数 类型 必填 参数说明
paymentMethod String Y 支付编码（参考支付编码枚举）
orderNo String Y 商户订单号（建议唯一）
amount String Y 支付金额（单位元，保留两位小数，如 0.01）
subject String Y 商品名称，展示于支付渠道订单
notifyUrl String Y 异步通知地址，需可公网访问的 HTTPS 地址
returnUrl String C 页面跳转地址，支付完成需要跳转时必填
clientIp String Y 下单用户公网 IP，例如 152.33.40.28
merchantUrl String N 商家网站地址，如 https://shop.xxx.com
description String N 商品描述，仅保留内部，不上传渠道
appId String N 微信小程序/公众号 APPID
openId String N 小程序/公众号支付必传，微信用户 OPENID
buyerId String N 支付宝JSAPI支付必传，2088开头的16位纯数字
expireMinutes String N 订单超时时间，单位分钟，最大 1440（默认 10 分钟）

参数说明：Y: 必填，N: 非必填，C: 条件必填

⚠️ 正扫：商户系统调用该接口生成预支付链接，可直接跳转支付，也可将链接转换成二维码，消费者扫码支付。

接口返回参数

公共返回参数

参数 类型 必须 参数说明
code String Y 响应状态码，成功 0000
message String Y 响应描述
timestamp String Y 响应时间戳，UTC 时间，ISO 8601 格式
data Object N 业务数据，无数据时返回空对象 {}

响应附加参数（data）

参数 类型 必须 参数说明
transactionNo String Y 平台订单号
expiredTime String Y 订单过期时间
type String Y jump-支付链接；alipay-支付宝小程序支付；wechat-微信小程序支付
jumpUrl String C 支付链接，类型为 jump 时返回
qrCode String C 二维码链接，类型为 jump 时返回
payInfo Object N 支付返回信息，类型为alipay或wechat时返回
schemaUrl String C 支付宝小程序支付链接
appId String C 微信小程序appid
path String C 微信小程序页面支付路径
schemeCode String C 外部拉取微信小程序支付链接

参数说明：Y: 返回，N: 不返回，C: 条件返回

请求示例

支付请求示例（PC/H5/微信公众号/支付宝JS/支付宝正扫）

JSON 
{
  "appId": "you_system_appid",
  "userId": "your_user_id",
  "bizContent": "{\"paymentMethod\":\"HUIFU_T_JSAPI_PC\",\"notifyUrl\":\"/api/notify/huifu/handle\",\"orderNo\":\"TEST202607021449024813\",\"subject\":\"测试订单-144902\",\"merchantUrl\":\"www.sh.com\",\"amount\":\"0.01\",\"clientIp\":\"127.0.0.1\"}",
  "version": "1.0",
  "nonce": "49d55020fa3adf6ed67b253c583ccdaa",
  "contentHash": "95772c8a0c74e52b707e2ace5963e0eae956e8b1ae26e86a6cde5469247d0382",
  "timestamp": "2026-07-02 14:33:11",
  "sign": "your_sign"
}

支付请求示例（支付宝小程序支付）

JSON 
{
  "appId": "you_system_appid",
  "userId": "your_user_id",
  "bizContent": "{\"appId\":\"9021000165612901\",\"paymentMethod\":\"HUIFU_ALI_MINIAPP\",\"notifyUrl\":\"/api/notify/huifu/handle\",\"orderNo\":\"TEST202607021433112206\",\"subject\":\"测试订单-143311\",\"merchantUrl\":\"www.sh.com\",\"amount\":\"0.01\",\"clientIp\":\"127.0.0.1\"}",
  "version": "1.0",
  "nonce": "49d55020fa3adf6ed67b253c583ccdaa",
  "contentHash": "95772c8a0c74e52b707e2ace5963e0eae956e8b1ae26e86a6cde5469247d0382",
  "timestamp": "2026-07-02 14:33:11",
  "sign": "your_sign"
}

支付请求示例（微信小程序支付）

JSON 
{
  "appId": "you_system_appid",
  "userId": "your_user_id",
  "bizContent": "{\"paymentMethod\":\"HUIFU_WX_MINIAPP\",\"notifyUrl\":\"/api/notify/huifu/handle\",\"orderNo\":\"TEST202607021506596406\",\"subject\":\"测试订单-150659\",\"merchantUrl\":\"www.sh.com\",\"amount\":\"0.01\",\"clientIp\":\"127.0.0.1\"}",
  "version": "1.0",
  "nonce": "49d55020fa3adf6ed67b253c583ccdaa",
  "contentHash": "95772c8a0c74e52b707e2ace5963e0eae956e8b1ae26e86a6cde5469247d0382",
  "timestamp": "2026-07-02 14:33:11",
  "sign": "your_sign"
}

返回示例

PC/H5返回示例

JSON 
{
  "code": "0000",
  "message": "Success",
  "timestamp": "2026-07-01T10:30:00.000Z",
  "data": {
    "transactionNo": "SHPAY202607011030001234567890",
    "expiredTime": "2026-07-03 14:51:56",
    "type": "jump",
    "jumpUrl": "https://api.huifu.com/hostingh5/?jump_id=H202607010927040098601706&huifu_id=6666000109133323&bank_switch=Y"
  }
}

支付宝小程序返回示例

JSON 
{
  "code": "0000",
  "message": "Success",
  "timestamp": "2026-07-01T10:30:00.000Z",
  "data": {
    "transactionNo": "SHPAY202607011030001234567890",
    "expiredTime": "2026-07-03 14:51:56",
    "type": "alipay",
    "payInfo": {
      "schemaUrl": "alipays://platformapi/startapp?appId=xxx&url=xxx"
    }
  }
}

微信小程序支付返回示例

JSON 
{
  "code": "0000",
  "message": "Success",
  "timestamp": "2026-07-01T10:30:00.000Z",
  "data": {
    "transactionNo": "SHPAY202607011030001234567890",
    "expiredTime": "2026-07-03 14:51:56",
    "type": "wechat",
    "payInfo": {
      "appId": "wx1234567890abcdef",
      "path": "pages/cashier/cashier?p=H2023112713461700667284637&s=app",
      "schemeCode": "weixin://dl/business/?t=f5x3WMhYPat"
    }
  }
}

失败返回示例

JSON 
{
  "code": "4001",
  "message": "缺少必填参数 paymentMethod",
  "timestamp": "2026-07-01T10:30:00.000Z",
  "data": {}
}

支付编码枚举

线上具体支付方式可在商户后台查看最新的数据，此处仅展示部分常用通道。

线上通道（正扫）

名称
支付编码
微信PC支付(含JSAPI)
HUIFU_T_NATIVE_PC
微信公众号支付
HUIFU_T_JSAPI_H5
微信小程序支付
HUIFU_WX_MINIAPP
支付宝PC支付(含JSAPI)
HUIFU_A_JSAPI_PC
支付宝H5支付(含JSAPI)
HUIFU_A_JSAPI_H5
支付宝小程序支付
HUIFU_ALI_MINIAPP

注意事项

🚨 重要提醒：
  • 所有金额参数使用字符串类型，保留两位小数
  • 商户订单号建议保持唯一性，避免重复提交
  • 异步通知地址必须是可公网访问的 HTTPS 地址
  • 签名算法和参数排序规则请参考「签名与加密」文档
  • 测试环境和生产环境使用不同的网关地址

开发建议

  • 建议在正式环境使用前，先在测试环境充分测试各种支付场景
  • 实现异步通知处理逻辑，确保订单状态的准确性
  • 合理设置订单超时时间，避免长时间占用资源
  • 对于分账功能，请确保分账金额总和不超过订单总金额
💡 请求格式说明：主体参数包括 appId、userId、bizContent、sign；业务参数放在 bizContent 字段中，以 JSON 字符串形式传递，需要进行 JSON 转义。
© 2026 数汇支付平台 | API 文档版本 v1.0