星楼网络 · 人脸核验文档

智简魔方·财务版 人脸核验插件（star_loft_fv_for_zjmf_mfcw）

平台标识：star_loft_fv_for_zjmf_mfcw。为智简魔方·财务版（3.7.6+）系统提供 人脸核验能力（活体检测 + 人脸比对），对接星楼网络人脸核验（FV）平台。

1. 功能特性

  • 有源人脸识别（auth）：人脸 + 公安库真实身份比对
  • 无源人脸识别（self）：仅活体检测，不做身份要素比对
  • 活体检测，有效防范照片、视频等攻击手段
  • PC 展示二维码、手机扫码完成核身的承接流程
  • 认证结果异步回调与状态轮询
  • 安全的 HMAC-SHA256 签名认证

2. 安装与流程

2.1 上传插件

将 star_loft_fv_for_zjmf_mfcw 目录上传到：

/public/plugins/certification/star_loft_fv_for_zjmf_mfcw/

2.2 使用流程

  1. 用户在会员中心发起人脸核验
  2. 插件调用创建订单接口，平台返回核身跳转地址
  3. PC 端进入星楼网络 FV 承接页展示二维码，手机扫码完成核身；移动端直接跳转
  4. 核身完成后回跳，插件轮询 / 回调更新状态

3. 对接接口

鉴权方式详见 API v2 文档：

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

4. 结果回传

核身订单一账通过 notify_url（异步）与 return_url（同步）回流，字段含 biz_no、status、result_code、cost、sign，请校验签名后落地。

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

5. 环境要求

  • PHP >= 7.0，curl / json 扩展，SSL 支持
  • 智简魔方·财务版 3.7.6+