POST /wallets/{user_id}/refund
对指定用户钱包进行退款
钱包服务 `bearerAuth` application/json
Request Parameters
| Name | In | Type | Required | Default | Example | Constraints | Description |
|---|
user_id |
path |
string |
Yes |
|
|
|
用户ID |
Request Body
Schema: dto.RefundRequest
| Field | Type | Required | Example | Constraints | Description |
|---|
transaction_id |
string |
Yes |
txn_abc123 |
|
原交易 |
amount |
string |
No |
50.00 |
|
金额 |
reason |
string |
No |
商品退货 |
|
原因 |
reference_id |
string |
No |
REF-001 |
|
参考 |
Referenced Schemas
dto.RefundDetailResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
data |
dto.RefundResult |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|
dto.RefundResult
| Field | Type | Required | Example | Constraints | Description |
|---|
transaction |
object |
No |
|
|
退款交易记录 |
wallet |
object |
No |
|
|
钱包信息 |
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 |
gitee_com_linmes_authms_base_dto.SimpleResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|