人脸路由接口
测试环境:http://47.95.131.62:8080/api/v1/pay/bankcard/face-route
此接口为银联人脸识别前置接口,调用此接口获取token作为银行卡消费卡磁字段进行上送
请求参数(O-非必传 ,M-必传):
- 本接口无需包含接口公共参数,仅传输下列参数即可:
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
accessid | 接入机构标识 | String | M | ||
pn | SAAS终端号 | String | M | ||
routMd | 路由方式 | String | 最大长度2,1:路由索引 2:路由索引+手机号后四位 3:保留 | 1 | M |
phoneNo | 手机号 | String | 最大长度11,路由方式为2时,上送手机号后四位;路由方式为3时,上送完整手机号 | O | |
pic | 人脸数据 | String | Base64格式上送 | M | |
pin | 刷脸付口令 | String | 根据刷脸付口令和口令加密因子异或得到pinblock,再3DES加密;当路由方式为1或2时上送 | O | |
xorSalt | 口令加密因子 | String | 最大长度16,与刷脸付口令异或得到pinblock;格式为MMddHHmmss+6位随机数;当路由方式为1或2时上送 当返回码为10时返回 | O | |
bioRslt | 活检结果 | String | 最大长度50,见下方详细说明 | M | |
trxAmt | 交易金额 | String | 分为单位,前补零,定长12位 | M | |
trxCurr | 交易币种 | String | 最大长度3,156(人民币) | 156 | M |
trxLoc | 位置信息 | String | 最大长度20,经纬度,格式为纬度/经度,+表示北纬、东经,-表示南纬、西经。 举例:+37.12/-121.23 | O | |
reqResv | 银联保留字段 | String | 保留字段,固定传A | M | |
mac | 消费报文的签名值 | String | HEX编码 | 针对除mac参数以外的其它参数的签名值 | M |
活检结果说明:
内容 | 长度 | 含义 |
---|---|---|
算法厂商标识码 | 3 | 当未进行活检或采用未经过银联认证活检算法时,本字段填写‘000’,后续字段以空格填充。如上送非银联分配编码将拒绝交易。(具体编码由中国银联认证办公室根据算法检测情况统一分配)当未进行活检或采用未经过银联认证活检算法时,本字段填写‘000’,后续字段以空格填充。如上送非银联分配编码将拒绝交易。(具体编码由中国银联认证办公室根据算法检测情况统一分配) |
活检方式 | 2 | 01:3D 02:双目 03:TOF |
活检算法能力 | 1 | A:基本级 B:增强级 |
活检算法信息 | 20 | 算法名称、版本,应与算法检测时相关信息一致,不足位以空格填充 |
摄像头信息 | 20 | 摄像头厂商、型号,应与算法检测时相关信息一致,不足为以空格填充 |
活检通过阈值 | 2 | 取值范围:00-99(算法为受理终端配置的活检通过分值) |
活检评分 | 2 | 取值范围:00-99,如实际评分为100, 以99上送(每次识别时实际活检评分) |
返回参数
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
mac | 返回报文的签名值 | String | HEX编码 | 针对除mac参数以外的其它参数的签名值,result为0时返回 | O |
result | 业务结果 | String | 0 : 成功;1 : 失败;10:需继续采集手机号后四位 | M | |
token | 账户标记 | String | result为0时返回 | O | |
msg | 错误信息 | String | result为1时显示错误信息 | O |
文档更新时间: 2024-10-01 15:23 作者:admin