A AuthMS API Wiki API Reference iam.tianv.com →

POST /admin/wallets/{user_id}/adjust

管理员手动调整用户余额(需审计)

钱包服务 `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
user_id path string Yes 用户ID

Request Body

FieldTypeRequiredExampleConstraintsDescription
amount string No
reason string No
type string No

Responses

StatusDescriptionSchema
200OKdto.AdjustBalanceResponse
400请求参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证或令牌无效gitee_com_linmes_authms_base_dto.SimpleResponse
409余额不足gitee_com_linmes_authms_base_dto.SimpleResponse
422金额无效gitee_com_linmes_authms_base_dto.SimpleResponse
500服务内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.AdjustBalanceResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.ManualAdjustResult No
message string No
timestamp string No

dto.ManualAdjustResult

FieldTypeRequiredExampleConstraintsDescription
transaction dto.TransactionResponse No
wallet dto.WalletResponse No

dto.TransactionResponse

交易记录信息

FieldTypeRequiredExampleConstraintsDescription
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

用户钱包信息

FieldTypeRequiredExampleConstraintsDescription
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

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No