Skip to main content
本指南带您完成使用 Blockradar 接受稳定币存款所需的一切,从账户设置到处理第一个 webhook 事件。单个开发者可以在 2 小时内完成集成并上线。
边读边构建。完成后您将拥有一个可运行的稳定币支付流程。

您将构建什么

完成本指南后,您将拥有:
  • 一个 Blockradar 账户和测试网上的主钱包
  • 生成并与用户绑定的子地址
  • 接收实时存款事件的 webhook 处理器
  • 存款后更新用户余额的模式

第一步:创建账户

1

注册

访问 dashboard.blockradar.co/signup 并完成注册流程。不到 60 秒即可完成。
2

检查 Live 模式

在控制台右上角您会看到一个 Live 模式开关。默认关闭,这意味着所有操作在测试网上运行,这是一个没有真实资金的安全沙盒。跟随本指南时请保持关闭状态。

第二步:创建主钱包

什么是主钱包?

主钱包是您稳定币基础设施的基础。将其视为您的金库——它控制您为用户创建的所有子地址。每个主钱包绑定到一条特定的区块链,因此如果您想支持 Ethereum、Base 和 BNB Chain 上的存款,需要为每条链单独创建一个主钱包。

创建您的第一个钱包

1

前往钱包页面

在控制台中点击创建主钱包
2

选择网络

选择 **Base Sepolia(测试网)**来跟随本指南。
3

命名您的钱包

起一个名字如 base-testnet,然后点击创建

第三步:为用户生成地址

什么是子地址?

当用户注册您的应用并需要接收稳定币时,他们需要一个钱包地址——类似于银行账号,但在区块链上。在 Blockradar 中,这些称为子地址。它们在您的主钱包下生成,并继承其网络配置。
在任何 EVM 兼容链(Base、Ethereum、BNB Chain 等)上生成的地址可在所有 EVM 链上使用。一个地址覆盖所有 EVM 网络。

通过 API 生成地址

当用户在您的平台注册时调用此端点:

metadata 字段

metadata 对象是此请求中最重要的部分之一。您在此处附加的任何内容都将包含在 Blockradar 为该地址发送的每个 webhook 中。这就是您的后端识别交易属于哪个用户的方式。 最佳实践: 始终在 metadata 中包含 user_id,以便将每笔存款直接映射到数据库中的用户。

第四步:配置自动归集和无 Gas 交易

自动归集

当自动归集启用(disableAutoSweep: false)时,存入子地址的资金会自动合并到您的主钱包中。
要使自动归集正常工作,您的主钱包必须持有足够的原生代币来支付 Gas 费用。
测试网 Gas 代币水龙头:

无 Gas 交易

enableGaslessWithdraw: true 时,您的用户可以从其地址发送稳定币,而无需持有任何原生代币。您的主钱包代为支付 Gas 费用。

第五步:配置 Webhook

Blockradar 使用 webhook 在区块链事件发生时通知您的后端——存款、提款、归集等。

注册您的 Webhook 端点

  1. 在控制台中前往您的主钱包
  2. 点击开发者 → Webhook
  3. 输入您的后端端点 URL(必须是 POST 端点)

在后端处理 Webhook

常见 Webhook 事件


第六步:处理存款事件

示例负载

处理方式

1

识别用户

从负载中提取 metadata.user_id,将存款映射到数据库中的用户。
2

读取金额

使用 data.amountPaid 确定存款金额。
3

更新余额

在数据库中为用户余额记账。

您构建了什么

现在您拥有一个完整的稳定币支付流程:
  • 测试网上的主钱包
  • 通过 metadata 与用户绑定的子地址
  • 将资金合并到金库的自动归集
  • 为用户消除摩擦的无 Gas 交易
  • 实时更新余额的 webhook 处理器

下一步

发送付款

以编程方式向用户或合作伙伴发送稳定币。

添加 AML 筛查

在发送或接收资金前筛查地址。

探索兑换

让用户通过单个 API 调用在稳定币之间兑换。

上线生产

在控制台启用 Live 模式,开始接受真实资金。