POST /wallets/transfer
在用户之间转账。参考：GAAP/IFRS (Double-Entry Accounting Principles)，确保借貸平衡。
钱包服务 `bearerAuth` application/json
Request Body
Schema: dto.TransferRequest
| Field | Type | Required | Example | Constraints | Description |
|---|
amount |
string |
Yes |
100.00 |
|
金额 |
from_user_id |
string |
Yes |
usr_abc123 |
|
转出用户 |
to_user_id |
string |
Yes |
usr_xyz456 |
|
转入用户 |
description |
string |
No |
转账给对方 |
|
描述 |
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.TransferDetailResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
data |
dto.TransferResult |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|
dto.TransferResult
| Field | Type | Required | Example | Constraints | Description |
|---|
from_transaction |
object |
No |
|
|
转出交易记录 |
from_wallet |
object |
No |
|
|
转出方钱包 |
to_transaction |
object |
No |
|
|
转入交易记录 |
to_wallet |
object |
No |
|
|
转入方钱包 |
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 |
gitee_com_linmes_authms_base_dto.SimpleResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|