UPark-主动支付

增值 商户 UPark 开发者
用户驾驶车辆入场,识别车牌信息后调用入场通接口推送入场消息至智慧停车平台,用户在离场前发起主动支付,智慧停车平台查询其欠费信息并判断其是否支付成功。

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

API ID:58

接口状态:正常

业务申请
暂不支持测试

接口名称

进场通知接口

接口描述

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

接口地址

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


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

请求方式

HTTP POST

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
签名 sign string M-必填 签名,将上述参数按照指定方式进行签名,签名方式使用SHA256 算法。
时间戳 entry_time string M-必填 举例:2017-03-30 01:02:03。
停车流水号 ref_no string M-必填 同一停车场的唯一流水号。
停车场名称 park_name string M-必填
停车场编号 park_no string M-必填
业务代码 buss_cd string M-必填 缴费项目代码,由银联分配,举例:G0_5800_0001,注意是下划线,不是短横。
车牌号 usr_num string M-必填 车主在银联绑定的车牌号。

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
应答信息 msg string M-必填
应答码 return_code string M-必填

示例代码

请求代码
假设双方约定KEY为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
应答代码
{
“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

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
签名 sign string M-必填 签名,将上述参数按照指定方式进行签名,签名方式使用 SHA256 算法。
时间戳 exit_time string M-必填 举例:2017-03-30 01:02:03 。
停车流水号 ref_no string M-必填 同一停车场的唯一流水号。
停车场名称 park_name string M-必填
停车场编号 park_no string M-必填
业务代码 buss_cd string M-必填 缴费项目代码,由银联分配,举例: G0_5800_0001,注意是下划线,不是短横。
车牌号 usr_num string M-必填 车主在银联绑定的车牌号

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
应答信息 msg string M-必填
应答码 return_code string M-必填

示例代码

请求代码
假设双方约定KEY为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
应答代码
{
“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

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
签名 sign string M-必填 签名,将上述参数按照指定方式进行签名,签名方式使用 SHA256算法。
停车场名称 park_name string M-必填
停车场编号 park_no string M-必填 停车场上送,一般是停车场服务器对对接停车场的编号,例如:001。
车牌号 usr_num string M-必填 车牌号,举例:粤 A11111。
业务代码 buss_cd string M-必填 缴费项目代码,由银联分配,举例 :G0_5800_0001,注意是下划线,不是短横。

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
应答信息 msg string M-必填
应答码 return_code string M-必填 00- 开通 ; 25-未开通。

示例代码

请求代码
假设双方约定KEY为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y


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


接口名称

账单信息查询接口

接口描述

查询停车欠费信息。

接口地址

测试地址: 由停车场提供


生产地址: 由停车场提供

请求方式

HTTP POST

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
签名 sign string M-必填
停车场编号 park_no string M-必填 停车场编号,举例: A11111。
车牌号 usr_num string M-必填 车牌号,举例:粤 A11111。

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
停车场名称 park_name string O-选填
停车场编号 park_no string O-选填 停车场上送,一般是停车场服务器对对接停车场的编号,例如001。
停车时长 stay_time string M-必填 举例:1 小时 10 分 0 秒。
入停车场时间 start_time string M-必填 举例:2017-03-30 01:02:03 。
实际支付金额 pay_at string M-必填 本次实际停车费用,以分为单位,举例:100.56 元即上送10056。
账单金额 bill_at string M-必填 本次停车费用,以分为单位,举例:100.56 元即上送 10056。
车牌号 usr_num string M-必填 车牌号,举例:粤 A11111。
账单编号 bill_no string M-必填 停车场提供,唯一标识账单建议以 yyyymmddhhmmss+n 位序列号的形式上送,举例:20171016161055001 或 201710161610550001,保证唯一即可。

示例代码

请求代码
假设双方约定KEY为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y


应答代码
{
“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

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
签名 sign string M-必填 签名,将上述参数按照指定方式进行签名,签名方式使用 SHA256 算法。
出停车场时间 pay_time string M-必填 举例:2017-03-30 01:02:03 。
入停车场时间 start_time string M-必填 举例:2017-03-30 01:02:03 。
实际支付金额 pay_at string M-必填 本次实际停车费用,以分为单位,举例:100.56 元即上送10056。
账单金额 bill_at string M-必填 本次停车费用,以分为单位,举例:100.56 元即上送 10056。
停车场名称 park_name string M-必填
停车场编号 park_no string M-必填 停车场上送,一般是停车场服务器对对接停车场的编号,例如001。
车牌号 usr_num string M-必填 车牌号,举例:粤 A11111。
账单编号 bill_no string M-必填 停车场提供,唯一标识账单建议以 yyyymmddhhmmss+n 位序列号的形式上送,举例: 20171016161055001 或 201710161610550001,保证唯一即可。
业务代码 buss_cd string M-必填 缴费项目代码,由银联分配,举例 :G0_5800_0001,注意是下划线,不是短横。

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
应答信息 msg string M-必填
应答码 return_code string M-必填 请求结果码(具体参考应答码说明)。
优惠金额 discount_amt string O-选填 仅当接入方选择同步接口,且 return_code 为 00时,将返回优惠金额,用户实际付费金额请使用 pay_at 减去discount_amt 计算。

示例代码

请求代码
假设双方约定 KEY 为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y


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


接口名称

主动缴费销账接口

接口描述

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

接口地址

测试地址: 停车场提供


生产地址: 停车场提供

请求方式

HTTP POST

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
签名 sign string M-必填 签名,将上述参数按照指定方式进行签名,签名方式使用 SHA256 算法。
停车时长 stay_time string M-必填 举例:1 小时 10 分 0 秒。
出停车场时间 pay_time string M-必填 举例:2017-03-30 02:12:03 。
入停车场时间 start_time string M-必填 举例:2017-03-30 01:02:03 。
停车场名称 park_name string M-必填
停车场编号 park_no string M-必填
实际支付金额 pay_at string M-必填 本次实际停车费用,以分为单位,举例:100.56 元即上送 10056。
账单金额 bill_at string M-必填 本次停车费用,以分为单位,举例:100.56 元即上送10056。
支付结果 pay_status string M-必填 3:支付成功 ; 2:销账中; -3: 支付失败。
支付时间 pay_timestamp string M-必填 举例:2017-03-30 01:02:03 。
账单编号 bill_no string M-必填 停车场提供,唯一标识账单建议以 yyyymmddhhmmss+n位序列号的形式上送,举例:20171016161055001 或201710161610550001,保证唯一即可。
车牌号 usr_num string M-必填 车主在银联绑定的车牌号,举例:粤 A11111。

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 return_code string M-必填
应答信息 msg string M-必填

示例代码

请求代码
假设双方约定 KEY 为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y


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


接口名称

场内绑卡通知接口

接口描述

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

接口地址

测试地址: 停车场提供


生产地址: 由停车场提供

请求方式

HTTP POST

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
车牌号 usr_num string M-必填 车主在银联绑定的车牌号。
停车场编号 park_no string M-必填
停车场名称 park_name string M-必填
绑定类型 bind_type string M-必填 0:绑定。
保留字段 reserve string O-选填 停车场个性化字段,暂未使用。
签名 sign string M-必填 签名,将上述参数按照指定方式进行签名,签名方式使用 SHA256 算法。

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 return_code string M-必填
应答信息 msg string M-必填

示例代码

请求代码
假设双方约定 KEY 为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y


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


接口名称

支付结果查询接口

接口描述

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

接口地址

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


生产地址: https://billcloud.unionpay.com/ccback/collection/bill/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-必填 签名,将上述参数按照指定方式进行签名,签名方式使用 SHA256 算法。

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 return_code string M-必填
应答信息 msg string M-必填
支付结果 pay_status string O-选填 如果 return_code 为 00,则会回复此参数,状态码如下:3: 支付成功 ; 2: 销账中 ; -3: 支付失败。
优惠金额 discount_amt string M-必填 如果 return_code 为 00 且pay_status 为 3 时,返回优惠金额,用户实际付费金额请使用pay_at 减去 discount_amt 计算。

示例代码

请求代码
假设双方约定 KEY 为:2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y
则:usr_num=粤 A11111
    buss_code=G0_5800_0001
    key= 2FStH7sEtSM-xVGUKlflc5kdAYwpwc6y


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


产品亮点

◆ 简单快速 

    用户离场快、系统上线快

◆ 开放共享 

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

◆ 易于推广 

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


产品详情

主动支付业务流程:

image.png

应用对象

有停车需要的持卡人。

应答码参照:
应答码 描述
00 承兑或交易成功
01 交易失败
13 无效金额
25 未开通无感支付
30 报文格式错误
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
热门推荐