当前位置: 产品API > 数据 > 人脸识别
产品介绍
  • 服务对象
    商户、收单机构、发卡机构、开发者
  • 产品详情

    通过计算机利用人体所固有的生理特征来进行个人身份鉴定的技术,提供照片比对、身份证认证比对、人脸库管理、人脸检索、活体检测等能力。

  • 应用场景


    幻灯片1.png


应答码参照
应答码状态列表
  • 应答码 描述 解决方案
    1000 成功 暂无
    1001 参数错误 暂无
    1002 RSA解密错误 暂无
    1004 TPS限流异常 暂无
    1005 APP接入异常 暂无
    1006 调用权限异常 暂无
    1007 数据重放异常 暂无
    1008 REDIS操作异常 暂无
    1009 TOKEN信息错误 暂无
    1010 用户已经注册 暂无
    1011 该用户未注册 暂无
    1012 获取密钥错误 暂无
    1013 图片签名错误 暂无
    1014 设备指纹信息不一致 暂无
    2000 系统错误 暂无
    3000 人脸相关服务调用错误 暂无
    4000 天眼相关服务调用错误 暂无
接入流程
接入流程

1、接入方联系银联工作人员进行合作可行性评估(需使用方提交合作目的、使用场景、客户使用授权协议等相关资料)

2、银联工作人员完成评估后向接入方提供合作模式、合作协议模板。

3、接入方确认合作协议内容、完成签订并填写入网申请表。

4、银联工作人员收到协议和入网申请表后向接入方发送开发文档、指定配合开发的技术人员、提供开发测试参数。

5、接入方完成开发,提供测试报告并向银联申请正式参数。

6、银联确认测试报告,向接入方提供正式参数。

7、双方进入运营人员对接流程。


Android SDK

*以下为SDK说明文档,SDK包将尽快提供下载


1.png

iOS SDK

*以下为SDK说明文档,SDK包将尽快提供下载


2.png

API接口
照片对比接口
接口描述
上送两张照片进行人脸比对,返回两张照片的人脸相似度评分
请求方式
POST
生产地址
https://facepay.95516.com/bioauth-core-access-web/rest/pictureTwoPicCmp
测试地址
https://facepay.95516.com/bioauth-core-access-web/rest/pictureTwoPicCmp
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入商ID id string 40 M-必填 接入商ID   
照片 photo string 10485 M-必填 变长,大小1M以内,jpg格式。对图片做base64编码   
照片签名 photoSign string 200 M-必填 SHA256(BASE64(图片+交易流水号+交易时间))   
照片1 photo1 string 10485 M-必填 变长,大小1M以内,jpg格式。对图片做base64编码   
照片签名1 photoSign1 string 200 M-必填 SHA256(BASE64(图片+交易流水号+交易时间))   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
交易时间 tranDateTime string 14 M-必填 YYYYMMDDHHMMSS   
交易流水号 tranRandom string 6 M-必填 6位随机数   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
响应状态码 code string 4 M-必填   
响应状态详情 msg string 256 C-依条件必填 响应状态详情   
签名 sign string 100 C-依条件必填 SHA256(交易时间+交易流水号),验证响应结果,成功状态下才有签名   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
厂商名称 firmNm string 20 M-必填   
相似度评分 score string 6 M-必填 比对失败时返回0   
人脸注册接口
接口描述
人脸信息注册
请求方式
POST
生产地址
https://facepay.95516.com/bioauth-core-access-web/rest/pictureentry
测试地址
https://facepay.95516.com/bioauth-core-access-web/rest/pictureentry
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入商ID id string 40 M-必填 接入商ID   
照片 photo string 10485 M-必填 变长,大小1M以内,jpg格式。对图片做base64编码   
照片签名 photoSign string 200 M-必填 SHA256(BASE64(图片+交易流水号+交易时间))   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
交易时间 tranDateTime string 14 M-必填 YYYYMMDDHHMMSS   
交易流水号 tranRandom string 6 M-必填 6位随机数   
用户ID userId string 18 M-必填 变长   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
响应状态码 code string 4 M-必填   
响应状态详情 msg string 256 C-依条件必填 响应状态详情   
签名 sign string 100 C-依条件必填 SHA256(交易流水号+交易时间),验证响应结果,成功状态下才有签名   
人脸删除接口
接口描述
删除注册过的人脸信息
请求方式
POST
生产地址
https://facepay.95516.com/bioauth-core-access-web/rest/picturedelete
测试地址
https://facepay.95516.com/bioauth-core-access-web/rest/picturedelete
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入商ID id string 40 M-必填 接入商ID   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
交易时间 tranDateTime string 14 M-必填 YYYYMMDDHHMMSS   
交易流水号 tranRandom string 6 M-必填 6位随机数   
用户ID userId string 18 M-必填 变长   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
响应状态码 code string 4 M-必填   
响应状态详情 msg string 256 C-依条件必填 响应状态详情   
签名 sign string 100 C-依条件必填 SHA256(交易流水号+交易时间),验证响应结果,成功状态下才有签名   
人脸修改接口
接口描述
修改已经注册的人脸信息
请求方式
GET/POST
生产地址
https://facepay.95516.com/bioauth-core-access-web/rest/pictureupdate
测试地址
https://facepay.95516.com/bioauth-core-access-web/rest/pictureupdate
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入商ID id string 40 M-必填 接入商ID   
照片 photo string 10485 M-必填 变长,大小1M以内,jpg格式。对图片做base64编码   
照片签名 photoSign string 100 M-必填 SHA256(BASE64(图片+交易流水号+交易时间))   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
交易时间 tranDateTime string 14 M-必填 YYYYMMDDHHMMSS   
交易流水号 tranRandom string 6 M-必填 6位随机数   
用户ID userId string 18 M-必填 变长   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
响应状态码 code string 4 M-必填   
响应状态详情 msg string 256 C-依条件必填 响应状态详情   
签名 sign string 100 C-依条件必填 SHA256(交易流水号+交易时间),验证响应结果,成功状态下才有签名   
人脸查询接口
接口描述
查询人脸库中某个用户的详细信息
请求方式
POST
生产地址
https://facepay.95516.com/bioauth-core-access-web/rest/picturePicQuery
测试地址
https://facepay.95516.com/bioauth-core-access-web/rest/picturePicQuery
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入商ID id string 40 M-必填 接入商ID   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
交易时间 tranDateTime string 14 M-必填 YYYYMMDDHHMMSS   
交易流水号 tranRandom string 6 M-必填 6位随机数   
用户ID userId string 18 M-必填 变长   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
响应状态码 code string 4 M-必填   
响应状态详情 msg string 256 C-依条件必填 响应状态详情   
签名 sign string 100 C-依条件必填 SHA256(交易流水号+交易时间),验证响应结果,成功状态下才有签名   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
图像名称 imgFileNm string 60 M-必填 变长,特征图像的文件名数组   
图像内容 picLife string 10485 M-必填 变长,特征图像的base64编码数组   
存在标识 isExst string 1 C-依条件必填 定长,用户权限开通则为1,反之为0   
人脸检索接口
接口描述
在一个已有的人脸库中找出与目标人脸最相似的一张或多张人脸,返回每张人脸的相似度评分
请求方式
POST
生产地址
https://facepay.95516.com/bioauth-core-access-web/rest/picturesearch
测试地址
https://facepay.95516.com/bioauth-core-access-web/rest/picturesearch
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入商ID id string 40 M-必填 接入商ID   
照片 photo string 10485 M-必填 变长,大小1M以内,jpg格式。对图片做base64编码   
照片签名 photoSign string 200 M-必填 SHA256(BASE64(图片+交易流水号+交易时间))   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
交易时间 tranDateTime string 14 M-必填 YYYYMMDDHHMMSS   
交易流水号 tranRandom string 6 M-必填 6位随机数   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
响应状态码 code string 4 M-必填   
响应状态详情 msg string 256 C-依条件必填 响应状态详情   
签名 sign string 100 C-依条件必填 SHA256(交易时间+交易流水号),验证响应结果,成功状态下才有签名   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
用户ID userId string 18 M-必填 变长   
人脸分数 score string 10 M-必填 人脸分数   
活体检测接口
接口描述
通过对上传的图像特征检查,判断活体检测图像是由用户本身操作
请求方式
POST
生产地址
https://facepay.95516.com/bioauth-core-access-web/rest/pictureHack
测试地址
https://facepay.95516.com/bioauth-core-access-web/rest/pictureHack
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入商ID id string 40 M-必填 接入商ID   
照片 photo string 10485 M-必填 变长,大小1M以内,jpg格式。对图片做base64编码   
照片签名 photoSign string 200 M-必填 SHA256(BASE64(图片+交易流水号+交易时间))   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
交易时间 tranDateTime string 14 M-必填 YYYYMMDDHHMMSS   
交易流水号 tranRandom string 6 M-必填 6位随机数   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
响应状态码 code string 4 M-必填   
响应状态详情 msg string 256 M-必填 响应状态详情   
签名 sign string 100 C-依条件必填 SHA256(交易时间+交易流水号),验证响应结果,成功状态下才有签名   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
厂商名称 firmNm string 20 M-必填   
HACK度评分 score string 6 M-必填 高于某个数值则判别图片为HACK   
身份证认证比对接口
接口描述
上送证件信息及前端采集照片,通过公安部身份核查数据与前端采集照片进行比对,反馈身份核查结果及人脸相似度评分
请求方式
POST
生产地址
https://facepay.95516.com/bioauth-core-access-web/rest/pictureIdPicCmp
测试地址
https://facepay.95516.com/bioauth-core-access-web/rest/pictureIdPicCmp
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入商ID id string 40 M-必填 接入商ID   
照片 photo string 10485 M-必填 变长,大小1M以内,jpg格式。对图片做base64编码   
照片签名 photoSign string 200 M-必填 SHA256(BASE64(图片+交易流水号+交易时间))   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
交易时间 tranDateTime string 14 M-必填 YYYYMMDDHHMMSS   
交易流水号 tranRandom string 6 M-必填 6位随机数   
身份证号 certId string 19 M-必填 变长,字母数字组合   
姓名 name string 40 M-必填 变长,最大长度40(20个汉字)   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
响应状态码 code string 4 M-必填   
响应状态详情 msg string 256 C-依条件必填 响应状态详情   
签名 sign string 100 C-依条件必填 SHA256(交易时间+交易流水号),验证响应结果,成功状态下才有签名   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
厂商名称 firmNm string 20 M-必填   
相似度评分 score string 6 M-必填 比对失败时返回0   
身份证OCR接口
接口描述
上传身份证正面与背面照片至平台,通过OCR服务返回识别的身份证姓名、身份证号码和有效期
请求方式
POST
生产地址
https://facepay.95516.com/bioauth-core-access-web/rest/ pictureCertid
测试地址
https://facepay.95516.com/bioauth-core-access-web/rest/ pictureCertid
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入商ID id string 40 M-必填 接入商ID   
身份证正背面信息 side string 1 M-必填 定长,a:正面,b:背面,1:两面   
身份证正面图片 photo string 10485 C-依条件必填 变长,照片大小要求在1M之内,jpg格式。对图片进行base64编码   
身份证背面图片 photo1 string 10485 C-依条件必填 变长,照片大小要求在1M之内,jpg格式。对图片进行base64编码   
照片签名 photoSign string 200 C-依条件必填 SHA256(BASE64(图片+交易流水号+交易时间))   
照片签名 photoSign1 string 200 C-依条件必填 SHA256(BASE64(图片+交易流水号+交易时间))   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
交易时间 tranDateTime string 14 M-必填 YYYYMMDDHHMMSS   
交易流水号 tranRandom string 6 M-必填 6位随机数   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
响应状态码 code string 4 M-必填   
响应状态详情 msg string 256 C-依条件必填 响应状态详情   
签名 sign string 100 C-依条件必填 SHA256(交易时间+交易流水号),验证响应结果,成功状态下才有签名   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
厂商名称 firmNm string 20 M-必填 变长   
身份证号码识别成功标识 certIdValid string 1 C-依条件必填 定长,0:识别失败,1:识别成功   
身份证号码 certId string 19 C-依条件必填 变长,字母数字组合   
姓名识别成功标识 nmValid string 1 C-依条件必填 定长,0:识别失败,1:识别成功   
姓名 nm string 40 C-依条件必填 变长,最大长度40(20个汉字)   
性别识别成功标识 sexValid string 1 C-依条件必填 定长,0:识别失败,1:识别成功   
性别 sex string 2 C-依条件必填 定长   
民族识别成功标识 nationValid string 1 C-依条件必填 定长,0:识别失败,1:识别成功   
民族 nation string 40 C-依条件必填 变长,最大长度40   
出生年识别成功标识 yearValid string 1 C-依条件必填 定长,0:识别失败,1:识别成功   
出生年 year string 4 C-依条件必填 定长   
出生月识别成功标识 monthValid string C-依条件必填 1 定长,0:识别失败,1:识别成功   
出生月 month string 2 C-依条件必填 变长,最大长度2   
出生日识别成功标识 dayValid string 1 C-依条件必填 定长,0:识别失败,1:识别成功   
出生日 day string 2 C-依条件必填 变长,最大长度2   
地址识别成功标识 addrValid string 1 C-依条件必填 定长,0:识别失败,1:识别成功   
地址 addr string 255 C-依条件必填 变长,最大长度255   
签发机关识别成功标识 authorityValid string 1 C-依条件必填 定长,0:识别失败,1:识别成功   
签发机关 authority string 255 C-依条件必填 变长,最大长度255   
有效期限识别成功标识 timelimitValid string 1 C-依条件必填 定长,0:识别失败,1:识别成功   
有效期限 timelimit string 255 C-依条件必填 变长,最大长度255   
银行卡OCR接口
接口描述
上传银行卡照片至平台,通过OCR服务返回银行卡号与有效期
请求方式
POST
生产地址
https://facepay.95516.com/bioauth-core-access-web/rest/pictureCardNum
测试地址
https://facepay.95516.com/bioauth-core-access-web/rest/pictureCardNum
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
接入商ID id string 40 M-必填 接入商ID   
照片 photo string 10485 M-必填 变长,大小1M以内,jpg格式。对图片做base64编码   
照片签名 photoSign string 200 M-必填 SHA256(BASE64(图片+交易流水号+交易时间))   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
交易时间 tranDateTime string 14 M-必填 YYYYMMDDHHMMSS   
交易流水号 tranRandom string 6 M-必填 6位随机数   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
响应状态码 code string 4 M-必填   
响应状态详情 msg string 256 C-依条件必填 响应状态详情   
签名 sign string 100 C-依条件必填 SHA256(交易时间+交易流水号),验证响应结果,成功状态下才有签名   
加密参数 data string 1000 M-必填 BASE64(RSA加密(key, JSON参数字符串))   
厂商名称 firmNm string 20 M-必填 变长   
银行卡号识别成功标识 acctNoValid string 1 C-依条件必填 定长,0:识别失败,1:识别成功   
银行卡号 acctNo string 19 C-依条件必填 变长,数字   
联系我们

业务咨询: 高原

021-20633437

gaoyuan1@unionpay.com

中国银联版权所有©2002-2019沪 ICP备07032180号