WordPress KYC 插件：WooCommerce 年龄验证

​

前提条件

• WordPress 6.0 或更高版本
• PHP 7.4 或更高版本
• 一个 Didit Console 账户

​

步骤 1 获取您的 Didit 凭证

1. 在 business.didit.me 注册或登录
2. 前往 API & Webhooks，复制您的 API Key
3. 前往 Workflows，创建或选择一个工作流，并复制 Workflow ID

​

步骤 2 安装插件

1. 从 0.3.4 发布版本 下载 didit-verify-0.3.4.zip
2. 在 WordPress 后台，前往 Plugins → Add New → Upload Plugin
3. 选择下载的 ZIP 文件，然后点击 Install Now
4. 点击 Activate

​

步骤 3 配置插件

​

选择模式

​

配置会话选项（仅限 API 模式）

• Vendor Data：将每次验证关联到 Didit 控制台中的特定用户，以便您追踪是谁完成了验证。默认值为 WordPress 用户 ID（例如 wp-42）。您也可以选择 User Email、自定义前缀，或将其禁用。
• Callback URL：验证完成后用户被重定向到的您网站上的页面。Didit 会将 verificationSessionId 和 status 作为查询参数附加到该地址。
• Callback Method：决定由哪台设备处理重定向：initiator（发起验证的设备）、completer（完成验证的设备）或 both。
• Language：从 54 种语言中选择，或让其根据浏览器自动检测。

​

配置显示选项

• Display Mode：Modal（弹出式覆盖层）或 Embedded（嵌入页面内）
• Close Button：显示或隐藏弹窗上的 X 按钮
• Exit Confirmation：关闭时显示 “Are you sure?” 对话框
• Auto-close：验证完成后自动关闭弹窗
• Debug Logging：将 SDK 事件记录到浏览器控制台（用于排查问题）

​

自定义按钮

• 按钮文字和成功提示文字
• 背景颜色和文字颜色
• 圆角半径、内边距和字体大小

​

步骤 4 将验证添加到您的网站

​

适用于 WooCommerce 商店

1. 在 Settings → Didit Verify → WooCommerce 中，勾选 Require identity verification at checkout
2. 选择验证部分的显示位置：
   • 结账页面顶部
   • 账单信息之后
   • 订单备注之后
   • “下单”按钮之前（推荐）
3. 可选择设置 Product Scope：所有商品（默认）、仅限选定商品，或除选定商品外的所有商品。 在商品编辑器中，于 Product data → Advanced 下勾选 Didit verification 复选框，即可标记需要验证的商品。 购物车中只要包含至少一件需要验证的商品，就必须完成验证。 该范围同时适用于结账模式和购买后模式。
4. 可选择在 Settings → Didit Verify → WooCommerce 下编辑 Section Title、Checkout Message 和 Post-purchase Message；留空的字段将使用默认文字。
5. 可选择启用 Send Billing Data，自动将客户的姓名、邮箱、电话和地址发送至 Didit，用于预填和交叉验证。

​

适用于任何 WordPress 页面

[didit_verify]

[didit_verify text="Verify Now" success_text="Done!"]

[didit_verify mode="embedded"]

​

第 5 步 仅向已验证用户开放内容(可选)

[didit_gate]
This content is only visible to verified users.
[/didit_gate]

[didit_gate message="Please verify to continue."]Secret content here.[/didit_gate]

[didit_status]

​

检查验证状态

​

故障排除

​

安全性

1. CSRF nonce：请求必须来自您的 WordPress 站点
2. 登录要求：只有已注册用户才能创建会话（可配置）
3. 速率限制：每位用户每小时 10 个会话，访客每个 IP 每小时 3 个
4. 输入清理：所有字段均已列入白名单，并在服务器端进行清理

​

面向开发者

​

PHP 钩子

// When a user completes verification
add_action('didit_verification_completed', function ($user_id, $session_id, $status) {
    // Update CRM, send email, grant access, etc.
}, 10, 3);

// When a user cancels verification
add_action('didit_verification_cancelled', function ($user_id, $session_id) {
    // Log cancellation
}, 10, 2);

// When a session is created server-side
add_action('didit_session_created', function ($url, $user_id, $vendor_data) {
    // Log, notify, etc.
}, 10, 3);

​

JavaScript 事件

document.addEventListener('didit:complete', function (e) {
    console.log('Result:', e.detail); // { type, session }
});

​

在 PHP 中检查验证

$is_verified = Didit_Verify::init()->is_user_verified($user_id);

​

资源

• 插件源代码（GitHub）
• Didit API 文档
• Didit 控制台
• 创建会话 API 参考