Action 19: Tip Out
Function Description
- Call this API during activity payouts to notify the client of the game prize distribution.
- Use the amount to confirm if the player's balance is sufficient. After deducting the amount, return the player's remaining balance.
- amount:
- If the player's balance is >= amount, the request will be processed.
- If the player's balance is < amount, please return error code 6006.
- amount:
- To ensure idempotent design, if a request is received and the specified transferId has already been processed for tipping, please do not process it again. The response should return status code 0000.
Request Parameters
| Parameter | Format | Description |
|---|---|---|
| action | Integer | 19 |
| ts | Long | Current system time |
| transferId | Long | Transfer ID can not be referred to game history |
| uid | String(50) | Player ID |
| amount | BigDecimal | Tip amount |
| currency | String(10) | Please refer to: Currency Code |
| gType | Integer | Game types See Game Provider |
| mType | Integer | Machine Type |
Request Example
{
"action": 19,
"ts": 1752121463107,
"transferId": 411177,
"uid": "john",
"amount": 15.0,
"currency": "RB",
"gType": 7,
"mType": 210001
}Response Parameter
| Parameter | Format | Description |
|---|---|---|
| status | String(4) | Success: 0000If receive request and transferId has been payout reward, please return 0000 as the status.It would be considered as failure if the status is not 0000, and you can describe in err_text. |
| balance | Double | Balance |
| err_text | String(255) | Error message |
Response Example
{
"status": "0000",
"balance": 12345.67,
"err_text": ""
}