扫码预消费完成/驶离 车辆驶离时对先前的扫码预冻结进行结算 (剩余金额会自动回退)

  非常重要

  其中,驶离用于无感支付和集成商支付,这不涉及通联支付的支付信息处理,因此,企业上传可以不需要包括通联支付的支付信息而仅仅上传愚佬会要求的附加信息。


 - 通联支付的要求

  ● 支付信息

参数 名称 取值 可空 最大长度 备注
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  数据库故障


 - 链接

  通联支付帮助中心



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