前置条件
- 通过
x-auth-token请求头发送的 API token - 想要接收的资产和网络,从 List Supported Assets and Networks 中选择
deposit_enabled: true的组合
步骤 1:获取充值地址
调用 Deposit Wallet Address,传入资产和网络。首次调用会生成地址,后续调用返回同一个地址,可以放心重复调用。wallet_address(或托管的 qr_code)连同 minimum_deposit 一并展示给付款方。
如需审计账户下生成过的所有地址,可分页调用 List Deposit Addresses,按需用 asset 或 network 过滤。
步骤 2:处理充值 webhook
系统检测到入账交易后会创建充值订单,并向你的端点推送充值 webhook 事件:
事件中的
source_id 就是充值 order_id;data 携带订单内容,包括付款方的 from_address 和链上 txid。
如果事件的
data 包含 "need_travel_rule": true,该笔充值会被暂缓,直到你提交付款方(发起方)信息 —— 参见充值的 Travel Rule。无需处理时该字段不会出现。步骤 3:查询充值订单
用 List Deposits 对账,或用 Retrieve Deposit 查询单个订单:
当
order_status 变为 Success 后,金额会出现在钱包的 available_balance 中 —— 可通过 Retrieve Asset 核对。
相关页面
- Deposit Wallet Address API
- List Deposits API
- 充值 webhook
- 充值的 Travel Rule ——
need_travel_rule为true时 - 管理资产余额

