银联小微资金服务产品
风险控制
商户
开发者
银联小微商户资金服务产品是银联自主研发的,在多年消费大数据基础上,经过汇聚、处理、分析、挖掘形成的大数据服务产品。产品深度挖掘了用户消费数据的消费特征、行为特征,形成了基于卡片和持卡人两种层级的完整标签体系。在用户授权基础上,可为合规接入机构提供经脱敏的用户标签,为其风控、精准营销等提供支持。
服务对象

机构用户

应用场景

信贷审批、信用卡审批、精准营销等。

产品亮点

1、海量数据、深度挖掘

产品针对银联海量消费行为数据和人卡对应关系数据进行深度整合和挖掘,覆盖全量卡片和海量持卡人。具有覆盖人群广,刻画维度全,挖掘粒度深等特点。

2、自主对接调试

接入机构通过银联技术开放平台自主申请,自主调试,自助式完成技术对接,提升效率。

接入流程

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

(二)   机构以普通用户注册申请产品,并请提供公司介绍、业务介绍材料以及产品使用场景;

(三)   技术联调,可参照技术开放平台在线文档《OpenAPI指南-接入指南》

应答码参照
应答码 描述 解决方案
0000 处理成功。 展开详情
暂无
0046 无效的测试卡号 展开详情
暂无
0047 查询卡号失败 展开详情
暂无
0048 未找到满足条件的卡号交易信息 展开详情
暂无
1009 请求报文格式校验不通过 展开详情
暂无
9901 您的IP(XXX.XXX.XXX.XXX)没有登记,请登录银联开放平台(open.unionpay.com)进行白名单登记。 展开详情
暂无
9902 您的IP(XXX.XXX.XXX.XXX)已被限制访问,请登录银联开放平台(open.unionpay.com)提交申诉请求。 展开详情
暂无
9903 您的IP(XXX.XXX.XXX.XXX)请求过于频繁,已被临时限制,请5分钟后再尝试。 展开详情
暂无
9904 您的IP(XXX.XXX.XXX.XXX)不属于你设置的开发IP列表,请登录银联开放平台(open.unionpay.com)确认相关配置 展开详情
暂无
9905 请求参数值有误,请确认请求参数信息 展开详情
暂无
9906 您的账号不具备当前产品请求权限,如有权限,可重新获取该产品Token后再尝试。 展开详情
暂无
9907 app_id与app_secret验证失败 展开详情
暂无
9908 您的Token已过期,请重新获取Token。 展开详情
暂无
9909 您的Token信息非最新Token,请确保您的系统中使用的是最新的Token值。 展开详情
暂无
9910 您的签名密钥未设置,请登录银联开放平台(open.unionpay.com)确认相关配置 展开详情
暂无
9911 您的签名信息验证不通过,请检查您的签名实现是否符合银联开放平台(open.unionpay.com)提供的签名规则。 展开详情
暂无
9912 您的报文格式有误,要求报文符合JSON数据格式 展开详情
暂无
9913 你的报文数据有误,未通过数据信息校验,具体原因视业务需求 展开详情
暂无
9914 您的报文无法解密,请检查您在银联开放平台(open.unionpay.com)上提供的RSA公钥是否正确。 展开详情
暂无
9917 您的账号不具备当前产品API请求权限,请联系相关业务接口人。 展开详情
暂无
9991 银联开放平台系统内部错误:产品服务调用失败 展开详情
暂无
9992 银联开放平台系统内部错误:产品服务系统未知错误 展开详情
暂无
9993 银联开放平台系统内部错误:产品服务未注册至服务中心 展开详情
暂无
9994 银联开放平台系统内部错误:产品服务参数错误 展开详情
暂无

1.获取产品调用token信息


1.1JSON报文举例

请求URL:

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

应答JSON报文体:

{
   
       “respCd”:“0000”
       “respMsg”:“成功”
       “token”: “”,
       “expire_in”:7200
}


2.卡片指标查询接口


2.1请求URL:

http请求方式,POST(请使用Https协议)

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

参数说明

参数

是否必填

说明

token

调用接口凭证

sign

签名密钥secret

ts

请求时间戳


2.2请求报文说明

POST数据格式:JSON

POST报文示例:

{
    "bankPlatCd": "00010001",
    "certifId":"310123190001010001",
    "cdhdNm":"张三",
    "cdhdPhone":"13188888888",
    "cardNo":"6288888888888888",
    "cdhdZipFile":"ABCD1234ABCD1234……",
    "signNo":"1234567890ABCDEF1234567890ABCDEF"
}


2.3应答报文说明

调用失败时,银联会返回错误码等信息,JSON数据包示例如下:

{
    "respCd":"1009",
    "respMsg":"invalid request"
}

调用成功时,银联会返回满足条件的查询信息,此时JSON数据报文示例为:

图片2.png


3.持卡人指标查询接口


3.1请求URL

http请求方式,POST(请使用Https协议)

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

参数说明:

参数

是否必填

说明

token

调用接口凭证

sign

签名密钥secret

ts

请求时间戳


3.2请求报文说明

POST数据格式:JSON

POST报文示例:

{
    "bankPlatCd": "00010001",
    "certifId":"310123190001010001",
    "cdhdNm":"张三",
    "cdhdPhone":"13188888888",
    "cardNo":"6288888888888888",
    "cdhdZipFile":"ABCD1234ABCD1234……",
    "signNo":"1234567890ABCDEF1234567890ABCDEF"
}


3.3应答报文说明

调用失败时,银联会返回错误码等信息,JSON数据包示例如下:

{
    "respCd":"1009",
    "respMsg":"invalid request"
}

调用成功时,银联会返回满足条件的查询信息,此时JSON数据报文示例为:

银联小微资金服务产品服务接口规范_V1.004895.png

行业代码

行业名称

air        

航空           

highway    

公路           

oil       

加油类         

railway   

铁路类         

rent     

租车类         

college   

大学学费       

preschool  

幼教消费       

school       

学校消费       

train        

培训消费       

beauty   

美容           

fitness  

运动健身       

ent_misc 

娱乐其它消费   

park    

游乐电玩       

rec     

娱乐休闲       

show     

文艺演出       

cash     

现金业务       

financing 

理财           

insurance 

保险           

decorate 

家装建材       

family   

家庭日常       

live_misc 

居住其它类     

new     

一手房消费     

resold   

二手房消费     

dinner   

餐厅           

food     

食品类         

book     

书籍音像类     

clo       

服装           

cosm      

化妆品         

depart     

百货商场       

digital    

电子数码       

elec     

家电           

gift    

礼品           

jewal   

珠宝工艺       

kidclo   

童装           

manclo    

男装           

shop_misc  

日常其它       

sport   

体育用品       

store   

便利店         

taxfree  

免税店         

wine    

烟酒           

womanclo  

女装           

1. OpenAPI使用教程请参考在线文档:

OpenAPI使用指南—接入指南


2. OpenAPI安全调用过程请参考在线文档:

2.1OpenAPI使用指南—获取产品token

2.2OpenAPI使用指南—产品功能接口调用


3. OpenAPI接口调用报文签名样例请参考在线文档:

OpenAPI使用指南—报文签名样例代码


4. OpenAPI测试工具使用说明请参考在线文档:

OpenAPI使用指南—OpenAPI测试工具

联系我们

业务咨询: 021-20631632

杨志

yangzhi@unionpay.com

技术咨询: 021-20633521

张昊

zhanghao1@unionpay.com

咨询与服务