跳转到主要内容
Stablecoin Account API 发布方声明 充值是入金(on-ramp)动作:你的账户通过 UQPAY 为你管理的充值地址接收加密货币。你按资产-网络组合申请地址,把它提供给付款方,系统会在交易确认时为你的余额入账并发送通知。
前置条件

步骤 1:获取充值地址

调用 Deposit Wallet Address,传入资产和网络。首次调用会生成地址,后续调用返回同一个地址,可以放心重复调用。
响应:
wallet_address(或托管的 qr_code)连同 minimum_deposit 一并展示给付款方。
该地址只接受指定网络上的指定资产。以其他代币形式、或经其他网络发送的资金无法自动入账。请在你的界面中把这一点提示到位。
如需审计账户下生成过的所有地址,可分页调用 List Deposit Addresses,按需用 assetnetwork 过滤。

步骤 2:处理充值 webhook

系统检测到入账交易后会创建充值订单,并向你的端点推送充值 webhook 事件: 事件中的 source_id 就是充值 order_iddata 携带订单内容,包括付款方的 from_address 和链上 txid
如果事件的 data 包含 "need_travel_rule": true,该笔充值会被暂缓,直到你提交付款方(发起方)信息 —— 参见充值的 Travel Rule。无需处理时该字段不会出现。

步骤 3:查询充值订单

List Deposits 对账,或用 Retrieve Deposit 查询单个订单:
每个充值订单包含: order_status 变为 Success 后,金额会出现在钱包的 available_balance 中 —— 可通过 Retrieve Asset 核对。