边读边构建。完成后您将拥有一个可运行的稳定币支付流程。
您将构建什么
完成本指南后,您将拥有:- 一个 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 密钥
- 在控制台中前往您的主钱包
- 向下滚动到 API Config 部分
- 点击显示图标(您需要通过 2FA 验证)
- 复制您的 API Key 和 Wallet ID
metadata 字段
metadata 对象是此请求中最重要的部分之一。您在此处附加的任何内容都将包含在 Blockradar 为该地址发送的每个 webhook 中——存款、提款、归集。这就是您的后端识别交易属于哪个用户的方式。
user_id,以便将每笔存款直接映射到数据库中的用户,无需任何额外查询。
第四步:配置自动归集和无 Gas 交易
自动归集
当自动归集启用(disableAutoSweep: false)时,存入子地址的资金会自动合并到您的主钱包中。这让资金管理保持简单——所有资金集中在一处,您在自己的数据库中跟踪用户余额。
测试网 Gas 代币水龙头:
测试网稳定币水龙头:
无 Gas 交易
当enableGaslessWithdraw: true 时,您的用户可以从其地址发送稳定币,而无需持有任何原生代币。您的主钱包代为支付 Gas 费用。这消除了加密货币用户引导中最大的体验障碍。
全局设置默认值
您无需逐个配置每个地址,而是可以为整个主钱包设置默认值:- 前往您的主钱包
- 点击 Configurations
- 设置
disableAutoSweep和enableGaslessWithdraw
地址级别的配置会覆盖主钱包配置。仅在需要例外情况时使用地址级别配置。
第五步:配置 Webhook
Blockradar 使用 webhook 在区块链事件发生时通知您的后端——存款、提款、归集等。请在测试交易之前完成此设置。注册您的 Webhook 端点
- 在控制台中前往您的主钱包
- 点击开发者 → Webhook
- 输入您的后端端点 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 模式,开始接受真实资金。

