测试地址:https://beta.bolink.club/unionapi/paymonthcard
正式地址:https://s.bolink.club/unionapi/paymonthcard
**应该场景:**
1、 用户微信扫码在微信中打开订单网址,云平台服务器调用此接口,取回预下单信息,当返回的状态(state)为1时,取出payurl参数,把用户微信请求跳转到payurl,完成下单,调起微信支付页面。
2、 云平台服务调用此接口,取回payurl后,生成二维码,用户扫码后发起支付。
**说明:当前支持微信、支付宝来发起支付**
请求数据:json字符串
| 字段名称 | 类型 | 说明 | 是否必传 | 示例 |
| --- | --- | --- | --- | --- |
| union_id | Number | 厂商平台账户 | 是 | 200159 |
| sign | String | 数据data的签名值 32位 | 是 | 51582ADA1872E38884E6119673021F7D |
| data | json | 包含下面的所有字段的json对象 | 是 | {“park_id”:”21787”,”amount”:”0.01”…} |
| park_id | String | 车场编号 | 是 | 21787 |
| amount |String | 金额,单位是元,保留两位小数 | 是 | 0.01 |
| card_id | String |月卡编号,32位以内,字母数字和下划线组成 | 否 | A1_2C1528943355 |
| trade_no | String |交易流水号,由数字组成的字符串,建议16-32位,不低于16位,不可重复。 | 是 | 201712125566359777 |
|notify_url | String | 支付结果异步回调地址,以http或https开头,回调是以post方法请求,地址不要包含参数信息 ; |是 | http://beta.bolink.club/unionapi/monthpaynotify |
| back_url | String | 支付成功后用户返回地址,为空时,返回到泊链默认页面 |否 | https://beta.bolink.club/unionapi/paysuccess?trace_no=201712125566359777 |
| cancel_url | String | 支付失败用户返回地址,为空时,返回到泊链默认页面 |否 |https://beta.bolink.club/unionapi/paysfail?trade_no=201712125566359777 |
| car_number | String |车牌 | 否 | 苏HHH000 |
| attach |Json | 附加信息,回调时返回 | 否 |{“order_id”:”abc123”} |
| pay_channel | String | 支付通道,微信(weixin)或支付宝(ali),接受weixin或ali两个参数值,默认微信 | 否 | weixin |
| time_temp | String | 时间戳,每次调用要改变,确保签名不一样。 | 是 | 1533035031600 |
|server_id | Number| 接收分账方互联互通工程服务商编号 ; 如车场不支持乐刷分账请勿传此字段| 否 ,is_separate_accounts为1时必传 | 800251 |
| split_amount | String | 分账金额 单位:元,保留两位小数 ; 如车场不支持乐刷分账请勿传此字段| 否,is_separate_accounts为1时必传 | 0.01 |
| is_separate_accounts |Number | 订单是否分账,0不分账,1 分账; 如车场不支持乐刷分账请勿传此字段 | 否 | 0 |
| useButton| Number| 是否启用自定义按钮,1-开启,0、不填\-关闭| 否,展示自定义按钮时必填|1
|
|buttonJson|Json| 小票按钮, 包含下面的所有字段的json对象|否| buttonJson:{"h5Url":"https://s.bolink.club/login.html","buttonName":"新按钮"}
| h5url|String| H5跳转链接 | 否,useButton为1时必填|https://www.baidu.com
| buttonName|按钮名称|String| 否 |查看详情
**示例:**
{"sign":"51582ADA1872E38884E6119673021F7D","union_id":200159,"data":{"back_url":"https://beta.bolink.club/unionapi/paysuccess?trace_no=201712125566359777","amount":"0.01","trade_no":"201712125566359777","cancel_url":"https://beta.bolink.club/unionapi/paysfail?trade_no=201712125566359777","park_id":"21787","attach":{"order_id":"abc123"},"car_number":"苏HHH000","notify_url":"http://beta.bolink.club/unionapi/monthnotify","pay_channel":"weixin","card_id":"A1_2C1528943355","time_temp":1533035031600,"buttonJson":{"h5Url":"www.baidu.com","buttonName":"测试按钮ABCDEFG"},"useButton":"1"}}
**泊链收到处理后,同步返回:json字符串**
| 字段名称 | 类型 | 说明 | 是否必传 | 示例 |
| --- | --- | --- | --- | --- |
| state | Number |调用结果 0失败,1成功 | 是 | 1 |
| errmsg |String | 错误提示信息 | 否 | Status为0时必传 |
|trade_no | String | 调用支付接口时传入的trade_no | 是 | 201712125566359777 |
| payurl | String | 支付地址,收到后,跳转,发起支付 | 是 | https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx85e16a11d32ee2e1&redirect_uri=https%3A%2F%2Fbeta.bolink.club%2Funionapi%2Fpaymonthcard%3Fkfc_id%3d9127&response_type=code&scope=snsapi_base&state=123#wechat_redirect |
**示例:**
{"trade_no":"201712125566359777","payurl":"https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx85e16a11d32ee2e1&redirect_uri=https%3A%2F%2Fbeta.bolink.club%2Funionapi%2Fpaymonthcard%3Fkfc_id%3d9127&response_type=code&scope=snsapi_base&state=123#wechat_redirect","state":1}
- 新版*泊链API接口文档(车场平台)
- 修订记录
- 一、概述
- 1.1接口协议
- 1.2数据签名
- 1.3请求地址
- 二、停车场相关接口
- 2.1发布停车场信息
- 2.2更新停车场信息
- 2.3 二维码获取
- 2.4车场进件页面接口
- 2.5 无牌车入场设置短信验证接口
- 2.6车场接口进件
- 三、交易与结算
- 3.1提交停车进场纪录
- 3.2提交停车出场记录
- 3.3月卡续费
- 3.4临停缴费
- 3.5获取乐刷分账签约地址接口
- 3.6接收分账方绑定接口
- 3.7ETC支付接口
- 3.8 逃单查询
- 3.9 逃单补缴
- 3.10 红包找零接口
- 3.11充电减免结果上传
- 四、订单对账接口
- 4.1 查询历史订单
- 4.2 订单退款
- 4.3车场订单电子支付状态查询接口
- 4.4提现查询接口
- 五、需要厂商平台实现的接口
- 5.1 查询实时订单金额
- 5.2 车牌无感状态及变更通知
- 5.3预付订单通知
- 5.4获取车辆进场图片
- 5.5电子收费异步返回结果
- 5.6电子订单退款异步返回结果
- 5.7无牌车入场请求
- 5.8月卡续费回调
- 5.9追缴订单异步返回结果
- 5.10 临停缴费回调
- 5.11 逃单补缴回调
- 5.12找零支出下发通知
- 5.13无牌车入场获取短信验证码接口
- 5.14 缴费减免通知
- 六、电子发票接口
- 6.1、电子发票开票订单上传接口
- 6.2、开票方信息查询接口
- 6.3、开取发票接口
- 6.4、发票状态回调接口
- 6.5、查询开票状态接口
- 七、无牌车开放接口
- 八、智慧社区上行通用接口文档
- 8.1接口协议
- 8.2数据签名
- 8.3登录接口
- 8.4小区数据采集接口
- 8.5设备信息采集
- 8.6人脸数据传输接口
- 8.7人员进出记录
- 8.8上报状态查询接口
- 8.9人脸门禁数据上报平台
- 九、智慧社区下行通用接口文档
- 9.1接收人员照片信息
- 十、数据上报上行接口
- 10.1停车场停车业务纠正
- 10.2在停业务总数查询
- 10.3在停业务详情查询
- 10.4市级车入场判定
- 10.5获取车道屏幕文字
- 10.6获取包月车信息(全量更新)
- 十一、数据上报下行接口
- 11.1抬杆指令下发通知
- 11.2车辆包月账单信息查询
- 11.3修改道闸余位
- 11.4新增\删除特殊车
- 11.5新增\删除\修改月卡车
- 11.6查询月卡车、特殊车
- 11.7开票记录通知