扫码预消费　扫码时预先冻结一个时段的停车费

　　对于停车场停车，扫码（场内或场外张贴的二维码）不再是对本次停车停车费进行结算，而是冻结自车辆驶入停车场起一个时段（比如一天）的停车费，待车辆驶离停车场后再结算。
　　对于城市道路停车，同理，扫码（竖立在路边的二维码）也只是冻结一个时段（比如一天）的停车费并开始计时，待车主驶离的时候再次扫码而结束停车时再结算。


　－　通联支付的要求

　　●　支付信息

参数 名称 取值 可空 最大长度 备注
cusid 商户号 通联支付在企业入网时分配 否 15
appid 应用 ID 通联支付在企业入网时分配 否 8
version 版本号 接口版本 可 2 默认 12
trxamt 交易金额 单位为分 否 15
reqsn 商户交易单号 商户的交易订单号 否 32 保证平台唯一
paytype 交易方式 详见通联技术手册 否 3
randomstr 随机字符串 商户自行生成 否 32
body 订单标题 为空则以商户名作为订单商品名称 是 100 50 个中文字符
remark 备注 备注信息 是 160 80 个中文字符
validtime 有效时间 单位分钟（默认 5 分钟） 是 2 最大 60 分钟
authcode 支付授权码 微信或支付宝的付款二维码 是 32
acct 支付平台用户标识 微信 openid 支付宝 user_id 是 32
notify_url 交易结果通知地址 必须可直接访问且不能携带参数 是 256 对于刷卡支付无效
limit_pay 支付限制 no_credit 不能使用信用卡 是 32 暂时只对微信和支付宝有效，仅支持 no_credit 。
sub_appid 微信子 appid 小程序／公众号／ App 的 appid 是 32 只对微信支付有效
subbranch 门店号 是 4
cusip 终端 ip 用户下单和调起支付的终端 ip 地址 是 16
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 、repayTime 、notify_agent 。
　　　　托管信息指： ADMINonRoad 、IDonRoad 、FEEonRoad 。

参数 名称 取值 可空 最大长度 备注
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
repayTime 再支付的临界时间 UnixTime 否 14 超过此时间将在出口产生二次计费
notify_agent 集成商支付通知 由集成商与停车场协商（指向停车场） 可 256 可空
ADMINonRoad 托管企业 值为通联支付的 cusid 可 15 用于城市道路停车
IDonRoad 车位组标识 相当于道路停车车位编码 可 20 用于城市道路停车
FEEonRoad 托管手续费 ／ 万 可 15 用于城市道路停车
ylhSign 附加信息签名 仅对附加信息操作 否 32 采用 md5 算法
　　　　　　　 调用预消费 API 返回成功时，对于已无感支付当前记录的结束由企业（集成商）自行变更标记，无需再调用 API 或等待愚佬会通知 。


　　●　签名 （务请注意仅对附加信息操作）

　　　　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 编码。


　　●　将 "附加信息" 作为测试发送给愚佬会

　　　　a　测试时，您可以将 "附加信息" 作为测试信息发送给愚佬会，此种情形下可以令 ylhkey = 123456 。
　　　　b　注意，令 ylhkey = 123456 仅限测试。


　－　支付信息 POST 字符串与附加信息 POST 字符串的合并

　　　　　支付信息的 POST 字符串 （ 加上签名 ）

　　　　　如： appid=...&cusid=...&sign=...

　　　　　附加信息的 POST 字符串 （ 加上签名 ）

　　　　　如： agentFee=...&agengID=...&ylhSign=...


　　　　　向服务器发送时合并的 POST 字符串

　　　　　则是： appid=...&cusid=...&sign=...&agentFee=...&agengID=...&ylhSign=...


　－　特别注意

　　　　为了弥补扫码预交的停车费可能不足，车主在驾车驶离停车场前可以再次发起扫码，企业接收新的扫码时需将前次扫码交易回退。

　　　　即： 每次扫码预交停车费都是从车辆驶入停车场或预订开始时预交停车费。


　－　服务器

　　　　通联支付与愚佬会约定，根据通联支付技术文档企业需要与通联支付服务器交互的数据全部改为与愚佬会服务器交互

　　　　即： http://www.pself.com/prepay/dataCenter/pay.php 。

　　　　其中的支付信息，愚佬会将原样转发通联支付，通联支付的返回信息，愚佬会也原样转发企业。
　　　　其他的企业信息、订单信息、（城市道路停车）托管信息则由愚佬会处理。


　－　返回码

　　　　通联支付的交易返回码请见通联支付的相关技术文档 （ 通联支付帮助中心 ）。

　　　　愚佬会的状态返回码 retcode = 'http' 指网络连接暂时故障。

　　　　愚佬会的订单返回码 ylhstatus 是：

　　　　100 　在愚佬会系统中对应预消费的订单不存在
　　　　201 　集成商支付通知 notify_agent 地址有错误
　　　　202 　集成商支付通知失败
　　　　203 　集成商支付通知成功
　　　　204 　集成商支付通知被停车场拒绝
　　　　209 　愚佬会已对附加信息进行相应处理
　　　　302 　愚佬会对应预消费记录不存在
　　　　303 　愚佬会对应预消费记录同步删除
　　　　500 　再扫码（ 重新进行预消费操作 ）必须针对原定单（ 不能生成车牌号重复的订单 ）
　　　　800 　企业在愚佬会系统中尚未创建
　　　　801 　愚佬会附加信息部分签名错误（ 可能更改了登陆密码 ）
　　　　900 　数据库故障


　－　链接

　　通联支付帮助中心


　－　Q&A

　　　　Q　企业？
　　　　A　本在线文档所称 "企业" 具有 "省" 属性和上一级的 "集团" 属性，有时也称 "停车场" 。

　　　　Q　企业参数中的集团 Group 、省 Pro 、企业 Co 是如何获取的？
　　　　A　企业调用通联支付／愚佬会的 API 前需要在通联支付入网开户，入网开户时，企业可以获得通联支付的 cusid 和 key 值，同时还可以获得愚佬会的 Group 、Pro 、Co 值。

　　　　Q　返回 "企业尚未在愚佬会系统中创建" 是什么意思？
　　　　A　这说明您设置的 Group 、Pro 、Co 三个参数中有一个是错误的，或愚佬会系统正在处理中。

　　　　Q　如何修改 ylhkey 值？
　　　　A　企业获得 Group 、Pro 、Co 值时 ylhkey 值默认 123456 ，企业可以登陆 www.pself.com/prepay/ 进行 ylhkey 的修改。

　　　　Q　集成商？
　　　　A　本在线文档所称 "集成商" 是可以通过其服务器将企业（停车场）的数据与愚佬会服务器 交互，或能与企业（停车场）协商将支付数据通过愚佬会的 "集成商支付通知" 与企业（停车场）交互。对于后者，即要求集成商能取 得 "集成商支付通知" 所需要的通知地址 notify_agent （ 赋值在 "预消费" API ）。




海口愚佬会教育科技有限公司 0898 - 36393679 琼 ICP 备 12001248号－1 版权所有 © 2004 - 2025