WordPress / WooCommerce

使用官方 QuantaPay Payment 插件在您的 WooCommerce 商店中接受加密货币支付。

系统要求

• WordPress 5.8+
• WooCommerce（任何较新版本）
• PHP 7.4+（推荐 PHP 8.x）
• 一个 QuantaPay Cloud 账户（cloud.quantapay.app）

安装

从 WordPress 插件目录安装

1. 在 WordPress 后台进入 插件 → 安装新插件。
2. 搜索 "QuantaPay Payment"。
3. 点击 立即安装，然后点击 启用。

手动安装

1. 从 wordpress.org/plugins/quantapay-payment 下载插件。
2. 将 quantapay-payment 文件夹上传到 /wp-content/plugins/。
3. 在 插件 → 已安装的插件 中启用插件。

配置

第 1 步：获取凭证

从您的 QuantaPay Cloud 仪表盘中获取：

1. API Key — 在 Settings → Account 中找到
2. Webhook Secret Key — 在 Settings → Payments → Webhook 中找到

第 2 步：在 WordPress 中输入凭证

1. 在 WordPress 侧边栏中找到 QuantaPay 菜单。
2. 粘贴您的 Cloud API Key 和 Webhook Secret Key。
3. 保存设置。

第 3 步：配置 Webhook URL

1. 插件会生成一个 webhook URL：https://yoursite.com/wp-json/quantapay/webhook
2. 复制此 URL 并粘贴到 Cloud → Settings → Payments → Webhook URL 中。

第 4 步：启用支付网关

前往 WooCommerce → Settings → Payments → QuantaPay 并启用。

WooCommerce 设置

插件直接在 WooCommerce 支付页面中添加设置项：

快速配置

QuantaPay 侧边栏菜单提供快速配置选项卡，您可以在其中管理：

• 钱包地址
• 默认货币
• 感谢页面跳转 URL
• 结账文案/提示信息

在此处所做的更改会同步到您的 QuantaPay Cloud 设置。

Block Checkout 支持

插件完全支持 WooCommerce Block Checkout（基于 React 的新版结账页面）。经典结账和 Block 结账共享相同的配置，并显示加密货币图标条（BTC, ETH, USDT, USDC, BNB）。

支付流程

1. 客户在结账时选择"Pay with crypto"。
2. WooCommerce 创建订单并调用 QuantaPay Checkout Session API。
3. 客户被重定向到 QuantaPay 支付页面。
4. 客户选择加密货币，扫描二维码并发送付款。
5. 区块链确认后，QuantaPay 向您的 WordPress 网站发送 webhook。
6. 插件将 WooCommerce 订单状态更新为"处理中"或"已完成"。
7. 客户被重定向到 WooCommerce 感谢页面。

仪表盘同步

在 WordPress 中的 QuantaPay 管理页面，您可以：

• 查看钱包余额
• 浏览最近 100 笔交易
• 检查调试日志
• 查看欠付和过期发票通知

安全性

• Webhook 通过共享密钥签名进行验证。
• 敏感设置（API 密钥）在存储时加密。
• HMAC-SHA256 签名保护 Checkout Session 创建免受篡改。
• 调试日志自动隐藏敏感信息。

Cloudflare / WAF 配置

如果您的网站位于 Cloudflare 或其他 WAF 后面，请放行 webhook 端点：

1. 创建防火墙/WAF 规则，匹配 URI contains /wp-json/quantapay。
2. 将操作设置为 Allow 或 Bypass Security。
3. 确保该 URL 的安全级别未设置为"I'm Under Attack"模式。

支持的语言

插件内置 9 种语言的翻译：

• 英语、简体中文、西班牙语、巴西葡萄牙语、俄语、法语、日语、韩语、德语

定价

QuantaPay 对每笔成功的加密支付收取固定 0.8% 的手续费。无月费或提现费用。