文档

人脸验证

获取人脸验证状态

获取人脸验证状态

端点目标 URL

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

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

字段说明

调用的特定输入参数

字段名称必填类 型描述
subMerchantIdMstring子账号商户号

响应data参数

字段名类型说明
verificationLinkString人脸验证链接(status不为futile、complete、timeout时返回链接)
validityTimeString验证链接到期时间(UTC+0时区,yyyy-MM-dd HH:mm:ss格式)
statusString人脸验证状态(可能的值人脸验证状态)
requestIDString本次请求的唯一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://api.futurepay-develop.com/api/v1/Onboarding/linkMerchantApi/linkToLiveVerification

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

字段说明

调用的特定输入参数

字段名称必填类 型描述
subMerchantIdMstring需要发起验证的子账号商户号
redirectLinksQstring认证结束后页面重定向地址
sumSubIdQstringsumSub申请人id

响应data参数

字段名类型说明
verificationLinkString人脸验证链接(status!=complete时返回该字段)
validityTimeString验证链接到期时间(UTC+0时区,yyyy-MM-dd HH:mm:ss格式)
statusString人脸验证状态(可能的值人脸验证状态)
requestIDString本次请求的唯一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
}

字典对照表

人脸验证状态

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

WEBHOOK

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

Updated 9 days ago

Did this page help you?