m2pool_payment/integration/wordpress/INSTALL.md

安装指南

前置要求

1. WordPress 5.0 或更高版本
2. WooCommerce 3.0 或更高版本
3. PHP 7.4 或更高版本
4. M2Pool 支付系统后端（Go 服务）

安装步骤

1. 安装 WordPress 插件

1. 将 integration/wordpress 文件夹复制到 WordPress 的插件目录：

   wp-content/plugins/m2pool-eth-payment/
   

2. 在 WordPress 后台激活插件：

   • 进入 插件 > 已安装的插件
   • 找到 "M2Pool ETH Payment Gateway"
   • 点击 "启用"

2. 配置插件

1. 进入 设置 > M2Pool ETH 支付

2. 配置以下选项：

   • API 地址: 支付系统的 API 地址（如果使用 API Bridge，则为 http://localhost:8080）
   • API 密钥: 与后端系统的 msgKey 对应的密钥
   • 接收地址: 用于接收支付的以太坊地址
   • 监听间隔: 检查支付状态的间隔时间（建议 30-60 秒）

3. 保存设置

3. 配置 WooCommerce 支付网关

1. 进入 WooCommerce > 设置 > 支付

2. 找到 "M2Pool ETH 支付"

3. 点击 "管理"

4. 启用支付方式并配置：

   • 标题: 客户看到的支付方式名称
   • 描述: 支付方式说明
   • 发送地址: 发送支付的地址（可选）
   • 接收地址: 接收支付的地址
   • 链名称: 选择 ETH
   • 代币符号: 选择 ETH 或 USDT

5. 保存更改

4. 设置 API Bridge（可选）

如果您的后端系统只支持 RabbitMQ，需要运行 API Bridge 服务：

1. 进入 integration/wordpress/api-bridge 目录

2. 安装依赖：

   go mod download
   

3. 编译：

   go build -o api-bridge main.go
   

4. 运行：

   ./api-bridge
   

5. 在 WordPress 插件设置中，将 API 地址设置为 http://localhost:8080

测试支付

1. 在 WooCommerce 创建一个测试订单
2. 选择 "ETH 支付" 作为支付方式
3. 完成订单后，您会看到支付说明页面
4. 向显示的地址支付指定金额的 ETH
5. 系统会自动检测支付并更新订单状态

Webhook 配置（推荐）

为了实时接收支付状态更新，建议配置 Webhook：

1. 在 WordPress 插件设置页面找到 Webhook URL
2. 将此 URL 配置到您的支付系统中
3. 当支付状态更新时，系统会自动通知 WordPress

Webhook URL 格式：

https://your-site.com/wp-json/m2pool-eth/v1/webhook

故障排除

支付状态不更新

1. 检查 API 地址是否正确
2. 检查 API 密钥是否匹配
3. 查看 WordPress 错误日志
4. 确认后端服务正常运行

无法创建支付请求

1. 检查 API Bridge 是否运行（如果使用）
2. 检查 RabbitMQ 连接是否正常
3. 查看后端服务日志

订单状态不更新

1. 检查定时任务是否运行：
   • 进入 工具 > 计划任务
   • 查找 m2pool_eth_check_payments
2. 手动触发支付检查（通过 AJAX）
3. 检查数据库表 wp_m2pool_eth_payments 中的数据

数据库表

插件会自动创建以下数据库表：

• wp_m2pool_eth_payments: 存储支付记录

您可以通过 phpMyAdmin 或 WordPress 数据库工具查看和管理这些表。

支持

如有问题，请查看：

• README.md - 详细文档
• WordPress 错误日志
• 后端服务日志