UPark-无感支付

增值 商户 UPark 开发者
通过无感支付扣款,向用户推送消费通知

接入服务商:银联技术开放平台

API ID:59

接口状态:正常

业务申请
暂不支持测试

接口名称

进场通知接口

接口描述

车辆入场时由停车场通知智慧停车平台,用于客户端页面展示用户已经进入停车场并显示停车时长。入场通知推送触发,计时开始。

接口地址

测试地址: http://test.billcloud.unionpay.com/ccback/collection/in


生产地址: https://billcloud.unionpay.com/ccback/collection/in

请求方式

HTTP POST

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
车牌号 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
 }


接口名称

离场通知接口

接口描述

车辆 离场时由停车通知智慧平台 场时由停车通知智慧平台 场时由停车通知智慧平台 场时由停车通知智慧平台 (该 接口 推荐 在抬杆 离场 的时候发送 的时候发送 ), 用于客户端页面取消展显示停车时长。 用于客户端页面取消展显示停车时长。

接口地址

测试地址: http://test.billcloud.unionpay.com/ccback/collection/out


生产地址: https://billcloud.unionpay.com/ccback/collection/out

请求方式

HTTP POST

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
车牌号 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
 }


接口名称

车牌无感支付查询接口

接口描述

查询车牌是否已开通无感支付,判断车辆离场时是否使用无感支付。

接口地址

测试地址: http://test.billcloud.unionpay.com/ccback/collection/query


生产地址: https://billcloud.unionpay.com/ccback/collection/query

请求方式

HTTP POST

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
业务代码 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
 }


接口名称

停车场账单推送接口

接口描述

车主出停车场,抬杆,停车场结算账单推送给银联,支持同步接收结果与异步接收结果。

接口地址

测试地址: http://test.billcloud.unionpay.com/ccback/collection/charge


生产地址: https://billcloud.unionpay.com/ccback/collection/charge

请求方式

HTTP POST

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
业务代码 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
 }


接口名称

账单支付成功推送接口

接口描述

停车场推送的账单扣款成功后,智慧停车平台将支付结果推送给停车场报销。同步接口返回前依赖于该接口返回正确结果。

接口地址

测试地址: Pending


生产地址: Pending

请求方式

HTTP POST

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
车牌号 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
 }


接口名称

场内绑卡通知接口

接口描述

用户在进场后开通无感支付,银联推送车牌信息同步给停车场,用户离场时可以使用无感支付方式。

接口地址

测试地址: Pending


生产地址: Pending

请求方式

HTTP POST

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
车牌号 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
 }


接口名称

支付结果查询接口

接口描述

当出现超时或网络异常等问题时,停车场可以主动向智慧停车平台发起查询,确认订单状态。

接口地址

测试地址: http://test.billcloud.unionpay.com/ccback/collection/query


生产地址: https://billcloud.unionpay.com/ccback/collection/query

请求方式

HTTP POST

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
业务代码 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
 }


产品亮点

◆ 简单快速 

    用户离场快、系统上线快

◆ 开放共享 

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

◆ 易于推广 

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


产品详情

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

应用对象

有停车需要的持卡人

应答码参照:
应答码 描述
00 承兑或交易成功
01 交易失败
13 无效金额(1、理应出现有效金额的交易中,金额域填0或其他非法值;2、超转付金额累计/超现付金额累计;3、交易超消费比例;4、小费金额超限)
25 未开通无感支付
30 报文格式错误
94 重复交易
94 重复交易
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”}


咨询我们
业务咨询
姓名: 何磊
电话: 021-20633445
邮箱: helei1@unionpay.com
技术咨询
姓名: 冷宜春
电话: 021-20632890
邮箱: lengyichun@unionpay.com
热门推荐