简要描述
- 该接口用于第三方通知储值车退费。按系统车位号(优先)或车主编号定位车位(都非空时以系统车位号为准)并校验退费金额后扣减储值车余额,并生成退费的缴费记录、缴费明细与储值车余额明细,
- 储值余额按车主维度扣减,扣减后不低于 0,退费后清空计费结果缓存并异步同步岗亭。仅储值车可退费。
- NoticeType 仅支持 0(新增或更新);传 1 报“储值车退费仅支持新增或更新操作!”。
请求URL
http://localhost:8888/Api/V2/OpenApi/Notice
请求方式
- POST
请求类型
- Content-Type:application/json
请求参数
Query参数
| 参数 | 类型 | 参数名 | 是否必填 | 描述 | 说明 |
|---|---|---|---|---|---|
| Route | query | string | yes | 路由信息 | 固定传 StoredCarRefund(大小写敏感) |
Body参数
| 参数 | 类型 | 参数名 | 是否必填 | 描述 | 说明 |
|---|---|---|---|---|---|
| ParkKey | body | string | yes | 停车场编号 | 本地停车场编号 |
| AppId | body | string | yes | 应用服务标识 | 本地停车场应用服务标识 |
| TimeStamp | body | string | yes | 时间戳 | 时间戳13位,精确到毫秒 |
| Nonce | body | string | yes | 随机字符串 | 随机字符串 |
| Sign | body | string | yes | 接口签名 | 按照接口鉴权生成的签名 |
| Data | body | object | yes | 具体数据 | 对应接口发送的数据对象 |
| » NoticeType | body | integer | yes | 通知类型 | 仅支持 0(新增或更新),对应枚举 210 StoredCarRefundNotice |
| » Items | body | [object] | yes | 数据集合 | 一次最多 50 条 |
| »» SystemSpotNumber | body | string | 二选一 | 系统车位号 | 与查询月租车记录接口返回的一致;非空时优先定位车位,忽略首尾空格与字母大小写 |
| »» OwnerNo | body | string | 二选一 | 车主编号 | 系统车位号为空时按其定位车位,与 SystemSpotNumber 至少传一个 |
| »» RefundAmount | body | number | yes | 退费金额 | 单位元,必须大于 0、最多两位小数且不能大于储值车账户余额 |
| »» Remarks | body | string | no | 退费备注 | 为空时按退费语义生成默认描述 |
请求示例
{
"ParkKey": "{{parkkey}}",
"AppId": "{{appid}}",
"TimeStamp": "{{timestamp}}",
"Nonce": "vqnkpzhigqhm",
"Sign": "rcjmptcxcqaqszkczkotjuny",
"Data": {
"NoticeType": 0,
"Items": [
{
"SystemSpotNumber": "A001",
"OwnerNo": "OWNER001",
"RefundAmount": 100.00,
"Remarks": "储值车退费"
}
]
}
}返回参数说明
| 参数 | 类型 | 参数名 | 是否必填 | 描述 | 说明 |
|---|---|---|---|---|---|
| ResultCode | integer | true | none | 请求结果代码 | 200:操作成功;1002:校验不通过;1005:本次退费未能完成;1003:未知异常 |
| ResultMsg | string | true | none | 请求提示信息 | 接口请求返回的信息提示,成功时为“本次退费操作成功!” |
| ResultId | string | true | none | 请求响应结果标识 | 每一次进行接口请求时,响应本次处理的标识 |
| Data | object¦null | false | none | 具体数据 | 成功时不返回(null) |
返回示例
{
"ResultCode": 200,
"ResultMsg": "本次退费操作成功!",
"ResultId": "500303426998439",
"Data": null
}作者:yrh 创建时间:2026-10-21 11:40
最后编辑:yrh 更新时间:2026-10-22 09:35
最后编辑:yrh 更新时间:2026-10-22 09:35