Deposit

Overview

• Description: Submit a deposit application, supporting manual bank transfers or third-party payment gateways. You can also optionally specify a promotion ID to claim a deposit bonus.

Business Logic & Explanations

NOTE

This interface carries extensive risk control and promotion interception logic. When separating it into a pure API, ensure these rules remain active:

1. Balance Lock: If enabled in the backend, players whose balance exceeds a certain threshold will not be able to deposit.
2. Winover Block: If a player has unfinished deposit-related turnover tasks (Winover), they will be blocked and must finish the turnover before initiating a new deposit.
3. Promotion Turnover: If a promote_id is passed (or an auto-promotion matches), the system calculates the required turnover based on the trigle_type (by principal / by bonus / mixed) multiplied by the multiplier.
4. Limit Validation: The system automatically validates against the chosen payment channel's min_deposit and max_deposit.

---

1. POST - Submit Deposit Application

• Path: /client/finance/deposit

Request Headers

Parameter	Type	Required	Description
Authorization	String	Yes	Bearer Token

Request Parameters

Parameter	Type	Required	Description
amt	Number	Yes	Deposit Amount
currency	String	No	Deposit currency (if empty, defaults to system default currency)
payment_type	String	Yes	Token of the payment method/channel
payment_bank	String	Yes	Token of the receiving bank
promote_id	String	No	Promotion ID to participate in (If null, system checks for auto-promotions)

Response Example

{
  "code": 0,
  "msg": "Deposit application submitted",
  "data": {
    "transaction_id": "20261122xxxx",
    "status": "Pending",
    "bonus_applied": 15.00
  }
}