Player Topup

Interface Description

• Path: /client/member/topup
• Method: POST
• Description: Allows a logged-in client member to top up their wallet for a specified currency. The system validates the account, updates the wallet balance, and creates a wallet transaction log.

Request Headers

Header	Type	Required	Description
Authorization	String	Yes	Member login token in format Bearer <Your_Member_Token>

Request Body

Parameter	Type	Required	Description
currency	String	Yes	Currency code (e.g., "USD", "USDT", "MYR")
amount	Number	Yes	Topup amount, must be greater than 0
remark	String	No	Optional remark/note

Request Example

POST /client/member/topup

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

Response Parameters

Parameter	Type	Description
code	Number	Status code, 0 indicates success
msg	String	Message
data	Object	Topup result data
data.currency	String	Currency code topped up
data.balance	Number	Updated wallet balance after topup

Response Example

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

Common Errors

When code != 0, the request failed. Common error messages include:

Error Message	Cause
parameter_error	Missing required parameters or invalid parameter format.
verify_failed: unauthorized or verify_failed: logged in elsewhere	Invalid or missing token, or account logged in on another device.
failed: currency_is_required	Currency code cannot be empty.
failed: amount_must_be_positive	Amount must be greater than 0.
failed: update_balance_failed	Failed to update database wallet balance.