综合认证业务
综合数据服务
收单机构
商户
发卡机构
银联综合认证业务,是指通过整合银联内部资源(全渠道、多渠道、大数据平台、财税库银系统等)和外部资源,向商户提供非面对面的综合认证服务,包括银行卡认证、银行卡属性和银行名称查询、公民身份信息认证、人脸识别、手机运营商实名认证及在网信息查询、个人风险评估(基于银联风险系统,对个人银行卡、身份证和手机号进行风险评估)、企业风险评估(基于银联风险系统,对商户收单风险进行评估)、工商企业信息验证等服务,形成银联综合认证服务。
服务对象

银行、收单机构和商户。

产品详情

银联综合认证业务,是指通过整合银联内部资源(全渠道、多渠道、大数据平台、财税库银系统等)和外部资源,向商户提供非面对面的综合认证服务,包括银行卡认证、银行卡属性和银行名称查询、公民身份信息认证、人脸识别、手机运营商实名认证及在网信息查询、个人风险评估(基于银联风险系统,对个人银行卡、身份证和手机号进行风险评  )、企业风险评估(基于银联风险系统,对商户收单风险进行评估)、工商企业信息验证等服务,形成银联综合认证服务。

应用场景

综合认证业务可广泛应用于各行业,包括但不仅限于用户实名制,用户绑卡认证,用户信用信息查询,银行Ⅱ、Ⅲ类账户开户,海关申报等领域。


PC端案例:

img-1.jpg


手机端案例:

img-2.jpg


产品亮点

最成熟的银行卡验证通道

稳定、全面的银行卡验证通道,支持所有主流银行的信用卡及大多数银行借记卡验证。


一点接入实现多个渠道的用户身份验证服务

一点接入银联即可实现银行、公安、移动运营商、工商等多个渠道的用户身份验证,即实现银行卡验证、公安部公民身份认证、人脸识别、活体检测、手机运营商实名认证及在网信息查询、工商企业信息查询/验证等多种功能。


灵活的接入模式

可根据合作机构需求及具体场景支持API接口和H5页面两种模式,实时返回结果,满足查询时效性需求。

应答码参照
应答码 描述 解决方案

本板块展示了如何从零开始,使用银联开放服务平台服务端SDK快速接入综合认证平台,完成与银联对接的部分。

注意:文档中的代码示例和Demo是用来阐述API基本使用方法的,针对大部分基本业务场景。供商户参考,特殊情况请按照进阶功能扩展,确保符合实际业务需求。


第一步:申请入网


您有2种方式可以选择:

        1.与属地分公司签约入网:

           银联有36个属地分公司,您可根据商户注册地等因素,与当地分公司进行业务签约。

        2.与金融民生事业部签约入网:

           联系人: 诸中林  金融与民生事业部  021-20631643


第二步:申请证书


开发者调用接口前需要先获取三个证书:签名证书、敏感信息加密证书、验签证书。


签名证书

证书用途

商户对报文中出现签名域(signature)之外的所有数据元采用key=value的形式按照名称排序,然后以&作为连接符拼接成待签名串。其次,对待签名串使用SHA-256算法做摘要,再使用银联颁发给商户的签名私钥证书中的私钥对摘要做签名操作(签名时算法选择 SHA-256)。最后,对签名做Base64编码,将编码后的   签名串放在签名(signature)表单域里和其他表单域一起通过HTTP Post的方式传输给银联全渠道支付平台。

 

如何获取

测试环境签名证书接从开发包中目录assets下获取。

生产环境签名证书获取方式:入网流程走完后,银联业务运营中心会发送入网通知邮件给申请表中的联系人邮箱,请参考邮件中《证书下载、导出及上传流程》文档进行下载,下载时需要的证书序列号、授权码会在邮件正文或者附件中给出。

 

验签证书

证书用途

商户对报文中出现签名域(signature)之外的所有数据元采用key=value的形式按照名称升序排序,然后以&作为连接符拼接成待签名串。其次,对待签名串使用 SHA-256算法做摘要,再使用商户入网时银联提供的验签公钥证书中的公钥对摘要和报文中的签名信息做签名验证操作。

 

如何获取

验签证书直接从开发包中目录assets下获取。


第三步:集成并配置SDK


为了帮助开发者调用开放接口,我们提供了开放平台服务端SDK,包含JAVA、PHP和.NET三语言版本,封装了签名&验签、HTTP接口请求等基础功能。请先下载对应语言版本的SDK并引入您的开发工程。


调用流程               

                              

使用SDK快速接入

公共类

交易状态查询详见:com.unionpay.acp.demo.Form09_6_5_Query

示例代码参考:左侧菜单AAPI接口—交易状态查询


银行卡认证类

银行卡认证详见:com.unionpay.acp.demo.Form_5_3_Card_Identification

示例代码参考:左侧菜单API接口—银行卡认证


银行卡归属地查询详见:com.unionpay.acp.demo.Form_5_5_Card_Regional_Query

示例代码参考:左侧菜单API接口—银行卡归属地查询


银行卡信息查询详见:com.unionpay.acp.demo.Form_5_4_Card_Info_Query

示例代码参考:左侧菜单API接口—银行卡信息查询


企业信息认证类

企业信息认证详见:com.unionpay.acp.demo.Form_5_6_EnterPrise_Info_Identification

示例代码参考:左侧菜单API接口—企业信息认证


企业信息查询详见:com.unionpay.acp.demo. Form_5_7_Enterprise_Info_Query

示例代码参考:左侧菜单API接口—企业信息查询


生物特征(人脸)认证类 

生物特征识别SDK接入:

下载生物特征识别SDK(android版、ios版本)


交易流程:


第1步:商户后台下单

活体检测下单详见:com.unionpay.acp.demo.Form_5_19_Bioassay_In_Order


第2步:用户通过商户app录入认证要素,商户app调起银联生物特征识别SDK:


第3步:银联生物特征识别SDK检测活体后返回pictureToken给商户app端,app再返给商户后台,商户后台调用人脸比对接口或身份证核查及证件照比对接口。

人脸比对接口详见:com.unionpay.acp.demo.Form_5_10_Face_Alignment

身份证核查及证件照比对接口详见:com.unionpay.acp.demo.Form_5_13_ID_Photo_Check

 

关键请求要素、应答要素详见综合认证平台接口文档。


开放平台服务端SDK

为了帮助开发者调用交易接口,我们提供了服务端SDK,包含JAVA、PHP和.NET三语言版本封装了签名&验签、HTTP接口请求等基础功能。

综合认证服务产品Demo

根据开发语言下载综合认证服务产品Demo

Demo版本

运行环境

下载链接

JAVA

Eclipse+ jdk1.6.12u5及以上+Tomcat6.0及以上

点击下载

.NET

visual   studio 2010及以上+.NET framework4.0 及以上

PHP

php5.3及以上

运行说明

开发包调用步骤可以参考视频:http://pan.baidu.com/s/1mitsjvq

SDK下载:TODO


如何切换真实环境支付

FAQ

respCode返了失败

请看下respMsg里的信息,根据其中的7位数字,到应答码页面搜索。

查询接口什么时候调用

FAQ


通知报文验签失败,该怎么办?

FAQ

如果调用数次查询接口后,一直得到处理中状态,该怎么办?

FAQ


应答码说明

全渠道平台应答码长度为2字节,应答码范围分布如下:

应答码范围

含  义

00

成功

01-09

因银联全渠道系统原因导致的错误

10-29

有关商户端上送报文格式检查导致的错误

30-59

有关商户/收单机构相关业务检查导致的错误

60-89

有关持卡人或者发卡行(渠道)相关的问题导致的错误

90-99

预留

 

应答码清单

银联全渠道平台应答码及含义如下:

应答码

描  述

00

成功

01

交易失败。详情请咨询95516

02

系统未开放或暂时关闭,请稍后再试

03

交易通讯超时,请发起查询交易

04

交易状态未明,请查询对账结果

05

交易已受理,请稍后查询交易结果

06

系统繁忙,请稍后再试

10

报文格式错误

11

验证签名失败

12

重复交易

13

报文交易要素缺失

30

交易未通过,请尝试使用其他银联卡支付或联系95516

31

商户状态不正确

32

无此交易权限

34

查无此交易

35

原交易不存在或状态不正确

37

已超过最大查询次数或操作过于频繁

39

交易不在受理时间范围内

61

输入的卡号无效,请确认后输入

68

您的银行卡暂不支持该业务,请向您的银行或95516咨询

90

账户余额不足

91

认证失败

92

营业执照过期

93

营业执照吊销

94

营业执照注销

95

营业执照迁出

96

营业执照撤销

99

通用错误

应答码说明:

1、  同步应答码及异步通知应答码

(1)同步应答00,仅表示银联受理成功,不表示订单成功。

(2)当同步应答码返回05时,需发起交易状态查询交易查询结果


综合认证服务平台API列表


生产地址:https://upverify.95516.com/gateway/api/queryTransReq.do

测试地址:https://upverify.test.95516.com/gateway/api/queryTransReq.do

接口名称

功能说明

交易模式

交易状态查询

对未收到应答的或交易状态未知的交易,应通过该交易进行查询。

后台交易

 

 

生产地址:https://upverify.95516.com/gateway/api/frontTransReq.do

测试地址:https://upverify.test.95516.com/gateway/api/frontTransReq.do

接口名称

功能说明

交易模式

银行卡认证(前台)

用于商户发起对持卡人卡片和身份信息的校验

前台交易

企业信息认证(前台)

用于商户发起对企业营业执照存续状态的查询及企业信息的校验

前台交易

企业信息查询(前台)

查询企业工商注册信息

前台交易

 

 

生产地址:https://upverify.95516.com/gateway/api/backTransReq.do

测试地址:https://upverify.test.95516.com/gateway/api/backTransReq.do

接口名称

功能说明

交易模式

银行卡认证

用于商户发起对持卡人卡片和身份信息的校验

后台交易

银行卡信息查询

用于商户发起对银行卡发卡银行和卡属性的查询

后台交易

银行卡属地查询

用于商户发起对银行卡归属地的查询

后台交易

企业信息认证

用于商户发起对企业营业执照存续状态的查询及企业信息的校验

后台交易

企业信息查询

查询企业工商注册信息

后台交易

公民身份证简项认证并返回照片

核对姓名和身份证的一致性,并返回照片

后台交易

移动运营商手机实名认证

通过运营商核对用户手机和证件一致性

后台交易

移动运营商手机状态和在网时长查询

查询手机在运营商状态及时长

后台交易

短信验证码下发

使用银联短信下发验证码服务

后台交易

短信验证码验证

使用银联短信验证验证码服务

后台交易

银联加密公钥更新查询交易

用于在加密证书到期前,获取加密公钥证书

后台交易

 

 

生产地址:https://faceverify.95516.com/gateway/api/backTransReq.do

测试地址:https://faceverify.test.95516.com/gateway/api/backTransReq.do

接口名称

功能说明

交易模式

人脸比对

对两张人脸照片进行比对

后台交易

防HACK

对图片进行HACK度评分

后台交易

活体检测

检测视频文件是否为活体拍摄,并同时进行防HACK校验

后台交易

身份证核查及证件照比对

对用户身份信息及人脸图片进行核查比对

后台交易

身份证照片OCR

识别身份证正反面信息

后台交易

银行卡照片OCR

识别银行卡卡号

后台交易

 

 

生产地址:https://upverify.95516.com/gateway/api/appTransReq.do

测试地址:https://upverify.test.95516.com/gateway/api/appTransReq.do

接口名称

功能说明

交易模式

活体检测下单

APP客户端调用SDK前,商户后台系统通过该接口进行下单

后台交易


联系我们

业务咨询: 021-20631643

诸中林

zhuzhonglin@unionpay.com

技术咨询: 021-20631643

诸中林

zhuzhonglin@unionpay.com

咨询与服务