第三方对接简要说明
第三方静态码接入云平台简要说明
一、前期准备：
1、在云平台部署好停车场各个设置（可联系客服人员协助部署）；
2、获取ClientID、ClientSecret、项目编码、场区编码、通道编码等参数；
二、通用接口：
1、获取token：获取方式见文档《车安CSC平台接入指南V2.0(20201216).pdf》（由客服提供）
https://openapi.carsafe.cn/index.html
三、概念说明：
1、入口静态码：一般用于停车场无牌车扫码入场（二维码需带上场区编码、通道编码，可方便第三方系统业务处理）
2、场内静态码：一般用于停车场场内临停收费（二维码需带上场区编码，可方便第三方系统业务处理）
3、出口静态码：一般用于停车场无牌车扫码出场或车辆出场缴费（二维码需带上场区编码、通道编码，可方便第三方系统业务处理）
四、流程指引：
1、无牌车静态入场：
①、车主入口扫【入口静态码】：第三方系统调用接口【场区通道状态】，查询通道当前状态（无车、有车无牌、有车有牌），一般只允许有车无牌状态进行无牌车入场业务，当然不进行这个判断也是可以的，由第三方系统自行决定；
②、第三方系统获取扫码微信openID，生成临时车牌（也可以是车主自行输入，但不建议）（记录微信openID与临时车牌关系），调用接口【请求进出场】，通知云平台车辆入场信息；如允许入场这直接开闸放行，不允许入场会有对应提示信息返回；
2、场内缴费：
①、车主场内扫【场内静态码】：第三方系统获取扫码微信openID，获取临时车牌，获取到可以直接计费，获取不到则展示车牌输入界面，由车主输入车牌；
②、第三方系统根据车牌调用接口【统一下单】，向云平台查询车辆停车费用；根据费用向车主收费，收费完成后调用接口【支付结果通知】，通知云平台收费成功；
3、车辆出场：
①车主出口扫【出口静态码】：第三方系统调用接口【场区通道状态】，查询通道当前状态（无车、有车无牌、有车有牌）；
②有车有牌：根据车牌调用【统一下单】和【支付结果通知】完成支付，云平台自动放行出场；
③有车无牌：第三方系统获取扫码微信openID，获取临时车牌，获取到可以直接计费，获取不到则获取不到则展示车牌输入界面，由车主输入车牌；再根据车牌调用【统一下单】和【支付结果通知】完成支付，再调用接口【请求进出场】，通知云平台车辆出场信息
④无车：可以提示车主倒车重新识别（也可以按无牌车处理，但不建议）
五、接口说明：
1、接口协议地址：https://openapi.carsafe.cn/index.html?urls.primaryName
2、接口分为多个版本，版本越高功能越全面，建议对接时按最高版本进行对接，网页界面右上角可切换版本；
3、【场区通道状态】：/standard/v{api-version}/car_pass/passageway_status；
4、【请求进出场】：/standard/v{api-version}/car_pass/request_pass；
5、【统一下单】：/standard/v{api-version}/charge/unified_order；
6、【支付结果通知】：/standard/v{api-version}/charge/pay_notify；
六、接口细节：
1、接口“/standard/v{api-version}/charge/unified_order”【统一下单】；
①、"Amount":500, //应收金额--指车辆本次【停车场计费】得出应该收取的停车费用金额；
②、"Discount":100, //折扣金额--指车辆本次【停车场计费】时，参与优惠被减免的金额；
③、"DiscountAmount":400," //折后金额--指车辆本次【停车场计费】最终，应向车主收取的金额；
2、接口“/standard/v{api-version}/charge/pay_notify”【支付结果通知】
①、"Amount":300, //实收金额--指【第三方收费渠道】本次收费实际收到的金额；
②、"DiscountFee":100, //优惠金额--指【第三方收费渠道】本次收费过程中，为停车费用添加的优惠金额；（部分【第三方收费渠道】在车场系统计费后，会额外添加自有的会员积分抵扣之类的优惠）
③、"DiscountTypeCode":1, //优惠类型--指【第三方收费渠道】本次收费过程中，是否有为停车费用添加优惠；（部分【第三方收费渠道】在车场系统计费后，会额外添加自有的会员积分抵扣之类的优惠）
3、如【第三方收费渠道】本身无额外添加优惠的需求，则："DiscountTypeCode"传0；"DiscountFee"传0；
4、原则上 接口【统一下单】的参数："DiscountAmount"与接口【支付结果通知】的参数："Amount"、"DiscountFee"存在如下关系
"DiscountAmount"【统一下单】 ＝ "Amount"【支付结果通知】＋"DiscountFee"【支付结果通知】
第三方支付回调流程
1、第三方系统调用接口《/standard/v{api-version}/charge/set_payment_channel》注册回调接口：设置支付渠道信息，写入支付渠道信息
2、车场系统保存支付渠道
3、车辆出场，需缴费，车场系统向支付渠道请求获取《支付链接地址》
4、第三方系统返回《支付链接地址》
5、车场系统将《支付链接地址》转换成二维码显示在出口显示屏设备上。
6、车主扫码，进入第三方系统支付界面，完成支付
7、第三方系统调用接口《/standard/v{api-version}/charge/pay_notify》支付结果通知，通知车场系统，费用已收到
8、车场系统开闸，放行车辆出场，记录通行记录。
第三方无牌车码回调流程
1、第三方系统调用接口《/standard/v{api-version}/car_pass/qrcode》设定自定义通行二维码，写入无牌车通行码获取地址
2、车场系统保存《无牌车通行码获取地址》
3、车辆出入场，系统识别到是无牌车，回调《无牌车通行码获取地址》，获取《无牌车通行二维码链接》
4、第三方系统返回《无牌车通行二维码链接》
5、车场系统将《无牌车通行二维码链接》转换成二维码显示在出入口显示屏设备上。
6、车主扫码，进入第三方系统界面，第三方系统分配车牌；
7、第三方系统调用接口《/standard/v{api-version}/car_pass/request_pass》请求进出场，通知车场系统车牌。
8、车场系统开闸，放行车辆出场，记录通行记录。
9、《/standard/v{api-version}/car_pass/request_pass》请求进出场接口--特别说明：V4版本自带开闸功能，开闸失败则不生成通行记录，V1、V2版本不带开闸功能，调用直接生成通行记录，如需同步开闸，则调用《/standard/v{api-version}/car_pass/passageway》通道放行/关闭，进行开闸；
10、第三方系统处理流程建议： 入场生成临牌，绑定车主微信openID，调用接口入场；出场时根据微信openID检索对应的入场车牌，进行计费，收费，完成收费流程后调用接口出场；（临牌汉字建议使用“临”）
一卡通app应用接口
6.34 获取消费优惠类型列表：获取商家优惠信息；6.50 商家打折：为车辆添加商家优惠券；6.1 停车查询：计算停车费用；6.2 停车缴费：提交费用；
有优惠时，按【6.34】→【6.50】→【6.1】→【6.2】的顺序调用；先添加优惠券，再计算费用，再提交费用
无优惠时，按【6.1】→【6.2】的顺序调用；直接计算费用，再提交费用
