扫码预消费完成/驶离 车辆驶离时对先前的扫码预冻结进行结算 (剩余金额会自动回退)
非常重要
其中,驶离用于无感支付和集成商支付,这不涉及通联支付的支付信息处理,因此,企业上传可以不需要包括通联支付的支付信息而仅仅上传愚佬会要求的附加信息。
- 通联支付的要求
● 支付信息
参数 |
名称 |
取值 |
可空 |
最大长度 |
备注 |
cusid |
商户号 |
通联支付在企业入网时分配 |
否 |
15 |
|
appid |
应用 ID |
通联支付在企业入网时分配 |
否 |
8 |
|
version |
版本号 |
接口版本 |
可 |
2 |
默认 12 |
reqsn |
商户交易单号 |
商户的交易订单号 |
否 |
32 |
保证平台唯一 |
trxamt |
交易金额 |
单位为分 |
否 |
15 |
|
oldtrxid |
预消费交易流水 |
收银宝平台流水 |
否 |
20 |
|
randomstr |
随机字符串 |
商户自行生成 |
否 |
32 |
|
signtype |
签名方式 |
|
是 |
8 |
默认 md5 |
sign |
签名 |
详见通联技术手册 |
否 |
32 |
|
● 签名 (请务必参见通联支付技术手册)
a 签名字符串为除了 sign 外的其他非空字段,加上分配的 key 的键值对。
b 所有参与签名的字段,按字段名的 ASCII 码升序排序,使用 URL 的键值对的格式(即 key1=value&key2=value2 )拼接成字符串 string 。
c sign = md5(string) ,并将 sign 值转换为大写。
d 所有字段值按 UTF-8 编码。
- 愚佬会的要求
● 附加信息 包括企业信息、订单信息
其中
企业信息指: Group 、Pro 、Co 、agentID 、agentFee 。
订单信息指: car 、LPRcolor 、LPR 、inTime 、outTime 、feeFrom 、Cash 、ylhCash 、fee 。
参数 |
名称 |
取值 |
可空 |
最大长度 |
备注 |
Group |
集团 |
企业所属上一级机构 |
否 |
20 |
非全数字 |
Pro |
省 |
企业停车场所在 |
否 |
5 |
国家法定的 "省" 编码 |
Co |
企业 |
6 位数字编码 |
否 |
6 |
全数字 |
agentID |
集成商 |
值为通联支付的 cusid |
可 |
15 |
可空,与企业(停车场)的 cusid 不同。 |
agentFee |
手续费及返点 |
/ 万 |
否 |
8 |
可以为 0,是停车场单独应付给集成商部分。 |
car |
车型 |
0 小型 1 中型 2 大型 |
否 |
3 |
|
LPRcolor |
车牌颜色 |
0 黑色 1 蓝色 3 黄色 5 绿色 |
否 |
3 |
|
LPR |
车牌号 |
如 琼A9EF98 |
否 |
20 |
|
inTime |
驶入时间 |
UnixTime |
否 |
14 |
预订情形下则是预订发生的时间 |
outTime |
驶离时间 |
UnixTime |
否 |
14 |
|
feeFrom |
计费起始时间 |
UnixTime |
否 |
14 |
需要考虑预订时段的费用是否在驶入时结算 |
Cash |
代付 |
用于集成商支付或停车场支付 |
可 |
8 |
分 |
ylhCash |
愚佬会代付 |
用于集成商支付 |
可 |
8 |
分 |
CashTo |
代付至 |
值为通联支付的 cusid |
可 |
15 |
可空 |
fee |
本次停车停车费 |
需要考虑无感支付请求时 preEnd 赋值 |
否 |
8 |
分 |
WuGanSign |
无感离场签名 |
|
可 |
32 |
|
ylhSign |
附加信息签名 |
仅对附加信息操作 |
否 |
32 |
采用 md5 算法 |
● 签名 (务请注意仅对附加信息操作)
a 对附加信息签名的签名字符串为除了 ylhSign 外的其他附加信息的非空字段,加上企业(集成商)登陆 www.pself.com/prepay/ 的 key 的键值对。
b 企业(集成商)登陆 www.pself.com/prepay/ 时会被要求输入登录密码(默认为123456),登陆后可修改,注意,key = md5( 修改后的登录密码 )。
c 所有参与 ylhSign 签名的附加信息字段,按字段名的 ASCII 码升序排序,使用 URL 的键值对的格式(即 key1=value&key2=value2 )拼接成字符串 ylhString 。
d ylhSign = md5 ( ylhString ) ,并将 ylhSign 值转换为大写。
e 所有字段值按 UTF-8 编码。
- 支付信息 POST 字符串与附加信息 POST 字符串的合并
支付信息的 POST 字符串 ( 加上签名 )
如: appid=...&cusid=...&sign=...
附加信息的 POST 字符串 ( 加上签名 )
如: agentFee=...&agengID=...&ylhSign=...
向服务器发送时合并的 POST 字符串
则是: appid=...&cusid=...&sign=...&agentFee=...&agengID=...&ylhSign=...
- 服务器
通联支付与愚佬会约定,根据通联支付技术文档企业需要与通联支付服务器交互的数据全部改为与愚佬会服务器交互
即: http://www.pself.com/prepay/dataCenter/finish.php 。
其中的支付信息,愚佬会将原样转发通联支付,通联支付的返回信息,愚佬会也原样转发企业。
其他的企业信息、订单信息则由愚佬会处理。
- 返回码
通联支付的交易返回码请见通联支付的相关技术文档 ( 通联支付帮助中心 )。
愚佬会的状态返回码 retcode = 'http' 指网络连接暂时故障。
愚佬会的订单返回码 ylhstatus 是:
100 在愚佬会系统中对应预消费的订单不存在
201 集成商支付通知 notify_agent 地址有错误
202 集成商支付通知失败
203 集成商支付通知成功
204 集成商支付通知被停车场拒绝
209 愚佬会已对附加信息进行相应处理
302 愚佬会对应预消费记录不存在
303 愚佬会对应预消费记录同步删除
500 再扫码( 重新进行预消费操作 )必须针对原定单( 不能生成车牌号重复的订单 )
800 企业在愚佬会系统中尚未创建
801 愚佬会附加信息部分签名错误( 可能更改了登陆密码 )
900 数据库故障
- 链接
通联支付帮助中心