# 预下单接口
最新更新时间:2023.06.13
· 在开放平台中入驻的停车场,用户可以通过开放平台直接进行缴费。 由于停车订单的计费业务在各个接入方,所以需要各个接入方提供一个外部接口由开放平台主动查询接入方平台的停车订单金额接口。
· 为保证开放平台请求接入方订单金额接口,该通信接口不需要包含任何加密机制,为了保证接入方平台的安全性,将开放平台ip作为服务的白名单,是开放平台可以在不 验签的情况下请求该接口。
· 接入方提供的订单金额接口按照本要求实现。
· 注:该接口需业务方返回部分下单所要的参数,请按照规范传参,否则可能导致支付回调后无法正确处理订单业务。
# 接口说明
请求URL: 由接入方提供该URL
请求方式: 请求方式统一为POST方式,且入参放入body,json。
请求参数
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
osStoreCode | 是 | string | 备案系统中停车场编码(开放平台门店Code) |
carPlate | 是 | string | 车牌号 |
carPlateColor | 是 | int | 车牌颜色枚举, 详细参见数据字典 |
orderId | 是 | string | 订单记录号(车辆在停车场唯一停车订单编号,支持数字 字母 _ -,最大长度32),车场方生成 |
返回参数
名称 | 类型 | 说明 |
---|---|---|
code | int | 请求是否成功 8888为成功 |
msg | string | 请求成功是为"success",请求失败时为失败原因 |
data | object | 返回数据 |
↪ orderId | string | 订单记录号(车辆在停车场唯一停车订单编号,支持数字 字母 _ -,最大长度32),车场方生成 |
↪ osStoreCode | long | 备案系统中停车场编码(开放平台门店Code) |
↪ carPlate | string | 车牌号 |
↪ carPlateColor | int | 车牌颜色枚举, 详细参见数据字典 |
↪ status | int | 车辆的在停状态,0在停 1已完结 |
↪ driveInTime | long | 车辆入场时间,时间戳,精确到秒 要求标准北京时间 |
↪ parkingDuration | int | 停车时长,单位:秒 |
↪ billingDuration | int | 实际计费时长,单位:秒 |
↪ billingFee | int | 订单计费金额,单位为人民币分 |
↪ paidFee | int | 订单已缴金额,单位为人民币分 |
↪ paymentFee | int | 本次计费实际需要用户缴纳的金额,单位为人民币分 |
↪ notifyUrl | string | 支付成功后通知地址 通知URL必须为直接可访问的URL,不允许携带查询串,要求必须为https地址。 |
↪ ownerTradeNo | string | 商户交易订单号,要求唯一 |
↪ remark | string | 给支付平台的附加信息,若用户成功发起支付,则会原封不动回调给业务方 |