> ## Documentation Index
> Fetch the complete documentation index at: https://opendocs.xft.xin/llms.txt
> Use this file to discover all available pages before exploring further.

# 无感停车 V2

## 签约关系查询

**请求地址**: `https://xlink.91xft.cn/parking/aggegation/query/signed/relation/v2`

**请求参数**

| 字段              | 是否必选 | 字段类型   | 字段说明    |
| --------------- | ---- | ------ | ------- |
| `app_id`        | 是    | String | app\_id |
| `merchant_code` | 是    | String | 商户号     |
| `store_code`    | 是    | String | 停车场标识   |
| `channel`       | 否    | String | 支付渠道    |
| `sign_type`     | 是    | String | 签名类型    |
| `sign`          | 是    | String | 签名值     |
| `extra`         | 是    | String | 额外参数    |

**extra 说明**

| 字段             | 是否必选 | 字段类型   | 字段说明                                 |
| -------------- | ---- | ------ | ------------------------------------ |
| `trade_scene`  | 是    | String | 停车场景，默认 PARKING                      |
| `plate_number` | 否    | String | 车牌号，channel为WECHAT时sub\_openid和车牌号必传 |
| `sub_openid`   | 否    | String | 微信用户在子商户appid下的唯一标识                  |
| `openid`       | 否    | String | 微信用户在商户appid下的唯一标识                   |
| `jump_scene`   | 否    | String | 跳转场景，默认小程序，支持 APP/H5                 |

**响应参数**

| 字段             | 是否必选 | 字段类型   | 字段说明         |
| -------------- | ---- | ------ | ------------ |
| `sign_flag`    | 是    | String | 0：未签约；1：签约   |
| `channel`      | 是    | String | 用户开通的支付方式    |
| `plate_number` | 是    | String | 车牌号，多个以“;”分隔 |
| `failure_code` | 是    | String | 业务参数 code    |
| `failure_msg`  | 是    | String | 业务结果描述       |
| `sign_type`    | 是    | String | 签名类型         |
| `sign`         | 是    | String | 签名值          |
| `credential`   | 否    | String | 调用凭证         |

**credential 说明（WECHAT）**

| 字段               | 是否必选 | 字段类型   | 字段说明                 |
| ---------------- | ---- | ------ | -------------------- |
| `wx_app_id`      | 是    | String | 微信服务商 appId          |
| `wx_sub_app_id`  | 是    | String | 微信小程序 appId          |
| `wx_mch_id`      | 是    | String | 服务商微信商户号             |
| `wx_open_id`     | 否    | String | 用户在微信商户 appId 下唯一标识  |
| `wx_sub_mch_id`  | 是    | String | 停车场微信商户号             |
| `wx_sub_open_id` | 否    | String | 用户在微信子商户 appId 下唯一标识 |
| `path`           | 是    | String | 微信无感用户授权/开通跳转路径      |

## 车辆进场

**请求地址**: `https://xlink.91xft.cn/parking/aggegation/entry/v2`

**请求参数**: `app_id`, `merchant_code`, `out_trade_no`, `store_code`, `channel`, `sign_type`, `sign`, `extra`。

**extra 说明**：`trade_scene`(PARKING), `plate_number`, `start_time`(yyyyMMddHHmmss), `car_type`, `free_time`。

**响应参数**：`state` (0:失败 1:成功), `store_code`, `plate_number`, `failure_code`, `failure_msg`, `sign_type`, `sign`。

## 车辆出场

**请求地址**: `https://xlink.91xft.cn/parking/aggegation/entrance/v2`

**请求参数**

| 字段              | 是否必选 | 字段类型   | 字段说明     |
| --------------- | ---- | ------ | -------- |
| `app_id`        | 是    | String | app\_id  |
| `merchant_code` | 是    | String | 商户号      |
| `store_code`    | 是    | String | 停车场标识    |
| `out_trade_no`  | 是    | String | 商户订单号    |
| `channel`       | 否    | String | 支付渠道     |
| `amount`        | 是    | String | 支付金额（分）  |
| `notify_url`    | 否    | String | 异步通知 url |
| `body`          | 是    | String | 商品描述     |
| `subject`       | 是    | String | 商品标题     |
| `description`   | 是    | String | 备注信息     |
| `sign_type`     | 是    | String | 签名类型     |
| `sign`          | 是    | String | 签名值      |
| `client_ip`     | 否    | String | 客户端 IP   |
| `extra`         | 是    | String | 额外参数     |

**extra 说明**：`start_time`, `end_time`, `charging_time`, `plate_number`, `car_type`, `trade_scene`, `sub_app_id`(否)。

**响应参数**

| 字段               | 是否必选 | 字段类型   | 字段说明                     |
| ---------------- | ---- | ------ | ------------------------ |
| `out_trade_no`   | 是    | String | 商户订单号                    |
| `third_trade_no` | 否    | String | 第三方支付流水号（微信通道为异步返回）      |
| `body`           | 是    | String | 商品信息                     |
| `is_allow`       | 是    | String | SUCCESS允许；FAIL不允许；INIT待定 |
| `subject`        | 是    | String | 商品标题                     |
| `description`    | 是    | String | 备注信息                     |
| `channel`        | 是    | String | 支付渠道                     |
| `failure_code`   | 是    | String | 业务参数 code                |
| `failure_msg`    | 是    | String | 业务结果描述                   |
| `sign_type`      | 是    | String | 签名类型                     |
| `sign`           | 是    | String | 签名值                      |

## 无感订单查询

**请求地址**: `https://xlink.91xft.cn/parking/aggegation/query/charge/v2`

请求参数: `app_id`, `merchant_code`, `out_trade_no`, `third_trade_no`(否), `client_ip`, `extra`(否), `sign_type`, `sign`。

响应参数：`id`, `out_trade_no`, `amount`, `state`, `payer_id`, `subject`, `body`, `description`, `channel`, `product`, `store_code`, `operator_id`, `failure_code`, `failure_msg`, `sign_type`, `sign`。

## 异步通知

<Note>
  通知参数为 json 格式字符串
</Note>

| 字段               | 是否必选 | 字段类型   | 字段说明           |
| ---------------- | ---- | ------ | -------------- |
| `out_trade_no`   | 是    | String | 商户订单号          |
| `third_trade_no` | 是    | String | 第三方支付流水号       |
| `store_code`     | 是    | String | 停车场标识          |
| `body`           | 是    | String | 商品信息           |
| `channel`        | 否    | String | 支付渠道           |
| `amount`         | 是    | String | 支付金额（分）        |
| `subject`        | 是    | String | 商品标题           |
| `description`    | 是    | String | 备注信息           |
| `failure_code`   | 是    | String | 业务参数 code      |
| `failure_msg`    | 是    | String | 业务结果描述         |
| `state`          | 是    | String | 交易状态 00成功 01失败 |

**返回参数**：处理成功返回 SUCCESS，不分大小写。