魔方财务对接 · 支付宝实名认证插件

插件概述

本插件专为魔方财务系统开发，用于对接创茂平台支付宝实名认证接口。用户在前台提交姓名、身份证号等信息后，生成二维码或唤起支付宝App完成授权，系统自动轮询获取结果并更新实名状态。

主要特性：

• 实名安全性：用户输入信息之后需要跳转或扫描二维码，获得支付宝授权，支付宝授权完成之后，若用户填写的信息与支付宝实名信息不符，则不通过实名，相反则通过实名。
• 实名安全性体现：首先支付宝账号肯定是在身边的，杜绝了二要素，三要素那种网络上疯传的信息，确保实名人真实操作，。
• 优势：价格低廉，个人可用，稳定安全，相比于人脸识别价格更为低廉，安全系数仅次于人脸识别。

插件下载

插件包名：mfcw.zip

预设下载地址： 点击下载插件包
（请将上方链接替换为您实际上传后的下载地址）

安装步骤

1. 解压上传

将下载的 mfcw.zip 解压，得到文件夹 alipay_realname。将此文件夹上传至魔方财务系统的插件目录：

public/plugins/certification/alipay_realname/config.php

确保根据这个目录可以找到config.php文件即可

2. 后台安装

1. 登录魔方财务系统后台。
2. 依次进入 设置 → 实名设置 → 接口设置。
3. 在接口列表中找到 “支付宝快捷认证”（作者：创茂网络），点击右侧的 “安装” 按钮。
4. 安装成功后，点击 “配置” 进入参数设置页面。

获取API Key与授权域名

1. 访问创茂API官网：https://api.mcve.top 并登录您的账户。
2. 进入 用户中心 或 API管理 页面，找到您的 API Key（一串字母数字组合）。
3. 确保您已在平台购买 “支付宝实名认证” 服务。
4. 在平台的 “域名白名单” 中添加您的魔方财务访问域名/您的平台域名（例如 tc.mcve.top）。
   注意：填写时不带 https://

插件配置说明

在后台插件配置页面，您需要填写以下信息：

配置项	说明	示例
认证金额	每次认证需支付的金额（元），0表示免费。	0
免费次数	每个用户免费认证次数。	0
API Key	从创茂平台获取的API密钥。	42a32a973008612bb34b8f3c358f451a
授权域名	您在平台白名单中配置的域名/您的平台域名。	tc.mcve.top
手机号字段	控制前台是否显示手机号输入框及是否必填。 选项：不填 / 选填 / 必填	选填
支付宝账号字段	控制前台是否显示支付宝账号输入框及是否必填。 选项同上。	选填

配置完成后点击 “提交” 保存。

前台使用效果

1. 用户发起认证：用户在前台进入实名认证页面，选择个人认证，填写必要信息（姓名、身份证号，以及根据配置显示的手机号/支付宝账号）。
2. 二维码页面：提交后，系统展示简约白色卡片页面，二维码快速显示。
   - 电脑用户：直接使用支付宝扫码。
   - 手机用户：页面下方显示醒目的 “打开支付宝App” 按钮，点击可尝试直接唤起支付宝完成授权（若未安装支付宝，则自动跳转浏览器备用链接）。
3. 结果同步：用户完成支付宝端授权后，页面自动返回魔方系统。魔方后台通过轮询接口自动获取认证结果，并更新用户实名状态（通过/不通过）。

常见问题

Q：安装后页面报500错误？

A：请检查插件目录权限，并确认 /upload/ 目录是否可写（用于生成临时二维码）。如需查看详细错误，可在插件文件开头添加 ini_set('display_errors', 1);。

Q：手机号字段设置了“不填”，为什么还会传手机号？

A：请确认后台配置项选择的是 “不填”（中文文字），而不是数字。插件严格遵循配置，不会自动读取用户注册信息。

Q：手机点击“打开支付宝App”没反应？

A：这通常是因为手机浏览器限制了协议跳转。代码已内置降级方案：点击按钮后如果600毫秒内未能成功唤起App，会自动跳转到浏览器备用链接，确保流程可继续。

Q：如何确认插件是否正确调用了API？

A：可以开启魔方系统的开发调试模式，或查看服务器的PHP错误日志。正常调用时，您在创茂平台能看到对应的API请求记录。