车牌识别版-pp对接-停车场系统

文档时间技术支持编写人D.T2018‐05‐232018‐05‐23新增全 对对接停车场系1.目准技术对接方已有一组可用的http服一SDK二socket直连 术语说上行与下对接需求概移动支商 月卡/次卡/储值移动支付接口详获取停车订订单支付结果停车场实时数据(停车位等)拉最近出入场车辆车辆自动支付权限车辆出场锁定获取停车记录4.84.85商券5.2月卡/次卡/签9.2 AA1A2A31.目本文档主要介绍了停车场系统如何和PP停车完成对接以实现移动支付流程并介绍了准针对停车场的网络环境,PP停车提供多种对接方已有一组可用的http服可以使用http的方式进行对接.由PP这边进行开发对接还没有相关的http服—道闸可以使用SDK,根据本文档进行开发注:目前SDK已经支持的语言:C#.后续会为的语言提供SDK二socket直连对于还未提供SDK的语言,可以采用socket直连的方式,根据本文档进行开发三程使用PP的程序(PPProxy-.zip)间接进行网络通信 根据本文档进行开发程序PPProxy的机制PPProxy安装在停车系统软件所在局域网的一台机器上.PPProxy会通过TCP与PP停车云平台PYun保持长连接.停车场系统软件直接和PPProxy通过局域网进行通信.PYun请求时,会先将请求到PPProxy上,然后PPProxy在将请求转发到停车场上行与上行:指停车场系统主动请求PP停车下行:指PP停车主动请求停车场如果没有特殊说明,本文的接口都是下行接口对接需求概Y8商户N2N2主要对接需求有:获取停车支付订单,订单支付结果通知,同步车辆列表(下行)车辆自动支付权限(下行)等.进一步介绍见下表:YYYY直接放行；超过额度则取消本次预标记；PP停车根据出场中返回的实际支付额度完成用户扣款Y用户可锁定车辆,锁定后,Na.停车信息:出入场时间、停车时长、金额、信息、员信息、出入b.信息:本地停车所有成功的记录，需要区分支付方式Y 后,PP停车会调用该接口完成入场开Y大型商场都具有多种,面对种类繁多的类型,PP停车为商场提供纯电子化YYPP停车为停车场提供月卡/次卡/储值卡续费的移动支付方案YY移动支付接口详停车场在开发过程中应保证数据的正确有效位,可能发起多次支付结果通知！)以免订单的多次支付.自动支付注意事项PP停车会提供当前用户可用额度如果出场时停车费用大于用户可用额度应拒停车场系统需标记该车辆当次停车费由PP停车代收方便后续对账.自动支付权限仅当次停车有效,若用户出场后,重新入场无效！开通自动支付权限时需验证车辆状态 如果车辆已出场应返回设置失败取消车辆自动支付权限时需验证车辆状态如果车辆已出场应返回设置失败.若车辆自动支付权限已取消,则车辆出场不放行(使用其他支付方式).若重复受到开通自动支付权限停车场应更新当前用户自动支付信用额度等相关当停车场检测到当前用户信用额度不足 应自动取消自动支付权限协议说明当用户在PP停车场时获取停车订单时,PP停车将发送该协议请求到停车场系统,通过请求Y服务名:Y版本号:Y字符集:YY停车场编号,由PPNNN用户通行证ID,N通道编号ID,无牌车时可传递触发开闸 为互斥参数.若传递 应答Y服务名:Y版本号:Y字符集:Y状态码1001订单获取成功,业务参数将返回1002未查询到停车信息1003月卡车辆,不允许支付1401签名错误,请检查配置1500接口处理异常Y状态码处理描述,如:返回错误信息YNNY停车流水,标识具体某次停车事件,需保证该停车场下唯一Y停车支付订单号,需保证该停车场下唯一.注:Y入场时间,格式yyyyMMddHHmmssYY总停车费用(单位分),为用户从入场到现在获取订单时的总费用Y已金额(单位分),为停车场在当前停车费用时已经给予的金额,如Y已支付金额(单位分为当次停车用户已经支付的金额比如当用户先支付了一笔后,超时未出场重新查询订单时须返回以支付金额.Y应支付金额(单位分这里停车场系统需处理如果结果为负数的情况直接返NNngN车辆所在位置信息例如:gY锁车标识:1已锁,0未锁,-1N自动支付状态:1已开启,0协议说明当用户完成支付后,PP停车将主动发起支付结果通知通知客户端订单支付结果.为保证通知正常处理,服务端可能发起多次支付结果通知,客户端需做好去重逻辑对于已经受到支付结果通知的订单,应应答通知成功,已告知服务端不必继续通知.Y服务名:Y版本号:Y字符集:YYY停车流水,原客户端提交Y停车支付订单号,原客户端提交N通道编号ID,时可传递触发开闸YPP停车支付流水,对账可用Y支付时间,格式:yyyyMMddHHmmssY支付金额(单位分Y0PP48Y支付来源说明,例如:PP应答参数Y服务名:Y版本号:Y字符集:Y1001接口处理成功1401签名错误,请检查配置1500接口内部处理失败YY状态码处理描述,如:返回错误信息协议说明PP停车将以固定频率调用该接口获取总停车位和场中车辆等数据的获取请求参数Y服务名:Y版本号:Y字符集:YY应答参数Y服务名:Y版本号:Y字符集:Y本次请求状态返回码示例:1001状态码含义1001获取成功,业务参数将返回1401签名错误,请检查配置1500接口处理异常Y当前请求应答结果,签名方法参考附录Y状态码处理描述,如:返回错误信息YY协议说明PP停车将固定频率调用该接口完成数据获取,时段每3分钟获取一次,非时30分钟获取一次.每次查询需返回时间范围内的所有出/入场车辆信息注请求参数Y服务名:Y版本号:Y字符集:YYY查询范围开始时间,格式:yyyyMMddHHmmssY查询范围结束时间,格式:yyyyMMddHHmmss应答参数Y服务名:Y版本号:Y字符集:Y本次请求状态返回码示例:1001状态码含义1001获取成功,业务参数将返回1401签名错误,请检查配置1500接口处理异常Y当前请求应答结果,签名方法参考附录Y状态码处理描述,如:返回错误信息N设备状态集合,对象参考后面的设备状态N入场车辆集合,对象参考后面车辆信息N出场车辆集合,对象参考后面车辆信息车辆信息NN车型NN车型:1小车,2大车,-1NNN支付停车卡物理ID,停车场系统识别的Y停车流水,标识具体某次停车事件,需保证该停车场下唯一Y入场时间,格式:yyyyMMddHHmmssYYY.N出场时间,格式:yyyyMMddHHmmssNNN.YYNNNY支付信息N停车支付订单号,现金支付无需返回Y平台支付流水,现金支付无需返回Y支付类型Y支付时间,格式:yyyyMMddHHmmssY支付金额(单位分注注:total_value=online_value+cash_value+prepaid_value+设备状态YY1:2:3:4:Y10:-1:协议说明当用户满足自动支付条件时 PP停车主停车场系统发起设置车辆自动支付权限注:车牌自动支付出场的,需写入一条支付记录,标记该笔订单由PP停车扣 请求参数Y服务名:Y版本号:Y字符集:YYY当前用户可用信用额度(分),credits大于零则开启Y停车流水,标识具体某次停车事件,需保证该停车场下唯一N0PP48N支付来源说明,例如:PPY锁定车辆,后可出场:1锁定,0不锁应答参数Y服务名:Y版本号:Y字符集:本次请求状态返回码示例:1001状态码含义Y1001接口处理成功,业务参数将返回10021401签名错误请检查配置.1403车辆已出1500接口处理异常Y当前请求应答结果,签名方法参考附录Y状态码处理描述,如:返回错误信息协议说明该协议主要用于车牌识别停车场,当用户设置车辆安全锁定后,用户离场前主动触发解请求参数Y服务名:Y版本号:Y字符集:YYY停车流水,标识具体某次停车事件,需保证该停车场下唯一Y锁车状态:1锁定,应答参数Y服务名:Y版本号:Y字符集:Y本次请求状态返回码示例:1001状态码含义1001接口处理成功,业务参数将返回10021401签名错误,请检查配置1403车辆已出场1400参数错误,请检查参数1500接口处理异常Y当前请求应答结果,签名方法参考附录Y状态码处理描述,如:返回错误信息协议说明该协议主要用于处理异常订单,方便PP停车拉取订单详情,已方便对账以及异常订单处Y服务名:Y版本号:Y字符集:YYY应答参数Y服务名:Y版本号:Y字符集:Y本次请求状态返回码示例:1001状态码含义1001获取成功,业务参数将返回1002未查询到停车信息1401签名错误,请检查配置1500接口处理异常Y当前请求应答结果,签名方法参考附录Y状态码处理描述,如:返回错误信息NNN支付停车卡物理ID,停车场系统识别的N车型NN车型:1小车,2大车,-1Y停车流水,标识具体某次停车事件,需保证该停车场下唯一Y入场时间,格式yyyyMMddHHmmssYYY.Y停车时长(单位秒N 金额(单位分)N出场时间,格式:yyyyMMddHHmmssNNN.YY支付信息N停车支付订单号,现金支付无需返回Y平台支付流水,现金支付无需返回Y支付类型Y支付时间,格式Y支付金额(单位分说明为实现无人值守针对无牌车通过扫码后平台会调用该接口完成入场开闸.若短时间重请求参数Y服务名:Y版本号:Y字符集:YYY用户通行证ID,停车场可用作虚拟卡ID,Y通道编号应答参数Y服务名:Y版本号:Y字符集:Y本次请求状态返回码示例:1001状态码含义1001操作成功1002未检测到车辆1401签名错误,请检查配置1403短时间重复入场1500接口处理异常Y当前请求应答结果,签名方法参考附录Y状态码处理描述,如:返回错误信息Y入场时间,格式YY停车时长,单位Y停车流水商户券接口详商户根据到停车系统后,若未清除则本次停车均有效;出场时停车场系统应自动查询出金额、已支付金额,来判断是否需要收取现金.协议说明无论用户移动支付或现金支付动抵扣停车费停车场系统均到本次无论用户移动支付或现金支付动抵扣停车费停车场系统均到本次停车关联的停并请求参数Y服务名:Y版本号:Y字符集:YYN停车流水,标识具体某次停车事件,需保证该停车场下唯一NYY类型:1金额,2时长,3全免,4Y金额N给予原因,例如:购物满300,免费停车2小时NNN券减免规则ID用于配置减免是减免前面还是减免后面一般一个停N则规则ID用于配置改应答参数Y服务名:Y版本号:Y字符集:Y本次请求状态返回码示例:1001状态码含义1002停车信息未找到1403当前车辆已享受其他1401签名错误,请检查配置1500接口处理异常Y当前请求应答结果,签名方法参考附录Y状态码处理描述,如:返回错误信息注一次停车在停车系统只允许存在一条有效信息提交到停车场系统后,默认立即生效,且仅本次停车有效该商户给予后,在获取停车订单时,接口应返回相应的信息若提交enfore给予券 则本次停车已有的使用本次提交的替换接口提交的voucher用于消费对账,不用于账单核销,停车场系统实现可作为协议说明用于在错误是,清空指定停车记录已的商户是否是在特定时间内才可以撤回还是任意时间都能撤这样有点不合理,如果车主离开商场了,出场时发现券没了,这时候会引起争议的;嗯,那是否限制发出去后10分钟后不可撤销.如果发出去5分钟内车主离场了但是6分钟后才发觉发错了这时候撤不回怎么如果发现已经出场,那么返回无法撤销,车辆已出场.Y服务名:Y版本号:Y字符集:YYY应答参数Y服务名:Y版本号:Y字符集:Y本次请求状态返回码示例:1001状态码含义1002停车信息未找到1401签名错误,请检查配置1500接口处理异常Y当前请求应答结果,签名方法参考附录Y状态码处理描述,如:返回错误信息月卡/次卡/储值卡接协议说明PP停车发起向停车场,查询指定车辆月卡/次卡/储值卡信息,停车场返回对应车牌/客户请求参数Y服务名:Y版本号:Y字符集:YYN应答参数Y服务名:Y版本号:Y字符集:Y本次请求状态返回码示例:1001状态码含义1001接口处理成功,业务参数将返回1002没有查到相关贵宾记录1401签名错误,请检查配置1500接口处理异常Y当前请求应答结果,签名方法参考附录Y状态码处理描述,如:返回错误信息N贵宾集合,即月卡/次卡/储值卡中的一种,对象参考后面贵宾信息贵宾信息Y客户YNNN标准类型标识;例如:MON_A、N当前贵宾标准描述;例如:月卡N单价,单位分Y绑定的号Y绑定 号Y办理时间,格式:Y过期时间,格式:Y0Y储值为余额单位分;注:若月卡当前到期则balance=0,按照此规则计协议说明PP停车发起请求,对月卡,次卡或储值卡进行续费请求参数Y服务名:Y版本号:Y字符集:YYNNNY续费时间,格式:Y支付流水,用于对账Y客户支付金额,单位分Y贵宾类型:(参考以停车场为准)0Y续费金额储值续费金额单位分;应答参数Y服务名:Y版本号:Y字符集:Y本次请求状态返回码示例:1001状态码含义1001接口处理成功,业务参数将返回1002没有查到相关贵宾记录1401签名错误,请检查配置1500接口处理异常Y当前请求应答结果,签名方法参考附录Y状态码处理描述,如:返回错误信息其他接协议说明PP停车在需要停车场本地文件业务处理时通过本协议获取指定文件请求参数Y服务名:Y版本号:Y字符集:YYY指定的上 Y指定文件权限,1公开,0私N上传有效时间,单位Y例: YY应答参数Y服务名:Y版本号:Y字符集:Y本次请求状态返回码示例:1001状态码含义1001获取成功,业务参数将返回1400参数错误,请检查参数1401签名错误,请检查配置1500接口处理异常Y当前请求应答结果,签名方法参考附录Y状态码处理描述,如:返回错误信息Y协议说明PP停车在需要停车场本地文件业务处理时通过本协议获取指定文件请求参数Y服务名 Y版本号:Y字符集:YYN N执行参数N等待执行结束,0不等待,1等待N执行超时时间,单位应答参数Y服务名 Y版本号:Y字符集:Y本次请求状态返回码示例:1001状态码含义1001获取成功,业务参数将返回1400参数错误,请检查参数1401签名错误,请检查配置1500接口处理异常Y当前请求应答结果,签名方法参考附录Y状态码处理描述,如:返回错误信息N执行完成退出码,当waite_exit=1返回N执行输出结果,当waite_exit=1返回特殊情况和相应的 每次获取订单都应将本次停车之前未成功支付的订单状态标记为已撤销关于现金支付:若是支付,用户先获取订单,然后在亭完成现金支付后,本次停车之前的所有未受到支付通知的订单都标记为已撤销.注:简单的说就是对于当次停车,只有的一条支付记录是可处理的.如果的支付记录是现金支付,那么之前的未支付订单状态都不可被支付.若用户获取订单后未支付,走现金支付了;之