发起提现

Stablecoin Account API 发布方声明提现是出金（off-ramp）动作：把加密货币从你的余额发送到外部地址。目标地址应先登记到地址簿中 —— 条目在创建时会进行风险评估，经特定通道的目标地址还需要先补齐 Travel Rule 数据，提现才会被受理。

前置条件

通过 x-auth-token 请求头发送的 API token
提现币种有足够的 available_balance
目标地址已登记到地址簿，需要时已带上 Travel Rule meta_data

步骤 1：估算网络费

网络费随链上拥堵浮动，请在用户确认前获取最新估算 —— 完整响应参见支持的资产与网络：

curl "https://api-sandbox.uqpaytech.com/api/v1/ramp/config/network-fee?asset=USDC&network=ETH&amount=100" \
  -H "x-auth-token: YOUR_API_TOKEN"

如果 network_status 为 MAINTENANCE，请拦截流程；并对照该网络的 min_withdraw_amount 和 withdraw_precision 检查金额。

步骤 2：创建提现

调用 Create Withdraw，并携带幂等键：

curl -X POST https://api-sandbox.uqpaytech.com/api/v1/ramp/withdraw \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "x-idempotency-key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "USDC",
    "network": "ETH",
    "amount": "100",
    "withdraw_address": "0x0993446fBB19f4e828768515eF7A9408B5F1A000",
    "memo": "test",
    "reason": "test"
  }'

字段	必填	描述
`currency`	是	提现币种，例如 `USDC`
`network`	是	网络代码，例如 `ETH`
`amount`	是	提现金额，十进制字符串
`withdraw_address`	是	目标地址
`memo`	否	地址 Memo/Tag，用于需要它的网络
`reason`	是	提现备注

响应：

{
  "code": 200,
  "message": "Success",
  "data": {
    "order_id": "f75fdee5-0cc1-4b52-818e-497dd376cced",
    "short_order_id": "WD260124-N1PAAIXX",
    "order_status": "Pending",
    "order_type": "Withdraw",
    "currency": "USDC",
    "network": "ETH",
    "amount": "100",
    "withdraw_address": "0x0993446fBB19f4e828768515eF7A9408B5F1A000",
    "network_fee": "0.66",
    "processing_fee": "0",
    "actual_amount": "99.34",
    "reason": "test",
    "create_time": "2026-01-24 11:41:37 +08:00"
  }
}

actual_amount 是扣除费用后实际到达目标地址的金额。实际收取的费用可能与步骤 1 的估算略有出入。

当目标地址路由到 Binance 通道、且地址簿条目没有 Travel Rule 数据时，请求会被拒绝并返回 missing travel_rule_data for binance withdraw。请先通过 Update Address Book 补录 meta_data —— 参见 Travel Rule 合规。

步骤 3：跟踪提现

状态更新通过提现 webhook 推送：

事件类型	含义
`ramp.withdraw.pending`	提现处理中
`ramp.withdraw.success`	提现已在链上完成
`ramp.withdraw.failed`	提现失败

也可以用长或短订单 ID 轮询 Retrieve Withdraw，或用 List Withdraws 批量对账。已完成的订单包含链上交易哈希（txid）和 completed_time。

curl "https://api-sandbox.uqpaytech.com/api/v1/ramp/withdraw/f75fdee5-0cc1-4b52-818e-497dd376cced" \
  -H "x-auth-token: YOUR_API_TOKEN"

入门

资产与余额

充值

提现

兑换与转账

参考

步骤 1：估算网络费

步骤 2：创建提现

步骤 3：跟踪提现

​步骤 1：估算网络费

​步骤 2：创建提现

​步骤 3：跟踪提现

​相关页面

步骤 1：估算网络费

步骤 2：创建提现

步骤 3：跟踪提现

相关页面