zh-h5-pay/md/shopOrder.md

api/shopOrder

统一响应格式：{"code": 1, "message": "success", "data": ...}，下文「响应参数」均指 data 字段。

接口总览

#	方法	路径	说明	认证
1	GET	/api/shopOrder/pay_img_info	扫码查询收款码信息（公开接口）	否
2	GET	/api/shopOrder/info	获取订单详情	否
3	POST	/api/shopOrder/pay	收款码下单支付	是

---

接口详情

1. GET /api/shopOrder/pay_img_info

• 说明: 扫码查询收款码信息（公开接口）
• 认证: 否
• Handler: api.ShopOrderController{}.GetPayImgInfo

请求参数

字段	类型	必填	说明	约束
code	string	是	收款码	-

响应参数

object，类型 api.payImgInfoResp：

字段	类型	说明
shop_name	string	商户名称
store_name	string	门店名称
cashier_name	string	收银台名称
staff_name	string	员工名称

---

2. GET /api/shopOrder/info

• 说明: 获取订单详情
• 认证: 否
• Handler: api.ShopOrderController{}.GetShopOrderInfo

请求参数

字段	类型	必填	说明	约束
order_sn	string	是	订单编号	-

响应参数

object，类型 api.orderInfoResp：

字段	类型	说明
rs_sn	string	店铺订单支付编号
pay_sn	string	支付编号
status	int	1待支付 2已支付 3已退款/已完成
pay_money	decimal.Decimal	支付金额
shop_name	string	商户名称

---

3. POST /api/shopOrder/pay

• 说明: 收款码下单支付
• 认证: 是
• Handler: api.ShopOrderController{}.Pay

请求参数

字段	类型	必填	说明	约束
code	string	是	收款码	-
pay_money	string	是	支付金额	numeric; 金额范围（0.01-2000）在控制器用 decimal 校验，string 字段不能用 gte/lte 小数（validator 按整数长度解析会 panic）
pay_type	int	是	支付方式	oneof=1 2
pay_code_source	int	是	收款码类型	oneof=1 2

响应参数

object，类型 api.payResp：

字段	类型	说明
order_sn	string	店铺订单支付编号
is_bank	int	是否银联
is_yee	int	是否易宝
pay_data	interface{}	支付凭据（易宝预支付凭证或银联跳转URL）

---