订单码下单

订单码下单接口，适用于 PC 网站或者自动贩卖设备，用户选择商品后，调用此接口生成带金额的聚合二维码，用户打开微信 APP、支付宝 APP、云闪付 APP 主扫完成支付的场景；

请求路径	/pay/preorder
请求方法	POST

请求参数

公共参数

参数	名称	类型	必填	说明
key	标识	string	是	开发者唯一标识
time	时间戳	string	是	当前 unix 时间戳，精确到秒
sign	数据签名	string	是	数据签名，详见 签名算法
data	业务参数	JSON string	是	业务参数，详见下例表格

业务参数

参数	名称	类型	必填	说明
terminal	终端码	string	是	终端码，详见控台终端管理
sequence	流水号	string	是	订单流水号
amount	金额	string	是	订单金额，保留 2 位小数，如：100.00，最小 0.01
notifyurl	异步通知地址	string	否	交易异步通知地址
subject	订单主题	string	否	订单主题
detail	订单详情	string	否	订单详情
remark	备注	string	否	备注

请求示例

{
  "data": "{\"amount\":0.1,\"notifyurl\":\"https://tpaas.hbsk.com/test/faked\",\"remark\":\"for testing \",\"sequence\":\"2023050906\",\"terminal\":\"T544357446576893\"}",
  "key": "d4247ed86e99865b93a",
  "sign": "02bc57e1005f18766c4a4fee21cf15d19795b2cde24fe4e19bfb19fe15ed54e6",
  "time": 1683794943
}

返回数据

公共数据

数据	名称	类型	必填	说明
code	状态码	int	是	结果状态码
text	操作结果	string	否	操作结果，为空时不返回此字段
time	时间戳	int	是	服务器当前 unix 时间戳，精确到秒
sign	数据签名	string	是	数据签名
data	业务数据	JSON string	是	业务数据，详见下例表格

业务数据

数据	名称	类型	必填	说明
amount	金额	string	是	下单金额，精确到 2 位小数，如 1.00
remark	备注	string	否	备注
payment	支付数据	JSON	是	支付数据，用于前端发起支付
sequence	流水号	string	否	下游游水号
serial	流水号	string	否	上游流水号
terminal	终端码	string	是	终端码，详见控台终端管理
qrcode	支付二维码	string	是	支付二维码图片链接
url	支付链接	string	是	支付链接

返回状态

状态	说明
0	下单成功
1201001	下单失败
1201002	交易流水号不可重复
1001001	系统错误
1001002	无效开发者标识
1001003	无效签名信息
1001004	无效请求时间戳
1001005	暂不支持此交易方式
1001051	无效支付订单
1002052	无效应用终端
1002053	无效支付商户
1002054	无效支付服务商
1002055	无效支付通道
1002056	无效支付通道配置
1002057	无效支付方式

返回示例

{
  "code": 0,
  "data": "{\"amount\":0.1,\"code\":\"230511958988\",\"feeamount\":0,\"gateway\":\"without\",\"method\":\"without\",\"payment\":null,\"qrcode\":\"http://file.dev.com/pay/qrcode/230511958988\",\"remark\":\"for testing\",\"scene\":\"without\",\"sequence\":\"2023050908\",\"share\":true}",
  "sign": "45d341e3f763cfd2bfbc0d1a2864ba9a00ac1062cc0670a13c52c2a885916f0e",
  "text": "下单成功",
  "time": 1683795125
}