6.2车主平台减免接口(车主平台到泊链)

## 一、接口信息

- **测试环境接口地址**：https://beta.bolink.club/unionapi/confirmCoupon
- **正式环境接口地址**：https://s.bolink.club/unionapi/confirmCoupon
- **接口方向**：车主平台 → 泊链
- **用途**：车主平台通过调用此接口对订单进行减免
- **请求数据格式**：JSON 字符串

## 二、请求格式

### 请求字段

| 字段名称 | 类型 | 说明 | 是否必传 | 示例 |
| --- | --- | --- | --- | --- |
| union_id | Number | 厂商平台编号 | 是 | 200188 |
| sign | String | 数据 data 的签名值，32 位 | 是 | 4410206F302D51801B9B2340510EBAB3 |
| data | json | 包含下面所有字段的 json 对象 | 是 | {"park_id":"21888","park_union_id":200158,...} |
| park_id | String | 车场编号 | 是 | 21888 |
| park_union_id | Number | 车场所属厂商编号 | 是 | 200158 |
| total | Number | 订单总金额，单位是元，保留两位小数 | 是 | 5.00 |
| coupon_amount | Number | 减免金额，单位是元，保留两位小数 | 是 | 2.5 |
| order_id | String | 车辆进场订单号，32 位以内，字母数字和下划线组成 | 是 | 20171204152324414_RLF373 |
| plate_number | String | 车牌号 | 是 | 桂GGGTT08 |
| trade_no | String | 交易流水号，由数字组成的字符串，16-32 位，不可低于 16 位，不可重复 | 是 | 20170921336435142 |
| time_temp | String | 时间戳 unix 时间，到毫秒 | 是 | 1484369702556 |

### 请求示例

```json
{
  "union_id": 200188,
  "sign": "4410206F302D51801B9B2340510EBAB3",
  "data": {
    "coupon_amount": 1.99,
    "order_id": "20170923141950",
    "plate_number": "桂GGGTT08",
    "trade_no": "20170921336334810",
    "time_temp": 1484369702556,
    "park_union_id": 200158,
    "total": 2.00,
    "park_id": "21888"
  }
}
```

## 三、返回格式

### 返回字段

| 字段名称 | 类型 | 说明 | 是否必传 | 示例 |
| --- | --- | --- | --- | --- |
| state | Number | 调用结果：0 失败，1 成功 | 是 | 1 |
| errmsg | String | 提示信息 | 否 | Status 为 0 时必传 |
| trade_no | String | 交易流水号，由数字组成的字符串，16-32 位，不可低于 16 位，不可重复 | 是 | 20170921336435142 |

### 返回示例

```json
{
  "trade_no": "906281561706272689",
  "errmsg": "处理成功",
  "state": 1
}
```

## 四、注意事项

1. `sign` 为 `data` 的签名值，长度 32 位，需按泊链签名规则生成。
2. `data` 为 JSON 对象，包含 `park_id`、`park_union_id`、`total`、`coupon_amount`、`order_id`、`plate_number`、`trade_no`、`time_temp` 等字段。
3. `total` 和 `coupon_amount` 均为 Number 类型，单位为元，保留两位小数。
4. `order_id` 为车辆进场订单号，32 位以内，由字母、数字和下划线组成。
5. `trade_no` 由数字组成，长度 16-32 位，不可低于 16 位，不可重复。
6. `time_temp` 为 Unix 时间戳，精确到毫秒。
7. 返回字段中 `state` 为数字类型：`0` 表示失败，`1` 表示成功。
8. `errmsg` 在 `state` 为 0 时必传，用于提示失败原因。
9. 请求数据为 JSON 字符串格式提交。