Riskified for WooCommerce 使用指南

Riskified for WooCommerce 将 WooCommerce 订单、Adyen 信用卡授权结果、退款、取消和履约状态同步到 Riskified。当前版本主要适配 integration-adyen-woocommerce 插件提供的 woosa_adyen_card 信用卡支付方式。

1. 使用要求

• WordPress 5.8 或更高版本。
• PHP 7.4 或更高版本。
• WooCommerce。
• integration-adyen-woocommerce。
• 已启用 Adyen 信用卡支付方式 woosa_adyen_card。
• 可用的 Riskified Shop Domain 和认证 Token。

建议先在测试站或 Riskified Sandbox 中完成授权成功、授权失败、3DS、退款和订单完成流程验证，再用于正式订单。

2. 安装与启用

1. 在 WordPress 后台进入“插件 > 安装插件 > 上传插件”。
2. 选择完整的 Riskified for WooCommerce ZIP 文件并安装。
3. 确认 WooCommerce 和 integration-adyen-woocommerce 已启用。
4. 启用“Riskified for WooCommerce”。
5. 进入“WooCommerce > 设置 > Riskified”完成配置。

3. 配置 Riskified

在“WooCommerce > 设置 > Riskified”中填写：

• Riskified Shop Domain：Riskified 商户侧使用的店铺域名。
• Riskified Vendor Name：发送订单数据时使用的商家名称。
• Riskified Brand：发送商品和支付信息时使用的品牌。
• Riskified Auth token：Riskified API 认证 Token。
• Sandbox Environment：测试期间启用，正式上线前根据 Riskified 环境切换。
• Observation mode：启用时只记录 Riskified 返回结果，不因拒绝结果阻止客户下单。

认证 Token 属于敏感信息。只应由有权限的管理员配置，不要出现在截图、工单或公开日志中。

4. 验证结账与风控流程

完成配置后，使用测试订单依次检查：

1. 选择 Adyen 信用卡支付方式并提交订单。
2. 确认订单创建后已向 Riskified 发送 decide 请求。
3. 模拟 Adyen 最终授权成功，确认向 Riskified 同步成功决策。
4. 模拟 Refused、Error 或 Cancelled，确认同步失败决策。
5. 验证 3DS 的 RedirectShopper、IdentifyShopper 和 ChallengeShopper 中间态不会被误判为最终结果。

插件使用 resultCode + pspReference 生成本地同步键，避免旧兼容 Hook 与新版官方 Hook 对同一授权结果重复同步。

5. 订单状态同步

插件按以下规则同步 WooCommerce 订单：

• 创建订单：发送 decide。
• Adyen 最终授权成功：发送 decision。
• Adyen 最终授权失败：发送 denied。
• 订单进入“已完成”：发送 fulfill。
• 全额或部分退款：发送 refund。
• 订单进入“已取消”：发送 cancel。

授权结果以 Adyen 最终状态为准。3DS、跳转和挑战等中间状态会等待后续最终结果。

6. 卡片数据说明

为满足 Riskified 风控请求，插件会保存卡号前 6 位、卡号后 4 位、卡品牌和持卡人姓名等字段。数据来自 Adyen 前端组件，并写入订单 Meta；已保存卡片场景会按用户和卡片标识读取对应数据。

请确保站点的隐私政策、数据保留策略和管理员权限符合业务所在地的适用要求。