WooCommerce 实名认证使用文档

1. 使用前准备

请先确认：

• WordPress 和 WooCommerce 已正常运行。
• 服务器使用 PHP 7.0 或更高版本，并启用 JSON 与 OpenSSL 扩展。
• 如需联网实名认证，已在阿里云市场开通对应接口并取得 App Code, 并且余额足够。
• 商店隐私政策已说明姓名、证件号码的用途和保存方式。

2. 安装插件

1. 在 WordPress 后台进入“插件 > 安装插件 > 上传插件”。
2. 选择发布包 ZIP 并完成安装。
3. 启用“WooCommerce 实名认证”。
4. 使用测试订单确认结账页显示“证件类型”“真实姓名”和“证件号码”。

3. 配置联网实名认证

1. 进入“WooCommerce > 设置 > 高级 > 身份认证”。
2. 在“App Code”中填写阿里云市场提供的 App Code。
3. 勾选“启用实名认证”。
4. 保存更改。

联网认证关闭时，插件仍会要求填写实名字段，并检查中国居民身份证号码的长度和校验码；联网认证开启后，身份证订单还会核验姓名与身份证是否匹配。

建议先在测试环境验证接口。App Code 错误、接口余额不足、服务器无法访问接口或接口返回异常，都可能阻止身份证订单结账。

4. 配置商品限购

1. 编辑需要限制的 WooCommerce 商品。
2. 在“商品数据 > 高级”中找到“每个身份证只能购买一次”。
3. 勾选该选项并更新商品。

顾客再次使用同一身份证购买该商品时，结账页会提示“此身份证已经购买过这个商品了”。订单退款、取消或失败后，插件会释放对应记录，顾客可以再次购买。

5. 顾客结账流程

顾客需要选择证件类型，并填写真实姓名和证件号码：

• 选择“身份证”时，号码必须是有效的 18 位中国居民身份证号码。
• 选择“护照”时，不执行中国居民身份证号码格式校验。
• 启用联网认证后，身份证的姓名与号码必须通过接口核验。

证件号码会加密保存。加密依赖当前 WordPress 安全密钥；迁移网站时应保留 wp-config.php 中原有的密钥和盐值，否则历史证件号码可能无法正确解密显示。

6. 查看订单实名信息

在 WooCommerce 后台打开订单，在收货地址信息下方可以查看：

• 证件类型
• 真实姓名
• 证件号码

这些信息属于敏感个人数据。请仅向确有业务需要的后台账号开放订单访问权限，不要通过截图、导出文件或日志随意传播。

7. 插件更新

有新版本时，WordPress 插件管理页面会显示更新提示。更新前建议备份数据库和插件文件，并先在测试环境确认结账流程、联网认证和商品限购正常。

已安装站点不需要连接代码仓库，也不需要配置代码仓库访问凭据。

8. 故障排查

结账页没有实名字段

确认 WooCommerce 已启用、当前页面使用标准 WooCommerce 结账流程，并检查主题或结账编辑插件是否移除了 woocommerce_before_order_notes 挂钩。

身份证号码一直提示错误

确认号码为 18 位，末位校验字符如为字母应使用大写 X，并检查复制内容中是否包含空格。

联网实名认证无法通过

依次检查真实姓名和身份证号码、App Code、接口套餐余额、服务器外网连接以及阿里云接口状态。临时关闭联网认证可用于区分本地格式校验与远程接口故障，但正式业务是否允许关闭应由你的合规要求决定。

历史证件号码无法显示

检查网站迁移或环境切换时是否更换了 WordPress 的 NONCE_KEY 或 SECURE_AUTH_SALT。插件使用这些值派生加密密钥。

已取消订单仍提示不能购买

确认订单状态确实已变为“已取消”“失败”或已执行退款。若状态由第三方流程自定义，可能不会触发插件当前监听的释放动作。