概览

QuantaPay 支付插件已在 WordPress.org 上线，可为 WooCommerce（经典结账、Blocks、HPOS）与 Easy Digital Downloads 提供非托管加密网关。本文将安装、FAQ 与排障整合为一份中文指南。

使用要求

• WordPress 5.8+，WooCommerce 6.0+ 或 EDD 3.0+，PHP 7.4+（建议 8.x）。

• 服务器能够访问 cloud.quantapay.app 以验证 API/Webhook。

• 已开通的 QuantaPay Cloud 账号（含 API Key 与 Webhook Secret）。

• WAF/Cloudflare 需允许 https://yoursite.com/wp-json/quantapay/webhook。

安装步骤

1）从 WordPress.org 或内部镜像下载最新 quantapay-payment.zip。

2）在 WordPress 仪表盘进入 插件 → 安装插件 → 上传插件，上传压缩包并安装。

3）启用 “QuantaPay Payment”，即可看到设置 → QuantaPay 页面。

配置凭证与结账体验

• 进入 设置 → QuantaPay，粘贴 Cloud API Key 与 Webhook Secret 并保存，页面会显示自动生成的 Webhook URL。

• WooCommerce：打开 WooCommerce → 设置 → 支付 → QuantaPay（或 Payments → Manage）开启网关，自定义标题、描述与默认币种。

• Quick Config：在同一设置页同步钱包地址、感谢页跳转、提示文案与日志开关，无需修改代码。

• Easy Digital Downloads：在 Downloads → Settings → Payment Gateways → QuantaPay 启用即可。

Webhook 与防火墙

1）在 QuantaPay Cloud → Settings → Webhooks 中粘贴 WordPress 页面显示的 URL 并校验 Secret。

2）若站点在 Cloudflare/WAF 之后，创建 Hostname = yoursite.com 且 URI 包含 /wp-json/quantapay 的规则，动作设为 Allow/Bypass，可选按 “QuantaPay-Webhook” User-Agent 过滤。

3）避免对该路径启用 “I’m Under Attack”，确保回调先到达 WordPress，再由插件验签。

测试与排障

• 在 WooCommerce/EDD 创建 1 美元测试订单并选择 QuantaPay，确认托管页显示正确金额。

• 在 Cloud 将发票设为 Paid 或完成真实支付，WordPress 订单应从 Pending 变为 Processing/Completed，并写入链上哈希说明。

• 若订单未更新，请检查 API Key/Webhook Secret 是否匹配、Cloudflare 是否放行、以及 wp-content/uploads/quantapay/quantapay-debug.log（仅测试时开启日志）。

• 使用 设置 → QuantaPay 的 “Test Cloud API” 按钮可快速验证凭证并刷新钱包快照。

卸载与重新部署

停用插件不会删除配置；点击删除才会清理云端凭证与日志偏好，但不会修改现有订单。建议在生产环境替换版本前备份。

常用链接

• WordPress 插件页

• QuantaPay Cloud 控制台

• Docs 文档目录

• 技术支持：[email protected]

获取帮助

仍需帮助？发送邮件至 [email protected]，附上站点域名和订单号。