POST `/wallets/transfer`

在用户之间转账。参考：GAAP/IFRS (Double-Entry Accounting Principles)，确保借貸平衡。

钱包服务 `bearerAuth` application/json

请求体

Schema： service-wallet/internal/handler/dto.TransferRequest

字段	类型	必填	示例	约束	描述
`amount`	`string`	是	`100.00`		金额
`from_user_id`	`string`	是	`usr_abc123`		转出用户
`to_user_id`	`string`	是	`usr_xyz456`		转入用户
`description`	`string`	否	`转账给对方`		描述

响应

状态	描述	Schema
200	转账成功	`service-wallet/internal/handler/dto.TransferDetailResponse`
400	请求参数错误	`service-core/base/dto.SimpleResponse`
401	未认证或令牌无效	`service-core/base/dto.SimpleResponse`
409	余额不足	`service-core/base/dto.SimpleResponse`
422	金额无效	`service-core/base/dto.SimpleResponse`
500	服务内部错误	`service-core/base/dto.SimpleResponse`

引用的 Schema

service-core/base/dto.SimpleResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`message`	`string`	否
`timestamp`	`string`	否

service-wallet/internal/handler/dto.TransactionResponse

交易记录信息

字段	类型	必填	示例	约束	描述
`amount`	`string`	否	`100.00`		金额
`balance_after`	`string`	否	`1000.00`		后余额
`balance_before`	`string`	否	`900.00`		前余额
`counterparty_id`	`string`	否	`usr_xyz456`		对方
`created_at`	`string`	否	`2026-04-15T10:30:00Z`		创建时间
`currency`	`string`	否	`CNY`		货币
`description`	`string`	否	`账户充值`		描述
`id`	`string`	否	`txn_abc123`		交易ID
`reference_id`	`string`	否	`order_123`		参考
`status`	`string`	否	`completed`		状态
`type`	`string`	否	`deposit`		类型
`wallet_id`	`string`	否	`wlt_abc123`		钱包ID

service-wallet/internal/handler/dto.TransferDetailResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-wallet/internal/handler/dto.TransferResult`	否
`message`	`string`	否
`timestamp`	`string`	否

service-wallet/internal/handler/dto.TransferResult

字段	类型	必填	示例	约束	描述
`from_transaction`	`object`	否			转出交易记录
`from_wallet`	`object`	否			转出方钱包
`to_transaction`	`object`	否			转入交易记录
`to_wallet`	`object`	否			转入方钱包

service-wallet/internal/handler/dto.WalletResponse

用户钱包信息

字段	类型	必填	示例	约束	描述
`application_id`	`string`	否	`app_abc123`		应用ID
`balance`	`string`	否	`1000.00`		余额
`created_at`	`string`	否	`2026-01-01T00:00:00Z`		创建时间
`currency`	`string`	否	`CNY`		货币
`frozen_balance`	`string`	否	`100.00`		冻结
`status`	`string`	否	`active`		状态
`tenant_id`	`string`	否	`tnt_xyz789`		租户ID
`updated_at`	`string`	否	`2026-04-15T10:30:00Z`		更新时间
`user_id`	`string`	否	`usr_abc123`		用户ID
`wallet_id`	`string`	否	`wlt_abc123`		钱包ID

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓