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

POST /wallets/{user_id}/deposit

向指定用户钱包充值。参考:GAAP/IFRS (Double-Entry Accounting Principles)。

钱包服务 `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
user_id path string Yes 用户ID

Request Body

Schema: dto.DepositRequest

FieldTypeRequiredExampleConstraintsDescription
amount string Yes 100.00 金额
description string No 账户充值 描述
reference_id string No order_123 外部参考

Responses

StatusDescriptionSchema
200充值成功dto.DepositDetailResponse
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.DepositDetailResponse

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

dto.DepositResult

FieldTypeRequiredExampleConstraintsDescription
transaction object No 交易记录
wallet object 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