简要描述
  • 该接口用于第三方通知储值车退费。按系统车位号(优先)或车主编号定位车位(都非空时以系统车位号为准)并校验退费金额后扣减储值车余额,并生成退费的缴费记录、缴费明细与储值车余额明细,
  • 储值余额按车主维度扣减,扣减后不低于 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