# 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） |

---