POST /wallets/{user_id}/withdraw
从指定用户钱包提现。参考：GAAP/IFRS (Double-Entry Accounting Principles)。
钱包服务 `bearerAuth` application/json
Request Parameters
| Name | In | Type | Required | Default | Example | Constraints | Description |
|---|
user_id |
path |
string |
Yes |
|
|
|
用户ID |
Request Body
Schema: dto.WithdrawRequest
| Field | Type | Required | Example | Constraints | Description |
|---|
amount |
string |
Yes |
50.00 |
|
金额 |
description |
string |
No |
余额提现 |
|
描述 |
reference_id |
string |
No |
withdraw_123 |
|
参考 |
Referenced Schemas
dto.TransactionResponse
交易记录信息
| Field | Type | Required | Example | Constraints | Description |
|---|
amount |
string |
No |
100.00 |
|
金额 |
balance_after |
string |
No |
1000.00 |
|
后余额 |
balance_before |
string |
No |
900.00 |
|
前余额 |
counterparty_id |
string |
No |
usr_xyz456 |
|
对方 |
created_at |
string |
No |
2026-04-15T10:30:00Z |
|
创建时间 |
currency |
string |
No |
CNY |
|
货币 |
description |
string |
No |
账户充值 |
|
描述 |
id |
string |
No |
txn_abc123 |
|
交易ID |
reference_id |
string |
No |
order_123 |
|
参考 |
status |
string |
No |
completed |
|
状态 |
type |
string |
No |
deposit |
|
类型 |
wallet_id |
string |
No |
wlt_abc123 |
|
钱包ID |
dto.WalletResponse
用户钱包信息
| Field | Type | Required | Example | Constraints | Description |
|---|
application_id |
string |
No |
app_abc123 |
|
应用ID |
balance |
string |
No |
1000.00 |
|
余额 |
created_at |
string |
No |
2026-01-01T00:00:00Z |
|
创建时间 |
currency |
string |
No |
CNY |
|
货币 |
frozen_balance |
string |
No |
100.00 |
|
冻结 |
status |
string |
No |
active |
|
状态 |
tenant_id |
string |
No |
tnt_xyz789 |
|
租户ID |
updated_at |
string |
No |
2026-04-15T10:30:00Z |
|
更新时间 |
user_id |
string |
No |
usr_abc123 |
|
用户ID |
wallet_id |
string |
No |
wlt_abc123 |
|
钱包ID |
dto.WithdrawDetailResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
data |
dto.WithdrawResult |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|
dto.WithdrawResult
| Field | Type | Required | Example | Constraints | Description |
|---|
transaction |
object |
No |
|
|
交易记录 |
wallet |
object |
No |
|
|
钱包信息 |
gitee_com_linmes_authms_base_dto.SimpleResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|