WordPress 接入 USDT / USDC 收款：WooCommerce 与 EDD 配置指南
WordPress 商城应把稳定币支付接入原生订单流程。UUGate 提供 WooCommerce 和 Easy Digital Downloads（EDD）插件：前者用于商城结账，后者用于数字商品与付费下载。选择与你现有商店一致的插件，避免仅添加一个付款按钮却没有订单状态同步。
安装前先确认环境
当前插件要求 PHP 8.1+、cURL、HTTPS 和持久订单目录。下载包与配置步骤见插件安装说明。WooCommerce / EDD 已有原生订单及回调验证记录，但自己的平台版本、网络、外网店铺和结账方式仍需验收；Checkout Blocks 的完整浏览器流程不能当成已经全面验证。
凭据和订单文件放在哪里
把 config.example.php 复制到网站公开目录之外，填写 merchant_uid、api_key 和受支持的 asset。设置 UUGATE_CONFIG_FILE 指向该文件，并为 state_dir 创建 PHP 可读写的持久目录；不要使用临时或公开上传目录。不同店铺/测试环境使用不同 store_id，备份时同时保留数据库和订单目录。
启用正确的支付方式
- WooCommerce：上传并启用插件，在“设置 → 付款”开启 UUGate；插件使用店铺的
?wc-api=uugate接收回调。 - EDD：上传并启用插件，在“设置 → 支付”开启 UUGate；回调入口为
?edd-listener=uugate。 - 按配置选择 TRC20-USDT、BEP20-USDT、BEP20-USDC 或 SPL-USDC，并核对付款页显示的网络。
若商店用 USD 计价，需显式接受并设置 usd_at_par=true 的等值计价政策；它不是实时汇率或法币兑换，其他法币会被拒绝。
支付完成如何更新店铺
浏览器跳回店铺不能触发发货或开放下载。插件需验证回调、订单及金额，再更新 WooCommerce / EDD 原生付款状态。验收一次正常付款和同一通知重复投递，确认只有一条付款记录；还要验证未付款订单不能获取付费内容。协议见收款回调。
常见异常与边界
创建请求超时或店铺写入中断时，先按安装说明核对平台与原生订单，再恢复处理，不盲目重建支付单或重放存在部分副作用的操作。当前插件不提供自动退款或循环扣款，EDD 不支持循环订阅。需要自定义业务流程时，可从PHP / Laravel SDK接入，并参考USDT与USDC支持范围。
WHMCS USDT 支付：测试版适配与账单核对
WHMCS USDT支付使用现有 0.1.0 测试适配包，为未付款账单提供支付链接；它不是 WordPress 插件。完整 WHMCS 平台版本兼容尚未实测，也不支持自动续费扣款。下载与安装步骤见插件安装说明，其中包含对应测试包的入口。
安装后在 WHMCS 支付接口中启用 UUGate，按当前安装说明配置服务端凭据及持久订单目录。回调路径为 /modules/gateways/callback/uugate.php，插件根据 WHMCS 系统 URL 生成。
回调按账单当前未付余额核对；付款期间发生部分支付、取消或切换网关，应人工复核，不自动重复入账。上线前在自己的平台验证链接生成、合法付款、重复通知及账单变化，不能把接口模拟视为生产兼容验收。