边读边构建。完成后您将拥有一个可运行的稳定币支付流程。
您将构建什么
完成本指南后,您将拥有:- 一个 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 交易
当enableGaslessWithdraw: true 时,您的用户可以从其地址发送稳定币,而无需持有任何原生代币。您的主钱包代为支付 Gas 费用。
第五步:配置 Webhook
Blockradar 使用 webhook 在区块链事件发生时通知您的后端——存款、提款、归集等。注册您的 Webhook 端点
- 在控制台中前往您的主钱包
- 点击开发者 → Webhook
- 输入您的后端端点 URL(必须是
POST端点)
在后端处理 Webhook
常见 Webhook 事件
第六步:处理存款事件
示例负载
处理方式
1
识别用户
从负载中提取
metadata.user_id,将存款映射到数据库中的用户。2
读取金额
使用
data.amountPaid 确定存款金额。3
更新余额
在数据库中为用户余额记账。
您构建了什么
现在您拥有一个完整的稳定币支付流程:- 测试网上的主钱包
- 通过 metadata 与用户绑定的子地址
- 将资金合并到金库的自动归集
- 为用户消除摩擦的无 Gas 交易
- 实时更新余额的 webhook 处理器
下一步
发送付款
以编程方式向用户或合作伙伴发送稳定币。
添加 AML 筛查
在发送或接收资金前筛查地址。
探索兑换
让用户通过单个 API 调用在稳定币之间兑换。
上线生产
在控制台启用 Live 模式,开始接受真实资金。

