快速开始

在 5 分钟内接收您的第一笔加密货币支付。

前提条件

• 在 cloud.quantapay.app 注册的 QuantaPay 账户
• 至少一个加密货币钱包地址（例如 Bitcoin 或 Ethereum 地址）

第 1 步：注册并登录

1. 前往 cloud.quantapay.app 创建您的账户。
2. 登录后，您将看到 Hub 仪表盘 — 这是管理支付的中央控制台。

第 2 步：添加您的钱包地址

导航至 设置 → 支付。您会在页面顶部看到 加密货币地址 部分。

输入您希望接收支付的钱包地址。只有配置了地址的加密货币才会作为支付选项展示给客户。

最常见的配置：

• Bitcoin (BTC) — bc1... 或 1... 或 3... 格式
• USDT (TRC-20) — T... 格式（手续费低，是稳定币支付的热门选择）
• Ethereum (ETH) — 0x... 格式

您可以稍后添加更多加密货币。完整列表请参阅 加密货币地址。

第 3 步：配置 Webhook（可选但推荐）

仍然在 设置 → 支付 页面，向下滚动到 Webhook 部分。

1. 输入您的 Webhook URL — 这是您服务器上用于接收支付通知的端点。
2. Webhook 密钥 会自动生成。请妥善保管 — 您将通过检查 JSON 载荷中的 key 字段来验证传入的 Webhook。

Webhook URL: https://yoursite.com/webhook/quantapay
Webhook Secret: (auto-generated alphanumeric string)

即使没有 Webhook，您仍然可以通过 API 查询支付状态，但 Webhook 可以提供实时通知。

第 4 步：获取您的 API 密钥

前往 设置 → 账户。您的 API 密钥 会显示在此处。复制它 — 所有 API 调用都需要用到。

第 5 步：创建您的第一笔支付

发起一个简单的 API 调用来创建结账会话：

curl -X POST https://cloud.quantapay.app/api.php \
  -d "function=create-checkout-session" \
  -d "api-key=YOUR_API_KEY" \
  -d "price=10.00" \
  -d "currency=USD"

响应：

{
  "success": true,
  "response": {
    "session_id": "cs_a1b2c3d4e5f6a1b2c3d4",
    "payment_url": "https://cloud.quantapay.app/pay.php?session=cs_a1b2c3d4e5f6a1b2c3d4",
    "expires_at": "2026-03-08T11:00:00+00:00"
  }
}

将您的客户重定向到 payment_url。他们将：

1. 看到可用的加密货币列表
2. 选择首选的币种
3. 扫描二维码或复制地址
4. 发送付款
5. 等待区块链确认

第 6 步：接收支付通知

当支付在区块链上确认后，QuantaPay 将：

1. 发送 Webhook 到您配置的 URL（如果已设置）
2. 更新交易状态 在您的仪表盘中
3. 重定向客户 到您的成功 URL（如果已配置）

您也可以通过编程方式查询状态：

curl -X POST https://cloud.quantapay.app/api.php \
  -d "function=get-checkout-session" \
  -d "api-key=YOUR_API_KEY" \
  -d "session_id=cs_a1b2c3d4e5f6a1b2c3d4"

下一步

• [加密货币地址](/docs/getting-started/payment-settings/cryptocurrency-addresses/) — 添加更多币种
• [Webhook 配置](../02-payment-settings/02-webhook-configuration.md) — 设置支付通知
• [API 参考：交易](..//docs/api-reference/transactions-api/) — 完整 API 文档
• [WordPress / WooCommerce](..//docs/integrations/wordpress-plugin/) — 使用我们的 WordPress 插件

工作原理：非托管模式

QuantaPay 是非托管的 — 我们从不持有您的资金。当客户付款时：

1. 客户将加密货币直接发送到您的钱包地址
2. QuantaPay 监控区块链上的传入交易
3. 确认后，QuantaPay 通过 Webhook 通知您

您的资金直接进入您的钱包。没有中间商，没有提款延迟。