人脸验证

获取人脸验证状态

获取人脸验证状态

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/Onboarding/linkMerchantApi/queryLiveVerification

生产环境请求地址：POST https://api.futurepay.global/api/v1/v1/Onboarding/linkMerchantApi/queryLiveVerification

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`subMerchantId`	M	string	子账号商户号

响应data参数

字段名	类型	说明
`verificationLink`	String	人脸验证链接(status不为futile、complete、timeout时返回链接)
`validityTime`	String	验证链接到期时间(UTC+0时区,yyyy-MM-dd HH:mm:ss格式)
`status`	String	人脸验证状态(可能的值人脸验证状态)
`requestID`	String	本次请求的唯一id

集成

获取人脸验证状态调用输入

{
    "subMerchantId": "1989162639472898048"
}

获取人脸验证状态调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": "1763116314337",
    "data": {
        "verificationLink": null,
        "validityTime": null,
        "status": "complete",
        "requestID": "d989ffe3-16e8-4d20-b102-68461e07932a"
    },
    "success": true
}

发起人脸验证

发起人脸验证

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/Onboarding/linkMerchantApi/linkToLiveVerification

生产环境请求地址：POST https://api.futurepay.global/api/v1/v1/Onboarding/linkMerchantApi/linkToLiveVerification

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`subMerchantId`	M	string	需要发起验证的子账号商户号
`redirectLinks`	M	string	认证结束后页面重定向地址

响应data参数

字段名	类型	说明
`verificationLink`	String	人脸验证链接(status!=complete时返回该字段)
`validityTime`	String	验证链接到期时间(UTC+0时区,yyyy-MM-dd HH:mm:ss格式)
`status`	String	人脸验证状态(可能的值人脸验证状态)
`requestID`	String	本次请求的唯一id

集成

发起人脸验证调用输入

{
    "redirectLinks": "https://premerchant.futurepay-develop.com/",
    "subMerchantId": "1989162639472898048"
}

发起人脸验证调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": "1763117334326",
    "data": {
        "verificationLink": "https://sg.faceid.qq.com/reflect/?token=F1BDE359-3582-460E-9FA0-1BE3DF06FFC7",
        "validityTime": "2025-11-14 10:58:54",
        "status": "initiated",
        "requestID": "b52640fd-09bd-4699-95f3-3eb830d58840"
    },
    "success": true
}

字典对照表

人脸验证状态

value	name
initiated	发起验证
timeout	验证超时
complete	验证完成
failed	验证失败
futile	验证失效

WEBHOOK

{
	"merchantId": "1866780349053448192",
	"notificationItems": [
		{
			"eventCode": "LIVE_VERIFICATION_NOTIFY",
			"subMerchantId": 1989162639472898048,
			"status": "complete",
			"eventDate": 1763117389328
		}
	]
}

Updated about 16 hours ago