人脸识别

数据 生物特征 收单机构 商户 开发者 发卡机构
通过计算机利用人体所固有的生理特征来进行个人身份鉴定的技术,提供照片比对、身份证认证比对、人脸库管理、人脸检索、活体检测等能力

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

API ID:70

接口状态:正常

请咨询联系人
暂不支持测试

接口名称

照片对比接口

接口描述

上送两张照片进行人脸比对,返回两张照片的人脸相似度评分

接口地址

测试地址: https://facepay.95516.com/bioauth-core-access-web/rest/pictureTwoPicCmp


生产地址: https://facepay.95516.com/bioauth-core-access-web/rest/pictureTwoPicCmp

请求方式

HTTP POST

请求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

接口名称

人脸注册接口

接口描述

人脸信息注册

接口地址

测试地址: https://facepay.95516.com/bioauth-core-access-web/rest/pictureentry


生产地址: https://facepay.95516.com/bioauth-core-access-web/rest/pictureentry

请求方式

HTTP POST

请求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(交易流水号+交易时间),验证响应结果,成功状态下才有签名

接口名称

人脸删除接口

接口描述

删除注册过的人脸信息

接口地址

测试地址: https://facepay.95516.com/bioauth-core-access-web/rest/picturedelete


生产地址: https://facepay.95516.com/bioauth-core-access-web/rest/picturedelete

请求方式

HTTP POST

请求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(交易流水号+交易时间),验证响应结果,成功状态下才有签名

接口名称

人脸修改接口

接口描述

修改已经注册的人脸信息

接口地址

测试地址: https://facepay.95516.com/bioauth-core-access-web/rest/pictureupdate


生产地址: https://facepay.95516.com/bioauth-core-access-web/rest/pictureupdate

请求方式

HTTP GET/POST

请求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(交易流水号+交易时间),验证响应结果,成功状态下才有签名

接口名称

人脸查询接口

接口描述

查询人脸库中某个用户的详细信息

接口地址

测试地址: https://facepay.95516.com/bioauth-core-access-web/rest/picturePicQuery


生产地址: https://facepay.95516.com/bioauth-core-access-web/rest/picturePicQuery

请求方式

HTTP POST

请求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

接口名称

人脸检索接口

接口描述

在一个已有的人脸库中找出与目标人脸最相似的一张或多张人脸,返回每张人脸的相似度评分

接口地址

测试地址: https://facepay.95516.com/bioauth-core-access-web/rest/picturesearch


生产地址: https://facepay.95516.com/bioauth-core-access-web/rest/picturesearch

请求方式

HTTP POST

请求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-必填 人脸分数

接口名称

活体检测接口

接口描述

通过对上传的图像特征检查,判断活体检测图像是由用户本身操作

接口地址

测试地址: https://facepay.95516.com/bioauth-core-access-web/rest/pictureHack


生产地址: https://facepay.95516.com/bioauth-core-access-web/rest/pictureHack

请求方式

HTTP POST

请求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

接口名称

身份证认证比对接口

接口描述

上送证件信息及前端采集照片,通过公安部身份核查数据与前端采集照片进行比对,反馈身份核查结果及人脸相似度评分

接口地址

测试地址: https://facepay.95516.com/bioauth-core-access-web/rest/pictureIdPicCmp


生产地址: https://facepay.95516.com/bioauth-core-access-web/rest/pictureIdPicCmp

请求方式

HTTP POST

请求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服务返回识别的身份证姓名、身份证号码和有效期

接口地址

测试地址: https://facepay.95516.com/bioauth-core-access-web/rest/ pictureCertid


生产地址: https://facepay.95516.com/bioauth-core-access-web/rest/ pictureCertid

请求方式

HTTP POST

请求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服务返回银行卡号与有效期

接口地址

测试地址: https://facepay.95516.com/bioauth-core-access-web/rest/pictureCardNum


生产地址: https://facepay.95516.com/bioauth-core-access-web/rest/pictureCardNum

请求方式

HTTP POST

请求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-依条件必填 变长,数字
产品详情

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

应用场景


幻灯片1.png


应用对象

商户、收单机构、发卡机构、开发者

接入流程

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

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

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

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

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

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

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


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

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


1.png

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


2.png

咨询我们
业务咨询
姓名: 高原
电话: 021-20633437
邮箱: gaoyuan1@unionpay.com
技术咨询
姓名: 贾冠宇
电话: 021-20633201
邮箱: jiaguanyu@unionpay.com
热门推荐