6.3车主平台支付接口（车主平台到泊链）

## 一、接口信息

- **测试地址**：https://beta.bolink.club/unionapi/bolinkunifiedcarplat
- **线上地址**：https://s.bolink.club/unionapi/bolinkunifiedcarplat
- **接口方向**：车主平台 → 泊链
- **用途**：车主平台通过调用此接口到泊链下单支付，泊链调用 7.3 接口向车主平台发送订单支付结果信息
- **请求数据格式**：JSON 字符串

## 二、请求格式

### 请求字段

| 字段名称 | 类型 | 说明 | 是否必传 | 示例 |
| --- | --- | --- | --- | --- |
| union_id | Number | 厂商平台编号 | 是 | 200188 |
| sign | String | 数据 data 的签名值，32 位 | 是 | 225698D4739CD5D756581BBA3CA3F9FB |
| data | json | 包含下面所有字段的 json 对象 | 是 | {"title":"支付测试","ammount":"0.01",...} |
| park_id | String | 车场编号 | 是 | 21888 |
| park_union_id | Number | 车场所属厂商编号 | 是 | 200159 |
| amount | Number | 订单总金额，单位是元，保留两位小数 | 是 | 5.00 |
| order_id | String | 车辆进场订单号，32 位以内，字母数字和下划线组成 | 是 | 20171204152324414_RLF373 |
| plate_number | String | 车牌号 | 是 | 桂GGGTT08 |
| trade_no | String | 交易流水号，由数字组成的字符串，16-32 位，不可低于 16 位，不可重复 | 是 | 20170921336435142 |
| spbill_create_ip | String | 必须传正确的用户端 IP，支持 ipv4、ipv6 格式 | 否（h5 支付时必传） | 129.0.12.2 |
| channel | String | 支付客户端类型，目前 h5 仅支持微信传值：weixin、alipay | 是 | weixin |
| pay_type | Number | 0-扫码，1-h5 支付 | 是 | 0 |
| time_temp | String | 时间戳 unix 时间，到毫秒 | 是 | 1484369702556 |
| callback_url | String | 支付成功后跳转页面 | 否 | http://beta.bolink.club/unionapi/paysuccess?money=0.01 |
| cancel_url | String | 支付失败后跳转页面 | 否 | http://beta.bolink.club/unionapi/paysuccess?money=0.01 |
| show_page | Number | 当 pay_type 为 1 h5 支付时，此字段起作用，当为 1 时返回的支付链接带有页面 | 否 | 1 |

### 请求示例

```json
{
  "data": {
    "callback_url": "http://baidu.com",
    "amount": "0.01",
    "park_union_id": "200265",
    "park_id": "28888",
    "channel": "weixin",
    "trade_no": "100011561800390727",
    "time_temp": 1561800390,
    "pay_type": "0",
    "plate_number": "苏DTTTTT",
    "order_id": "A1_2C1561797447",
    "spbill_create_ip": "114.249.214.79"
  },
  "union_id": "200390",
  "sign": "225698D4739CD5D756581BBA3CA3F9FB"
}
```

## 三、返回格式

### 返回字段

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

### 返回示例

```json
{
  "out_trade_no": "H760UINSIIZ7X50N00IG",
  "errmsg": "下单成功",
  "payurl": "https://openauth.alipay.com/oauth2/publicAppAuthorize.htm?app_id=2017080408033352&scope=auth_base&redirect_uri=https%3a%2f%2fbeta.bolink.club%2funionapi%2funifiedalipay%3fpayid%3d3242%26paySceneNo%3d4",
  "trade_no": "100281561775915700",
  "state": 1
}
```

## 四、注意事项

1. `sign` 为 `data` 的签名值，长度 32 位，需按泊链签名规则生成。
2. `data` 为 JSON 对象，包含 `park_id`、`park_union_id`、`amount`、`order_id`、`plate_number`、`trade_no`、`channel`、`pay_type`、`time_temp` 等字段。
3. `amount` 为 Number 类型，单位为元，保留两位小数。
4. `order_id` 为车辆进场订单号，32 位以内，由字母、数字和下划线组成。
5. `trade_no` 由数字组成，长度 16-32 位，不可低于 16 位，不可重复。
6. `spbill_create_ip` 在 h5 支付时必传，需传正确的用户端 IP，支持 ipv4、ipv6 格式。
7. `channel` 为支付客户端类型，目前 h5 仅支持微信传值：`weixin`、`alipay`。
8. `pay_type` 为数字类型：`0` 扫码，`1` h5 支付。
9. `time_temp` 为 Unix 时间戳，精确到毫秒。
10. `callback_url`、`cancel_url` 分别为支付成功、失败后的跳转页面，非必传。
11. `show_page` 仅在 `pay_type` 为 1（h5 支付）时起作用，为 1 时返回的支付链接带有页面。
12. 返回字段中 `state` 为数字类型：`0` 表示失败，`1` 表示成功。
13. `errmsg` 在 `state` 为 0 时必传，用于提示失败原因。
14. 返回中的 `payurl` 为支付地址，`trade_no` 为交易流水号。
15. 请求数据为 JSON 字符串格式提交。
16. 返回示例中出现了 `out_trade_no` 字段，但返回字段表中未列出，可能为外部交易单号，对接时以实际返回为准。