1. 提现
錢包中台服務
  • 用户钱包
    • 创建用户钱包
      POST
    • 查询用户信息
      GET
    • 查询用户充值地址
      GET
  • 提现
    • 发起提现
      POST
    • 查询提现记录
      GET
    • 查询单笔提现
      GET
  • 地址订阅
    • 订阅监控地址
      POST
    • 修改订阅
      PUT
    • 取消订阅
      DELETE
    • 查询订阅列表
      GET
  • Webhook 回调
    • 充值确认通知
      POST
    • 提现成功通知
      POST
    • 监控地址到账通知
      POST
    • 提现拒绝通知
      POST
  • 错误码
    • 错误码说明
      GET
  • 支持的链与币种
    • 链与币种说明
      GET
  • 租户余额
    • 查询所有币种余额
      GET
    • 查询单币种余额
      GET
  • Schemas
    • CreateAccountRequest
    • BaseResponse
    • WithdrawalApplyDTO
    • WatchAddressDTO
    • R_UserAccountResp
    • UserAccountResp
    • WithdrawalVO
    • R_WithdrawalRequest
    • PageResult_WithdrawalRequest
    • PageResult_WithdrawalVO
    • WithdrawalRequest
    • WalletAccountUser
    • R_Page_WithdrawalRequest
    • WebhookPayload_DepositConfirmed
    • WalletUserBalance
    • R_Object
    • WebhookPayload_WithdrawalSuccess
    • WatchAddressResp
    • WebhookPayload_WatchDeposit
    • TenantBalanceVO
    • WebhookPayload_WithdrawalEvent
  1. 提现

发起提现

POST
/api/v1/wallet/withdrawal/apply
从租户余额提币到指定地址。
手续费模式: 外扣 — amount 为实际到账金额,手续费在此基础上额外扣除。
租户余额扣除 = amount + 手续费
各链手续费:
链USDTUSDC
BNB0.050.05
ETH0.500.50
ARBITRUM0.050.05
TRON1.00—
SOLANA0.050.05
举例: 提现 100 USDT (BNB 链),手续费 0.05,到账 100 USDT,租户余额扣除 100.05 USDT。
审批机制: 金额 ≤ auto_approve_threshold 时自动审批,否则需管理员手动审批。

Request

Header Params

Body Params application/jsonRequired

Examples
{
    "externalUserId": "user_001",
    "externalOrderId": "TENANT-WD-20260506-0001",
    "toAddress": "0x3a064c586059a86925bf3f49bc535d984906e239",
    "amount": "1.37",
    "currency": "USDT",
    "network": "BNB"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/api/v1/wallet/withdrawal/apply' \
--header 'tenant-id: 1' \
--header 'Content-Type: application/json' \
--data '{
    "externalUserId": "user_001",
    "externalOrderId": "TENANT-WD-20260506-0001",
    "toAddress": "0x3a064c586059a86925bf3f49bc535d984906e239",
    "amount": "1.37",
    "currency": "USDT",
    "network": "BNB"
}'

Responses

🟢200OK
application/json
提现申请成功
Bodyapplication/json

Example
{
    "code": 0,
    "msg": "success",
    "data": {
        "orderId": "WD-ADB108F2372040068D27D9CE44BC2C35",
        "externalOrderId": "TENANT-WD-20260506-0001",
        "network": "BNB",
        "currency": "USDT",
        "toAddress": "0x3a064c586059a86925bf3f49bc535d984906e239",
        "amount": 1.37,
        "fee": 0.05,
        "status": "PENDING",
        "txHash": null,
        "remark": null,
        "createTime": "2026-04-01T12:00:00",
        "updateTime": "2026-04-01T12:00:00"
    },
    "ok": true
}
Modified at 2026-05-07 09:40:42
Previous
查询用户充值地址
Next
查询提现记录
Built with