当前位置: 产品API > 增值 > UPark-无感支付
产品介绍
  • 服务对象
    有停车需要的持卡人
  • 产品详情

    无感支付业务流程:业务流程.png

  • 产品亮点

    ◆ 简单快速 

        用户离场快、系统上线快

    ◆ 开放共享 

        绑定关系、用户体系、支持的停车场

    ◆ 易于推广 

        多种形式营销活动(立减、满减、随机立减)、优惠券、权益配置


应答码参照
应答码状态列表
  • 应答码 描述 解决方案
    00 承兑或交易成功 暂无
    01 交易失败 暂无
    13 无效金额(1、理应出现有效金额的交易中,金额域填0或其他非法值;2、超转付金额累计/超现付金额累计;3、交易超消费比例;4、小费金额超限) 暂无
    25 未开通无感支付 暂无
    30 报文格式错误 暂无
    94 重复交易 展开详情

    1、用于检测到原始交易是重复的交易;2、委托关系已存在;3、交易序列号重复。

    94 重复交易 展开详情

    1、用于检测到原始交易是重复的交易; 2、委托关系已经存在; 3、交易序号重复。

    A0 验签失败 暂无
    E1 用户号码无效(不在停车场有效车牌内) 暂无
    E3 费用已缴 暂无
    F2 交易超时 暂无
报文示例

1.请求报文示例

    对所有待签名参数按照字段名的 ASCII 码从小到大排序(字典序)后,使用 URL 键值对的格式(即 key1=value1&key2=value2…)拼接成字符串 string1。这里需要注意 的是所有参数名均为小写字符,即等号(=)左边的值在计算签名时,转换为小写。对 string1 作 sha256 加密,字段名和字段值都采用原始值,不进行 URL 转义。

    即 sign=sha256(string1)。

     示例

     假设双方约定 KEY 为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y 

                   usr_num=粤 A11111 

                   buss_code=G0_5800_0001 

                   key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y 


a) 步骤 1. 

    对所有待签名参数按照字段名的 ASCII 码从小到大排序(字典序)后,使用 URL 键值对的格式(即 key1=value1&key2=value2…)拼接成字符串 string1:

      buss_code= G0_5800_0001&key=2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y&usr_num= 粤 A11111 

b) 步骤 2. 

    对 string1 进行 sha256 签名,得到 sign: 

      ****************************************


 2. 应答报文示例

 样例:

{“return_code”:”00”,

“msg”:”成功”,

”bind_time”:” 2017-09-04 12:00:00”}


API接口
进场通知接口
接口描述
车辆入场时由停车场通知智慧停车平台,用于客户端页面展示用户已经进入停车场并显示停车时长。入场通知推送触发,计时开始。
请求方式
POST
生产地址
https://billcloud.unionpay.com/ccback/collection/in
测试地址
http://test.billcloud.unionpay.com/ccback/collection/in
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
车牌号 usr_num string M-必填 车主在银联绑定的车牌号。   
业务代码 buss_cd string M-必填 缴费项目代码,由银联分配,举例:G0_5800_0001。   
停车场编号 park_no string M-必填   
停车场名称 park_name string M-必填   
停车流水号 ref_no string M-必填 同一停车场的唯一流水号。   
时间戳 entry_time string M-必填 举例:2017-03-30 01:02:03。   
签名 sign string M-必填 签名,将上述参数按照指定方式进行签名,使 用 SHA256 算法。   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 return_code string M-必填   
应答信息 msgmsg string M-必填 应答信息。   
示例代码
请求代码
1
2
3
4
假设双方约定KEY为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y


应答代码
1
2
3
4
5
{
“return_code”:“00 ”,
“msg ”:“成功 ”,
“bind_time”:“ 2017-09 -04 12:00:00
 }


离场通知接口
接口描述
车辆 离场时由停车通知智慧平台 场时由停车通知智慧平台 场时由停车通知智慧平台 场时由停车通知智慧平台 (该 接口 推荐 在抬杆 离场 的时候发送 的时候发送 ), 用于客户端页面取消展显示停车时长。 用于客户端页面取消展显示停车时长。
请求方式
POST
生产地址
https://billcloud.unionpay.com/ccback/collection/out
测试地址
http://test.billcloud.unionpay.com/ccback/collection/out
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
车牌号 usr_num string M-必填 车主在银联绑定的车牌号。   
业务代码 buss_cd string M-必填 缴费项目代码,由银联分配,举例G0_5800_0001。   
停车场编号 park_no string M-必填   
停车场名称 park_name string M-必填   
停车流水号 ref_no string M-必填 同一停车场的唯一流水号。   
时间戳 exit_time string M-必填 举例:2017-03-30-01:02:03。   
签名 sign string M-必填 签名,将上述参数按照指定方式进行签名,签名方式使用SHA256算法。   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 return_code string M-必填   
应答信息 msg string M-必填 应答信息。   
示例代码
请求代码
1
2
3
4
假设双方约定KEY为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y


应答代码
1
2
3
4
5
{
“return_code”:“00 ”,
“msg ”:“成功 ”,
“bind_time”:“ 2017-09 -04 12:00:00
 }


车牌无感支付查询接口
接口描述
查询车牌是否已开通无感支付,判断车辆离场时是否使用无感支付。
请求方式
POST
生产地址
https://billcloud.unionpay.com/ccback/collection/query
测试地址
http://test.billcloud.unionpay.com/ccback/collection/query
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
业务代码 buss_cd string M-必填 缴费项目代码,由银联分配,举例G0_5800_0001。   
车牌号 usr_num string M-必填 车牌号,举例:粤A11111。   
停车场编号 park_no string O-选填 停车场上送,一般是停车场服务器对对接停车场的编号,例如001。   
停车场名称 park_name string O-选填   
签名 sign string M-必填 签名,将上述参数按照指定方式进行签名,签名方式使用SHA256算法。   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 return_code string M-必填 00-开通 25-未开通。   
应答信息 msg string M-必填 应答信息。   
示例代码
请求代码
1
2
3
4
假设双方约定KEY为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y


应答代码
1
2
3
4
5
{
“return_code”:“00 ”,
“msg ”:“成功 ”,
“bind_time”:“ 2017-09 -04 12:00:00
 }


停车场账单推送接口
接口描述
车主出停车场,抬杆,停车场结算账单推送给银联,支持同步接收结果与异步接收结果。
请求方式
POST
生产地址
https://billcloud.unionpay.com/ccback/collection/charge
测试地址
http://test.billcloud.unionpay.com/ccback/collection/charge
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
业务代码 buss_cd string M-必填 缴费项目代码,由银联分配,举例G0_5800_0001。   
账单编号 bill_no string M-必填 停车场提供,唯一标识账单,建议以yyyymmddhhmmss+n位序列号的形式上传,举例:20171016161055001或201710161610550001。   
车牌号 usr_num string M-必填 车牌号,举例:粤A11111。   
停车场编号 park_no string M-必填 停车场上送,一般是停车场服务器对对接停车场的编号,例如001。   
停车场名称 park_name string M-必填   
账单金额 bill_at string M-必填 本次停车费用,以分为单位,举例:100.56元即上送10056。   
实际支付金额 pay_at string M-必填 本次实际停车费用,以分为单位,举例:100.56元即上送10056。   
入停车场时间 start_time string M-必填 举例:2017-03-30 01:02:03。   
出停车场时间 pay_time string M-必填 举例:2017-03-30 01:02:03。   
签名 sign string M-必填 同接口1。   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 return_code string M-必填 请求结果码。   
应答信息 msg string M-必填 应答信息。   
优惠金额 discount_amt string O-选填 仅当接入方式选择同步接口,且return_code为00时,将返回优惠金额,用户实际付费金额请使用pay_at减去discount_amt计算。   
示例代码
请求代码
1
2
3
4
假设双方约定KEY为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y


应答代码
1
2
3
4
5
{
“return_code”:“00 ”,
“msg ”:“成功 ”,
“bind_time”:“ 2017-09 -04 12:00:00
 }


账单支付成功推送接口
接口描述
停车场推送的账单扣款成功后,智慧停车平台将支付结果推送给停车场报销。同步接口返回前依赖于该接口返回正确结果。
请求方式
POST
生产地址
Pending
测试地址
Pending
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
车牌号 usr_num string M-必填 车主在银联绑定的车牌号。   
账单编号 bill_no string M-必填 停车场提供,唯一标识账单建议以yyyymmddhhmmss+n为序列号的形式上送,举例:20171016161055001或201710161610550001。   
支付时间 pay_timestamp string M-必填 举例:2017-03-30 01:02:03。   
支付结果 pay_status string M-必填 3:支付成功 2:销账中 -3:支付失败。   
账单金额 bill_at string M-必填 本次停车费用,以分为单位,举例:100.56元即上送10056。   
实际支付金额 pay_at string M-必填 本次实际停车费用,以分为单位,举例:100.56元即上送10056。   
停车场编号 park_no string M-必填   
停车场名称 park_name string M-必填   
入停车场时间 start_time string M-必填 举例:2017-03-30 01:02:03。   
出停车场时间 pay_time string M-必填 举例:2017-03-30 02:12:03。   
停车时长 stay_time string M-必填 举例:1小时10分0秒。   
签名 sign string M-必填 同接口1。   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 return_code string M-必填   
应答信息 msg string M-必填 应答信息。   
示例代码
请求代码
1
2
3
4
假设双方约定KEY为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y


应答代码
1
2
3
4
5
{
“return_code”:“00 ”,
“msg ”:“成功 ”,
“bind_time”:“ 2017-09 -04 12:00:00
 }


场内绑卡通知接口
接口描述
用户在进场后开通无感支付,银联推送车牌信息同步给停车场,用户离场时可以使用无感支付方式。
请求方式
POST
生产地址
Pending
测试地址
Pending
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
车牌号 usr_num string M-必填 车主在银联绑定的车牌号。   
停车场编号 park_no string M-必填   
停车场名称 park_name string M-必填   
绑定类型 bind_type string M-必填 0:绑定。   
保留字段 reserve string M-必填 停车场个性化字段,暂未使用。   
签名 sign string M-必填 签名,将上述参数按照指定方式进行签名,签名方式使用SHA256算法。   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 return_code string M-必填   
应答信息 msg string M-必填 应答信息。   
示例代码
请求代码
1
2
3
4
假设双方约定KEY为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y


应答代码
1
2
3
4
5
{
“return_code”:“00 ”,
“msg ”:“成功 ”,
“bind_time”:“ 2017-09 -04 12:00:00
 }


支付结果查询接口
接口描述
当出现超时或网络异常等问题时,停车场可以主动向智慧停车平台发起查询,确认订单状态。
请求方式
POST
生产地址
https://billcloud.unionpay.com/ccback/collection/query
测试地址
http://test.billcloud.unionpay.com/ccback/collection/query
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
业务代码 buss_cd string M-必填 缴费项目代码,由银联提供。举例:G0_5800_0001。   
车牌号 usr_num string O-选填 举例:粤A11111。   
账单编号 bill_no string M-必填 停车场提供,唯一标识账单,建议以yyyymmddhhmmss+n位序列号的形式上送,举例:20171016161055001或201710161610550001。   
签名 sign string M-必填 同接口1。   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 return_code string M-必填   
应答信息 msg string M-必填 应答信息。   
支付结果 pay_status string O-选填 如果return_code为00,则会回复此参数,状态码如下:3:支付成功 2:销账中 -3:支付失败。   
优惠金额 discount_amt string O-选填 如果return_code为00且pay_status为3时,返回优惠金。   
示例代码
请求代码
1
2
3
4
假设双方约定KEY为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y


应答代码
1
2
3
4
5
{
“return_code”:“00 ”,
“msg ”:“成功 ”,
“bind_time”:“ 2017-09 -04 12:00:00
 }


联系我们

业务咨询: 何磊

021-20633445

helei1@unionpay.com

技术咨询: 冷宜春

021-20632890

lengyichun@unionpay.com

中国银联版权所有©2002-2019沪 ICP备07032180号