POST `/wallets/transfer`

Transfer between users. Reference: GAAP/IFRS (Double-Entry Accounting Principles) to ensure debit-credit balance.

Wallet Service `bearerAuth` application/json

Request Body

Schema: dto.TransferRequest

Field	Type	Required	Example	Description
`amount`	`string`	Yes	`100.00`	Amount
`from_user_id`	`string`	Yes	`usr_abc123`	Sender user
`to_user_id`	`string`	Yes	`usr_xyz456`	Recipient user
`description`	`string`	No	`Transfer to counterparty`	Description

Status	Description	Schema
200	Transfer successful	`dto.TransferDetailResponse`
400	Invalid request parameters	`gitee_com_linmes_authms_base_dto.SimpleResponse`
401	Unauthenticated or invalid token	`gitee_com_linmes_authms_base_dto.SimpleResponse`
409	Insufficient balance	`gitee_com_linmes_authms_base_dto.SimpleResponse`
422	Invalid amount	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	Internal server error	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Transaction record info

Field	Type	Required	Example	Description
`amount`	`string`	No	`100.00`	Amount
`balance_after`	`string`	No	`1000.00`	Balance after
`balance_before`	`string`	No	`900.00`	Balance before
`counterparty_id`	`string`	No	`usr_xyz456`	Counterparty
`created_at`	`string`	No	`2026-04-15T10:30:00Z`	Created time
`currency`	`string`	No	`CNY`	Currency
`description`	`string`	No	`Account deposit`	Description
`id`	`string`	No	`txn_abc123`	Transaction ID
`reference_id`	`string`	No	`order_123`	Reference
`status`	`string`	No	`completed`	Status
`type`	`string`	No	`deposit`	Type
`wallet_id`	`string`	No	`wlt_abc123`	Wallet ID

Field	Type	Required
`code`	`integer`	No
`data`	`dto.TransferResult`	No
`message`	`string`	No
`timestamp`	`string`	No

Field	Type	Required	Description
`from_transaction`	`object`	No	Sender transaction record
`from_wallet`	`object`	No	Sender wallet
`to_transaction`	`object`	No	Recipient transaction record
`to_wallet`	`object`	No	Recipient wallet

User wallet info

Field	Type	Required	Example	Description
`application_id`	`string`	No	`app_abc123`	App ID
`balance`	`string`	No	`1000.00`	Balance
`created_at`	`string`	No	`2026-01-01T00:00:00Z`	Created time
`currency`	`string`	No	`CNY`	Currency
`frozen_balance`	`string`	No	`100.00`	Frozen
`status`	`string`	No	`active`	Status
`tenant_id`	`string`	No	`tnt_xyz789`	Tenant ID
`updated_at`	`string`	No	`2026-04-15T10:30:00Z`	Updated time
`user_id`	`string`	No	`usr_abc123`	User ID
`wallet_id`	`string`	No	`wlt_abc123`	Wallet ID

Field	Type	Required
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No