通用场景
通过该接口获取刷脸支付服务的初始化信息，详细字段描述请参考产品说明文档
公共请求参数
业务请求参数
apdid_token可选string(64)
【描述】设备指纹，用于唯一标识一台设备
【示例值】40kl9e97cqcmjka5gft0arvpq7gtar6ye5f73mj8zqbw9eopzqeaaa==
bio_meta_info可选string(64)
【描述】生物识别元信息
【示例值】3.13.0:12419136,6
app_name可选string(64)
【描述】人脸识别应用名称
【示例值】com.alipay.zoloz.smile
app_version可选string(64)
【描述】人脸识别应用版本号
【示例值】3.7.0.201809191618
device_type可选string(64)
【描述】设备类型
【示例值】android
device_model可选string(64)
【描述】设备型号
【示例值】t2
os_version可选string(64)
【描述】操作系统版本号
【示例值】7.1.1
zim_ver可选string(64)
【描述】zim版本号
【示例值】1.0.0
base_ver可选string(64)
【描述】基础包版本号
【示例值】7.1.1
remote_log_id可选string(64)
【描述】业务id
【示例值】bcf71c4290f288f4421ee9d49eedbf1e2840ba
machine_info可选facemachineinfo
【描述】机具信息，调用人脸识别sdk获取
camera_drive_ver可选string(64)
【描述】摄像头驱动版本号
【示例值】1.0
camera_model可选string(64)
【描述】摄像头型号
【示例值】astrap1
camera_name可选string(64)
【描述】摄像头名称
【示例值】astrap1
camera_ver可选string(64)
【描述】摄像头版本号
【示例值】1.0
machine_code可选string(64)
【描述】机具编码
【示例值】wydaz27pfsedangk7qnmxzlv
machine_model可选string(64)
【描述】机具型号
【示例值】t2
machine_ver可选string(64)
【描述】机具版本号
【示例值】7.1.1
ext可选string(1024)
【描述】扩展信息
【示例值】扩展信息
merchant_info可选facemerchantinfo
【描述】商户信息
area_code可选string(64)
【描述】区域编码
【示例值】华中
brand_code可选string(64)
【描述】品牌编码
【示例值】kfc
device_mac可选string(64)
【描述】机具mac地址
【示例值】1c:aa:07:b0:e7:af
group可选string(64)
【描述】机具分组编码
【示例值】group1
device_num可选string(128)
【描述】机具编码
【示例值】test_zoloz_test
geo可选string(64)
【描述】经纬度
【示例值】120.10785,30.26708
merchant_id可选string(64)
【描述】商户id
【示例值】2088302068579978
partner_id可选string(64)
【描述】isv id
【示例值】2088302068579978
store_code可选string(64)
【描述】门店编码
【示例值】test
wifimac可选string(64)
【描述】wi-fi mac地址
【示例值】1c:aa:07:b0:e7:af
wifiname可选string(128)
【描述】wi-fi 名称
【示例值】alipay-test
ext_info可选faceextparams
【描述】扩展信息
biz_type特殊可选string(64)
【描述】业务类型：7，基于1:n人脸搜索的刷脸支付场景；8，基于姓名和身份证号的刷脸支付场景。
【示例值】1
常见请求示例
默认示例
alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2");
zolozauthenticationsmilepayinitializerequest request = new zolozauthenticationsmilepayinitializerequest();
request.setbizcontent("{"
" \"apdid_token\":\"40kl9e97cqcmjka5gft0arvpq7gtar6ye5f73mj8zqbw9eopzqeaaa==\","
" \"bio_meta_info\":\"3.13.0:12419136,6\","
" \"app_name\":\"com.alipay.zoloz.smile\","
" \"app_version\":\"3.7.0.201809191618\","
" \"device_type\":\"android\","
" \"device_model\":\"t2\","
" \"os_version\":\"7.1.1\","
" \"zim_ver\":\"1.0.0\","
" \"base_ver\":\"7.1.1\","
" \"remote_log_id\":\"bcf71c4290f288f4421ee9d49eedbf1e2840ba\","
" \"machine_info\":{"
" \"camera_drive_ver\":\"1.0\","
" \"camera_model\":\"astrap1\","
" \"camera_name\":\"astrap1\","
" \"camera_ver\":\"1.0\","
" \"machine_code\":\"wydaz27pfsedangk7qnmxzlv\","
" \"machine_model\":\"t2\","
" \"machine_ver\":\"7.1.1\","
" \"ext\":\"扩展信息\""
" },"
" \"merchant_info\":{"
" \"area_code\":\"华中\","
" \"brand_code\":\"kfc\","
" \"device_mac\":\"1c:aa:07:b0:e7:af\","
" \"group\":\"group1\","
" \"device_num\":\"test_zoloz_test\","
" \"geo\":\"120.10785,30.26708\","
" \"merchant_id\":\"2088302068579978\","
" \"partner_id\":\"2088302068579978\","
" \"store_code\":\"test\","
" \"wifimac\":\"1c:aa:07:b0:e7:af\","
" \"wifiname\":\"alipay-test\""
" },"
" \"ext_info\":{"
" \"biz_type\":\"1\""
" }"
"}");
zolozauthenticationsmilepayinitializeresponse response = alipayclient.execute(request);
if(response.issuccess()){
system.out.println("调用成功");
} else {
system.out.println("调用失败");
}说明：本示例仅供参考。
公共响应参数
业务响应参数
ret_code_sub特殊可选string(64)
【描述】返回详细码
【示例值】z3161
ret_message_sub特殊可选string(128)
【描述】返回详细信息
【示例值】操作成功
zim_id特殊可选string(64)
【描述】zim上下文id
【示例值】e0bdf675bc8b6f442eb03b2109d59c92d
zim_init_client_data特殊可选string(1024)
【描述】客户端协议
【示例值】客户端渲染数据，json或pb格式
响应示例
正常示例
异常示例
{
"zoloz_authentication_smilepay_initialize_response": {
"code": "10000",
"msg": "success",
"ret_code_sub": "z3161",
"ret_message_sub": "操作成功",
"zim_id": "e0bdf675bc8b6f442eb03b2109d59c92d",
"zim_init_client_data": "客户端渲染数据，json或pb格式"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| invalid_parameter | 参数有误 | 请求入参无效，请检查参数格式 |
| system_error | 系统繁忙 | 一般为支付宝系统问题，可以重新发起请求 |
| biz_error | 业务异常 | 业务异常，请根据详细返回码排查问题 |