查询刷脸结果信息接口 -凯发app官方网站

支付产品

jsapi 支付

小程序支付产品升级指南

刷脸付

api 列表

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
app_id	string	必选	32	支付宝分配给开发者的应用id	2014072300007148
method	string	必选	128	接口名称	zoloz.authentication.customer.ftoken.query
format	string	可选	40	仅支持json	json
charset	string	必选	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	string	必选	10	商户生成签名字符串所使用的签名算法类型，目前支持rsa2和rsa，推荐使用rsa2	rsa2
sign	string	必选	344	商户请求参数的签名串，详见签名	详见示例
timestamp	string	必选	19	发送请求的时间，格式"yyyy-mm-dd hh:mm:ss"	2014-07-24 03:07:50
version	string	必选	3	调用的接口版本，固定为：1.0	1.0
app_auth_token	string	可选	40	详见应用授权概述
biz_content	string	必选		请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

业务请求参数

ftoken必选string(64)

【描述】人脸token

【示例值】fp0593e8d5c136277f13fd5bc36c13a7db7

biz_type必选string(10)

【描述】1、1：1人脸验证能力 2、1：n人脸搜索能力（支付宝uid入库） 3、1：n人脸搜索能力（支付宝手机号入库） 4、手机号和人脸识别综合能力

【示例值】1

zim_id可选string(128)

【描述】刷脸初始化流程中产生的zimid值

【示例值】3b35b4677de2c69bb5bab69a4a5168d62

ext_info可选faceextinfo

【描述】人脸产品拓展参数

【示例值】1

min_age可选string(3)

【描述】年龄区间判断的下限，闭区间

【示例值】10

max_age可选string(3)

【描述】年龄区间判断的上限，闭区间

【示例值】30

参数	类型	是否必选	最大长度	描述	示例值
ftoken	string	必选	64	人脸token	fp0593e8d5c136277f13fd5bc36c13a7db7
zim_id	string	可选	128	刷脸初始化流程中产生的zimid值	3b35b4677de2c69bb5bab69a4a5168d62
biz_type	string	必选	10	1、1：1人脸验证能力 2、1：n人脸搜索能力（支付宝uid入库） 3、1：n人脸搜索能力（支付宝手机号入库） 4、手机号和人脸识别综合能力	1
ext_info	faceextinfo	可选		人脸产品拓展参数	1

常见请求示例

默认示例

curljavac#php

curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=zoloz.authentication.customer.ftoken.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
 -f 'app_auth_token=${app_auth_token}' \
 -f 'biz_content={
	"zim_id":"3b35b4677de2c69bb5bab69a4a5168d62",
	"ftoken":"fp0593e8d5c136277f13fd5bc36c13a7db7",
	"biz_type":"1",
	"ext_info":{
		"max_age":"30",
		"min_age":"10"
	}
}'

说明：本示例仅供参考。

公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
code	string	必选	-	网关返回码,	40004
msg	string	必选	-	网关返回码描述,	business failed
sub_code	string	可选	-	业务返回码，参见具体的api接口文档	acq.trade_has_success
sub_msg	string	可选	-	业务返回码描述，参见具体的api接口文档	交易已被支付
sign	string	必选	-	签名,	dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

以下参数二选一

uidstring(20)

【描述】支付宝uid

新商户建议使用open_id替代该字段。对于新商户，uid字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看openid配置申请。

【示例值】2088002842508713

open_id｜支付宝用户open_idstring(128)

【描述】支付宝用户open_id 详情可查看 openid简介

【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5

uid_tel_pair_list特殊可选zhubuidtelpair[](500)

【描述】用户名信息返回的列表

以下参数二选一必选

user_idstring(20)

【描述】支付宝uid

新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看openid配置申请。

【示例值】2088302193568425

open_id｜支付宝用户open_idstring(128)

【描述】支付宝用户open_id 详情可查看 openid简介

【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5

age_check_result可选string(6)

【描述】年龄是否在指定范围内，未指定范围则返回空，true/false

【示例值】true

cert_no可选string(128)

【描述】身份证号码

【示例值】身份证号码

cert_name可选string(512)

【描述】证件姓名

【示例值】张三

face_id可选string(128)

【描述】由isv定义的对自然人唯一编码，举例可以是身份证号码和姓名的md5值，或者是其他编码方式，要求脱敏、随机且在isv可以唯一说明一个自然人

【示例值】6458f8361582010447730145389650

参数	类型	是否必选	最大长度	描述	示例值
uid	string	二选一	20	支付宝uid 新商户建议使用open_id替代该字段。对于新商户，uid字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看openid配置申请。	2088002842508713
open_id	string	128	支付宝用户open_id 详情可查看 openid简介	074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
uid_tel_pair_list	zhubuidtelpair[]	特殊可选	500	用户名信息返回的列表
age_check_result	string	可选	6	年龄是否在指定范围内，未指定范围则返回空，true/false	true
cert_no	string	可选	128	身份证号码	身份证号码
cert_name	string	可选	512	证件姓名	张三
face_id	string	可选	128	由isv定义的对自然人唯一编码，举例可以是身份证号码和姓名的md5值，或者是其他编码方式，要求脱敏、随机且在isv可以唯一说明一个自然人	6458f8361582010447730145389650

响应示例

正常示例

异常示例

{
    "zoloz_authentication_customer_ftoken_query_response": {
        "code": "10000",
        "msg": "success",
        "uid": "2088002842508713",
        "open_id": "074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
        "uid_tel_pair_list": [
            {
                "user_id": "2088302193568425",
                "open_id": "074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5"
            }
        ],
        "age_check_result": "true",
        "cert_no": "身份证号码",
        "cert_name": "张三",
        "face_id": "6458f8361582010447730145389650"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}