常见问题

通用问题

什么是 QuantaPay？

QuantaPay 是一个非托管加密货币支付网关。它允许企业接受 Bitcoin、Ethereum、USDT 以及 30 多种其他加密货币作为支付方式。"非托管"意味着 QuantaPay 永远不会持有您的资金——付款直接进入您的钱包。

费用是多少？

QuantaPay 对每笔成功交易收取固定 0.8% 的手续费，从您的 Credits 余额中扣除。没有月费、设置费或提现费用。

什么是 Credits 系统？

Credits 是您用于支付交易手续费的预付余额。当一笔付款完成时，0.8% 的手续费将从您的 Credits 中扣除。您可以通过仪表盘查看余额。

QuantaPay 安全吗？

是的。QuantaPay 是非托管的——您的资金直接进入您的钱包地址。我们无法访问您的私钥或资金。所有 API 通信使用 HTTPS，Webhook 包含用于验证的密钥。

支持哪些加密货币？

QuantaPay 支持 30 多种加密货币，包括：

• 主流币: BTC, ETH, USDT, USDC, BNB, SOL, TRX
• 山寨币: LTC, DOGE, XRP, BCH, XMR, LINK, SHIB, BAT, ALGO, AVAX, DOT, XLM, XTZ, POL 等
• 稳定币: USDT (ERC-20, TRC-20, BEP-20, TON), USDC
• TON: Toncoin 和 TON 网络上的 USDT
• L2 网络: Base、Arbitrum、Optimism 上的 Ethereum
• 自定义代币: 添加任意 ERC-20 或 BEP-20 代币（Pro 计划）

可以用什么货币定价？

您可以使用 160 多种法定货币（USD、EUR、GBP、JPY、CNY 等）设置结账价格。QuantaPay 使用实时汇率自动将价格转换为客户选择的加密货币。

支付相关

一笔支付需要多长时间？

支付速度取决于加密货币类型：

• Solana: 约 1-2 秒
• Tron (USDT TRC-20): 约 3-10 秒
• Ethereum / ERC-20: 约 30 秒到 3 分钟
• Bitcoin: 约 10-30 分钟（1-3 次确认）

这些时间可能因网络拥堵而有所不同。

如果客户支付金额不足怎么办？

默认情况下，支付金额不足的交易会被标记为"underpaid"且不会完成。您可以在 Settings → Payments → Payment Options 中启用 Accept Underpayments 来自动接受轻微的金额不足。

支付超时时间是多少？

结账会话在 60 分钟 后过期。如果客户在此时间窗口内未完成支付，会话将过期。客户可以创建新的会话重新尝试。

客户可以使用 MetaMask 支付吗？

可以。在 Settings → Payments → Payment Options 中启用 Pay with MetaMask 选项。这会在支付页面上为 Ethereum 兼容的加密货币添加 MetaMask 按钮。

如果支付期间汇率发生变化怎么办？

汇率在客户在支付页面选择加密货币时确定。客户从创建会话开始有 60 分钟的时间完成支付。如果会话过期，可以创建一个新的会话并获取更新后的汇率。

技术问题

为什么我的 Webhook 没有收到通知？

常见原因：

1. URL 错误 — 在 Settings → Payments → Webhook 中验证 Webhook URL。
2. 防火墙阻止 — 如果使用 Cloudflare 或 WAF，请允许 Webhook 端点。
3. 需要 HTTPS — Webhook URL 必须使用 HTTPS。
4. 服务器错误 — 检查服务器日志中 Webhook 端点的 500 错误。
5. 未完成 — Webhook 仅在交易完成（状态 C）时触发。

为什么我的交易一直显示"Pending"？

• 客户可能还没有发送付款。
• 区块链可能拥堵，导致确认缓慢。
• 付款金额可能与预期金额不匹配。
• 确认次数尚未达到您配置的最低要求。

使用 check-transaction 强制重新检查，或等待自动定时任务检查。

我应该使用什么地址格式？

可以在 localhost 上使用 QuantaPay 吗？

您可以从 localhost 发起 API 调用，但 Webhook 需要一个可公开访问的 URL。使用 ngrok 等隧道服务进行本地开发。