玩家充值 (Topup)

接口说明

• 路径: /client/member/topup
• 方法: POST
• 说明: 允许已登录客户端会员对其指定币种的钱包账户进行余额充值。系统会自动校验账户并更新钱包余额及生成钱包变动流水记录。

请求头 (Request Headers)

Header	类型	必填	说明
Authorization	String	是	会员登录凭证，格式为 Bearer <Your_Member_Token>

请求参数 (Request Body)

参数名	类型	必填	说明
currency	String	是	充值币种代码 (例如 "USD", "USDT", "MYR")
amount	Number	是	充值金额，必须为大于 0 的数值
remark	String	否	充值备注说明 (可选)

请求示例

POST /client/member/topup

{
  "currency": "USD",
  "amount": 100.5,
  "remark": "Player topup USD"
}

返回参数

参数名	类型	说明
code	Number	状态码，0 表示成功
msg	String	提示信息
data	Object	充值结果数据
data.currency	String	充值的币种代码
data.balance	Number	充值完成后的该币种最新钱包余额

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "currency": "USD",
    "balance": 1100.5
  }
}

常见错误状态及说明

当 code != 0 时，表示请求失败，以下为常见的报错 msg 提示及其原因：

错误 msg 提示	原因分析
参数错误	缺少必填参数（如 currency 或 amount），或 amount 格式非数字。
验证失败: unauthorized 或 验证失败: logged in elsewhere	未携带有效 Token，或 Token 已过期，或账号在其他设备重复登录已被踢出。
失败: currency_is_required	currency 不能为空。
失败: amount_must_be_positive	传入的 amount 必须大于 0。
失败: update_balance_failed 或 失败: create_wallet_failed	数据库更新或插入钱包记录失败。