数据标签服务

数据 收单机构 发卡机构 快速接入
综合数据服务平台通过调用标签服务平台接口,上送自然人身份证号,得到当月对应自然人名下卡片级消费能力(银行卡对应的消费评级)和持卡人级别的综合消费能力(持卡人消费评级)。

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

API ID:330

接口状态:正常

业务申请
暂不支持测试

接口名称

获取token

接口描述

产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。

接口地址

测试地址: 敬请期待


生产地址: https://openapi.unionpay.com/upapi/upcardtag/token

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
用户唯一凭证 app_id string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看
用户唯一凭证密钥 app_secret string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 获取到的凭证; 凭证是字符串
过期时间 expire_in string M-必填 凭证有效时间,单位:秒

接口名称

人级标签查询

接口描述

主要按月份对持卡人人进行标签分类

接口地址

测试地址: 敬请期待


生产地址: https://openapi.unionpay.com/upapi/upcardtag/tagInfo

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 调用接口凭证。详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附录“签名样例代码”部分。
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
身份证号 idNum string 20 O-选填 选填,手机号和身份证号码必须有一个出现。
手机号 phoneNo string 11 O-选填 选填,手机号和身份证号码必须有一个出现。
查询开始时间 startDate string 8 M-必填 必填,开始时间格式为yyyyMM例如201807
查询结束时间 endDate string 8 M-必填 必填,开始时间格式为yyyyMM例如201808
标签列表 columns string M-必填 以逗号分隔,如:标签1,标签2,标签3

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应代码 respCode string 4 M-必填
响应信息 respMsg string M-必填 如果respCode不是0000,该字段解释了具体的出错原因。
结果 result map M-必填 Map格式,返回各标签数值
请求结果 col string M-必填 col 是请求columns中的一个字段,具体的响应数据格式参考文档第四节。如果请求字段columns中包含多个值,则响应结果有多个与之对应的结果。

接口名称

持卡人银行卡信息查询

接口描述

主要按月份对持卡人人进行标签分类

接口地址

测试地址: 敬请期待


生产地址: https://openapi.unionpay.com/upapi/upcardtag/cardNo

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 调用接口凭证。详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附录“签名样例代码”部分。
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
身份证号 idNum string 20 O-选填 选填,手机号和身份证号码必须有一个出现。
手机号 phoneNo string 11 O-选填 选填,手机号和身份证号码必须有一个出现。

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应代码 respCode string 4 M-必填
响应信息 respMsg string M-必填
结果 result map M-必填 Map< String,String > 格式,返回各标签数值
银行卡信息 cardList string 2 M-必填 脱敏的银行卡号列表以及卡属性信息。
银行卡发卡行 iss_ins_cd string M-必填 发卡行
银行卡卡等级 card_attr_cd string M-必填 卡等级
银行卡卡号 cardno long M-必填 脱敏银行卡号
应用对象

仅限机构用户,开发者用户不可用。

接入流程

(一)   目前该产品API仅面向特定的应用方提供服务,如有相关需求,请发送邮件至业务接口人说明相关使用需求;

(二)   应用方用户请提供相关银联入网证明材料;开发者用户请提供身份证相关信息;

(三)   技术联调,可参照开放平台在线《“快速接入”产品API指南-接入指南》


应答码参照:
应答码 描述
0000 处理成功
1001 处理失败
9006 您的账号不具备当前产品请求权限,如有权限,可重新获取该产品Token后再尝试。
9007 app_id与app_secret验证失败
9008 您的Token已过期,请重新获取Token。
9009 您的Token信息非最新Token,请确保您的系统中使用的是最新的Token值。
9010 您的签名密钥未设置,请登录银联技术开放平台(open.unionpay.com)确认相关配置
9901 您的IP(XXX.XXX.XXX.XXX)没有登记,请登录银联技术开放平台(open.unionpay.com)进行白名单登记。
9902 您的IP(XXX.XXX.XXX.XXX)已被限制访问,请登录银联技术开放平台(open.unionpay.com)提交申诉请求。
9904 您的 IP(XXX.XXX.XXX.XXX)不属于你设置的开发IP列表,请登录银联技术开放平台(open.unionpay.com)确认相关配置
9905 请求参数值有误,请确认请求参数信息
9911 您的签名信息验证不通过,请检查您的签名实现是否符合银联技术开放平台(open.unionpay.com)提供的签名规则。
9912 您的报文格式有误,要求报文符合JSON数据格式
9913 你的报文数据有误,未通过数据信息校验,具体原因视业务需求
9914 您的报文无法解密,请检查您在银联技术开放平台(open.unionpay.com)上提供的RSA公钥是否正确。
9917 您的账号不具备当前产品API请求权限,请联系相关业务接口人。
9991 银联技术开放平台系统内部错误:产品服务调用失败
9992 银联技术开放平台系统内部错误:产品服务系统未知错误
9993 银联技术开放平台系统内部错误:产品服务未注册至服务中心
9994 银联技术开放平台系统内部错误:产品服务参数错误
序号标签名称备注对应大数据字段名示例响应信息
1gz_consume_level贵州分公司需求,持卡人消费评级settle_at{"result":{"gz_consume_level":"D"},"respMsg":"success","respCd":"0000"}
2gz_card_consume_level贵州分公司需求,持卡人银行卡消费评级settle_at{"result":{"gz_card_consume_level":"6225********9946:D-6225********8846:D-6235***********0111:A"},"respMsg":"success","respCd":"0000"}
3settle_at清算金额settle_at{"result":{"settle_at":"5613909"},"respMsg":"success","respCd":"0000"}
4settle_cnt清算笔数settle_cnt{"result":{"settle_cnt":"132"},"respMsg":"success","respCd":"0000"}
5mcc_base_at当月(日常类)广义消费金额mcc_base_at{"result":{"mcc_base_at":"13909"},"respMsg":"success","respCd":"0000"}
6mcc_base_cnt当月(日常类)广义消费笔数mcc_base_cnt{"result":{"mcc_base_cnt":"2"},"respMsg":"success","respCd":"0000"}
7cross_consume_at当月境外广义消费金额(分)cross_consume_at{"result":{"cross_consume_at":"0"},"respMsg":"success","respCd":"0000"}
8cross_consume_cnt当月境外广义消费笔数cross_consume_cnt{"result":{"cross_consume_cnt":"0"},"respMsg":"success","respCd":"0000"}
9tr_collect_at当月代收交易金额tr_collect_at{"result":{"tr_collect_at":"0"},"respMsg":"success","respCd":"0000"}
10tr_collect_cnt当月代收交易笔数tr_collect_cnt{"result":{"tr_collect_cnt":"0"},"respMsg":"success","respCd":"0000"}
11tr_pay_at当月代付交易金额tr_pay_at{"result":{"tr_pay_at":"828"},"respMsg":"success","respCd":"0000"}
12tr_pay_cnt当月代付交易笔数tr_pay_cnt{"result":{"tr_pay_cnt":"2"},"respMsg":"success","respCd":"0000"}
13mcc1_comm_at当月交通消费金额mcc1_comm_at{"result":{"mcc1_comm_at":"0"},"respMsg":"success","respCd":"0000"}
14mcc1_comm_cnt当月交通消费笔数mcc1_comm_cnt{"result":{"mcc1_comm_cnt":"0"},"respMsg":"success","respCd":"0000"}
15mcc2_fin_insurance_at当月金融-保险消费金额mcc2_fin_insurance_at{"result":{"mcc2_fin_insurance_at":"191784"},"respMsg":"success","respCd":"0000"}
16mcc2_fin_financing_at当月金融-理财消费金额mcc2_fin_financing_at{"result":{"mcc2_fin_financing_at":"104706"},"respMsg":"success","respCd":"0000"}
17mcc2_fin_insurance_cnt当月金融-保险消费笔数mcc2_fin_insurance_cnt{"result":{"mcc2_fin_insurance_cnt":"4"},"respMsg":"success","respCd":"0000"}
18mcc2_fin_financing_cnt当月金融-理财消费笔数mcc2_fin_financing_cnt{"result":{"mcc2_fin_financing_cnt":"14"},"respMsg":"success","respCd":"0000"}
19tr_withdrawal_at当月取现金额tr_withdrawal_at{"result":{"tr_withdrawal_at":"0"},"respMsg":"success","respCd":"0000"}
20tr_deposit_at当月存款金额tr_deposit_at{"result":{"tr_deposit_at":"0"},"respMsg":"success","respCd":"0000"}
21ol_settle_cnt当月线上清算笔数ol_settle_cnt{"result":{"ol_settle_cnt":"0"},"respMsg":"success","respCd":"0000"}
22ol_settle_at当月线上清算金额(分)ol_settle_at{"result":{"ol_settle_at":"0"},"respMsg":"success","respCd":"0000"}
23ofl_settle_cnt当月线下清算笔数ofl_settle_cnt{"result":{"ofl_settle_cnt":"2"},"respMsg":"success","respCd":"0000"}
24ofl_settle_at当月线下清算金额(分)ofl_settle_at{"result":{"ofl_settle_at":"13909"},"respMsg":"success","respCd":"0000"}
25web_settle_cnt当月互联网清算笔数web_settle_cnt{"result":{"web_settle_cnt":"0"},"respMsg":"success","respCd":"0000"}
26web_settle_at当月互联网清算金额(分)web_settle_at{"result":{"web_settle_at":"0"},"respMsg":"success","respCd":"0000"}
27tr_withdrawal_cnt当月取现笔数tr_withdrawal_cnt{"result":{"tr_withdrawal_cnt":"0"},"respMsg":"success","respCd":"0000"}
28tr_deposit_cnt当月存款笔数tr_deposit_cnt{"result":{"tr_deposit_cnt":"0"},"respMsg":"success","respCd":"0000"}
29first_trans_dt首笔交易日期first_trans_dt{"result":{},"respMsg":"success","respCd":"0000"}
30consume_at当月广义消费金额consume_at{"result":{"consume_at":"13909"},"respMsg":"success","respCd":"0000"}
31consume_cnt当月广义消费笔数consume_cnt{"result":{"consume_cnt":"2"},"respMsg":"success","respCd":"0000"}
32neg_consume_cnt当月反向广义消费笔数neg_consume_cnt{"result":{"neg_consume_cnt":"0"},"respMsg":"success","respCd":"0000"}
33lst_tr_dt最近一笔交易日期lst_tr_dt{"result":{},"respMsg":"success","respCd":"0000"}
34lst_ofl_tr_dt最近一笔线下交易日期lst_ofl_tr_dt{"result":{},"respMsg":"success","respCd":"0000"}
35his_max_tr_at卡片历史最高月度汇总交易金额his_max_tr_at{"result":{"his_max_tr_at":"0"},"respMsg":"success","respCd":"0000"}
36max_day_settle_at当月单笔最高交易金额max_day_settle_at{"result":{"max_day_settle_at":"0"},"respMsg":"success","respCd":"0000"}


1. 获取产品调用token信息

请求URL:

https://openapi.unionpay.com/upapi/upcardtag/token?app_id=[value]&app_secret=[value]

应答JSON报文体:
{
“token”: “”,
“expire_in”:7200
}


2.  人级标签查询

请求URL:

https://openapi.unionpay.com/upapi/upcardtag/tagInfo?token=[token]&sign=[sign]&ts=[ts]

请求JSON报文体:
{“idNum”:”xxxxx”,”columns”:[“col1”,”col2”,…]}
应答JSON报文体
{
“resCode”: “success”,
“reason”:null,
“result”:
{
“col1”: “value1”,
“col2”, “value2”
}
…
}


3. 持卡人银行卡号查询

请求URL:

https://openapi.unionpay.com/upapi/upcardtag/cardNo?token=[value]&sign=[value]&ts=[value]

请求JSON报文体:
{
    "idNum": "310542232326556565"
}
应答JSON报文体:
{
    "result":{
         "cardList":[
             {
                   "card_attr_cd":"01",
                   "cardno":"6228***********3778",
                   "iss_ins_cd":"0801035200"
              },
             {
                    "card_attr_cd":"01",
                    "cardno":"6228***********7317",
                    "iss_ins_cd":"0801035200"
              },
              {
                    "card_attr_cd":"01",
                    "cardno":"6228***********9515",
                    "iss_ins_cd":"0801035200"
               }
                  ]
         },
     "respMsg":"success",
     "respCd":"0000"
}


1. “快速接入”产品API使用教程请参考在线文档:

“快速接入”产品API指南—接入指南


2. “快速接入”产品API安全调用过程请参考在线文档:

2.1“快速接入”产品API指南—获取产品token

2.2快速接入”产品API指南—产品功能接口调用


3. “快速接入”产品API接口调用报文签名样例请参考在线文档:

“快速接入”产品API指南—报文签名样例代码


4. “快速接入”产品API测试工具使用说明请参考在线文档:

“快速接入”产品API指南—“快速接入”测试工具

咨询我们
业务咨询
姓名: 谭乾
电话: 021-20633914
邮箱: tanqian@unionpay.com
技术咨询
姓名: 张明虎
电话: 021-20632674
邮箱: zhangminghu@unionpay.com
热门推荐