商户人脸接口开发说明书

本说明书仅限内部商户使用

描述

接口文档已经迁移到新网址,请移步 人脸核身

调用方式

http://cmbls/functionjump?action=gofuncid&funcid=0158006&needlogin=true&cmb_app_trans_parms_start=here&CallBackUrl=XX&CorpNo=XX&Auth=XX

其中

http://cmbls/functionjump?action=gofuncid&funcid=0158006&needlogin=true&cmb_app_trans_parms_start=here为固定格式,不能做修改。


参数说明

1.传入参数

字段名释义备注
CallBackUrl回调url,需要对url进行urlencode如果商户的回调url中带有参数,并且参数的值为链接,需要对链接先urlencode,然后在对整个url进行urlencode
CorpNo商户号传递商户固有的商户号
Auth校验字段

该校验字段构成为:

CallBackUrl(不进行urlencode + CorpNo + DesKey(秘钥) 拼接而成的字符串转为小写后 MD5加密而成

例如:"http://99.12.154.158:811/pcooperation/merchant/tokenshowpage.aspx3256350pxbtest1" MD5加密后为:cdace58235947f2a2e01f0b26aeb63f7


2.传出参数

字段名释义备注
ResponseData返回信息

ResponseData,GET/POST方式发送,格式定义如下:

{

" ErrorCode":"0",

" ErrorMsg":"",

"Body":"%responsebody%"

}


参数说明:

参数名称参数说明备注

ErrorCode

加密结果,0为加密成功,1为加密失败
ErrorMsg错误信息,ErrorCode0时,该字段为空,为1时,会有错误信息
BodyErrorCode0时,该字段有结果值,为1时候,结果为空


其中%responsebody%是对如下内容进行DES加密(DES加密密钥与登录说授权密钥一致,测试时候统一用cmbtest1,上线时候需要重新申请)然后转换成Base64String字符串。

{

"Data":"{

"VtmFlag":"Y",

"TryTime":"3",

"ErrCode":"",

"ErrMsg":""

}",

  "Signature":"XXXXXXXXXXXX"

}


参数说明:

参数名称参数说明备注
Data人脸核身结果报文
Signature数字签名结果,该字段是对Data内容进行数字签名得出的结果该结果需要对Data的内容Base64转码后后再与Signature进行验签


Data中的参数说明:

参数名称参数说明备注
VtmFlag人脸核身结果(Y/N
TryTime客户尝试次数(大于等于1的整数)
ErrCode错误码
ErrMsg错误信息


安全控制

请参考“用户登录及授权接口安全控制章节对返回数据进行签名验证。


其他说明

客户在核身结果提示页面点击返回按钮,或者页面左上角的返回箭头,都会回调商户传递的CallBackUrl,蓝色返回按钮会通过post的方式,页面左上角的返回箭头会通过get的方式,返回结果信息。