智简魔方业务系统 v10 人脸核验插件（star_loft_fv_for_zjmf_v10）

平台标识：star_loft_fv_for_zjmf_v10。对接星楼网络人脸核验（FV）平台 人脸核验能力，适用于智简魔方业务系统 v10， 支持人脸识别、扫码承接与异步回调。

1. 功能特性

• 有源人脸识别（auth）：人脸 + 公安库真实身份比对
• 无源人脸识别（self）：仅活体检测，不做身份要素比对
• 活体检测，防范照片 / 视频等攻击
• PC 展示二维码、手机扫码完成核身的承接流程
• 按 v10 实名认证接口规范开发，支持自动扣费 / 免费次数
• 认证结果异步回调 + 前台状态轮询，幂等与轮询上限保护
• 安全的 HMAC-SHA256 签名认证

2. 安装步骤

2.1 上传目录

将 star_loft_fv_for_zjmf_v10 目录上传到：

/public/plugins/certification/star_loft_fv_for_zjmf_v10/

2.2 后台安装

1. 登录 v10 后台 → 实名认证 → 接口管理
2. 找到 StarLoft 人脸核验，点击 安装，然后 配置
3. 填写 API 地址、API Key、API Secret 及费用 / 免费次数 / 回跳地址

3. 使用流程

1. 用户在 v10 会员中心进入人脸核验，选择 StarLoft 人脸核验
2. 插件创建核身任务并返回跳转地址
3. PC 进入 FV 承接页扫码，手机扫码完成核身；移动端直接跳转
4. 核身完成回跳，插件经回调/轮询同步结果

4. 对接接口

• POST /api/fv/start — 创建人脸核验订单（入参含 fv_style）
• POST /api/fv/result — 查询核身结果

5. 结果回传

核身终态通过 notify_url 异步推送、return_url 同步回跳，字段含 biz_no、status、result_code、cost、sign，请校验签名（HMAC-SHA256）后落地。

建议同时配置 notify_url 与 return_url：notify_url 负责服务端结果落地（最实时）， return_url 负责用户侧页面回流。未配置 notify_url 时只能靠 /api/fv/result 轮询，平台会按每笔核身的结果反查额度与最小间隔同步结果， 因此请勿按秒级高频轮询（建议 ≥ 5~10 秒并设轮询上限），高频轮询不会让结果更早出现。

6. 支持

• 插件版本 v1.0.0，作者 StarLoft，兼容智简魔方业务系统 v10