跳转到主要内容
本指南带您完成使用 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 生成地址

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

在哪里找到您的 walletId 和 API 密钥

  1. 在控制台中前往您的主钱包
  2. 向下滚动到 API Config 部分
  3. 点击显示图标(您需要通过 2FA 验证)
  4. 复制您的 API Key 和 Wallet ID

metadata 字段

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

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

自动归集

当自动归集启用(disableAutoSweep: false)时,存入子地址的资金会自动合并到您的主钱包中。这让资金管理保持简单——所有资金集中在一处,您在自己的数据库中跟踪用户余额。
要使自动归集正常工作,您的主钱包必须持有足够的原生代币来支付 Gas 费用。请在钱包概览页面找到主钱包的充值地址,并向其发送测试网代币。
测试网 Gas 代币水龙头: 测试网稳定币水龙头:

无 Gas 交易

当 enableGaslessWithdraw: true 时,您的用户可以从其地址发送稳定币,而无需持有任何原生代币。您的主钱包代为支付 Gas 费用。这消除了加密货币用户引导中最大的体验障碍。

全局设置默认值

您无需逐个配置每个地址,而是可以为整个主钱包设置默认值:
  1. 前往您的主钱包
  2. 点击 Configurations
  3. 设置 disableAutoSweep 和 enableGaslessWithdraw
地址级别的配置会覆盖主钱包配置。仅在需要例外情况时使用地址级别配置。

第五步:配置 Webhook

Blockradar 使用 webhook 在区块链事件发生时通知您的后端——存款、提款、归集等。请在测试交易之前完成此设置。

注册您的 Webhook 端点

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

在后端处理 Webhook

常见 Webhook 事件

完整 Webhook 参考

查看所有事件类型、负载结构、重试逻辑和 HMAC 验证。

第六步:处理存款事件

当用户向其地址发送 USDC 时,Blockradar 会向您的 webhook 端点触发 deposit.success 事件。

示例负载

处理方式

1

识别用户

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

读取金额

使用 data.amountPaid 确定存款金额。如需收取存款手续费,请在保存前从该值中扣除。
3

更新余额

在数据库中为用户余额记账。如果启用了自动归集,资金已位于您的主钱包中。

您构建了什么

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

下一步

发送付款

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

添加 AML 筛查

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

探索兑换

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

上线生产

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