Action 19: Withdraw / Deposit
Function Description
- serialNo is a unique value.
- If there is no response when calling up API, please use the same serialNo when re-execution is needed to avoid duplicate execution.
- Error message 6005 means that duplicate execution occurs in this serialNo.
- Error message 6012 means that the serialNo is currently in progress.
- If need to withdraw all out the player account balance, please use allCashOutFlag, which will cash out all the player account balance with decimals.
- Players may receive error message 6901 when attempting to make a withdrawal in the game or game lobby, but deposits will not be affected.
- If you require a more immediate withdrawal, it is suggested to execute Action 17:Kick Out Player first.
- Special Situation Explanation:
- Players can make withdrawals after
30 secondsof leaving theCard game. - Players can make withdrawals after
5 secondsof leaving theFish game. - Players can make withdrawals after
10 secondsof leaving theFC fish gameorYB fish game. - Upon leaving the
AMBorSWGgame, need to transfer their balance back from the game provider, so there may be situations where the withdrawal amount is insufficient. In such cases, please retry the withdrawal after5 seconds.
- Players can make withdrawals after
- The deposit amount cannot exceed the 9-digit limit, otherwise an error message 6009 is returned.
- The deposit amount and total balance cannot exceed the 9-digit limit, otherwise an error message 6010 is returned.
Parameter
| Parameter | Format | Mandatory | Description |
|---|---|---|---|
| action | Integer | Y | 19 |
| ts | Long | Y | Current system time |
| parent | String(50) | Y | Agent ID |
| uid | String(50) | Y | Player ID |
| serialNo | String(50) | Y | Transaction Serial NumberEnglish or digital only |
| allCashOutFlag | String(1) | N | 0: Not withdraw all (Default) 1: Withdraw all (include all balance with decimals) |
| amount | Double | N | Amount of withdrawal or deposit Positive: Deposit Negative: Withdrawal When allCashOutFlag is “0”, this parameter need to be filled in.Amount allows up to three decimal places. |
| remark | String(15) | N | Remark |
Example
{
"action":19,
"ts":1447452951820,
"parent":"testag",
"uid":"testpl01",
"serialNo":"2016081200105",
"allCashOutFlag":"0",
"amount":1000.0,
"remark":"test deposit"
}Return Results
| Parameter | Format | Description |
|---|---|---|
| status | String(4) | Success: 0000 Error: See Error Codes in Appendix |
| userBalance | Double | Total balance in the account |
| agentCashBalance | Double | Cash balance of the agent |
| amount | Double | The amount of money to withdraw/deposit |
| serialNo | String(50) | Transaction serial number entered |
| pid | Long | Transaction number |
| payDate | String(19) | Transaction date (dd-MM-yyyy HH:mm:ss) |
| err_text | String(255) | Error message |
Operation Sample
// Http Request
http://{API_Address}/apiRequest.do?dc=jb&x=udbFVt_xv0tsAmLDpz5Z3Ct4-p0gedUPdQO-UWsfd6PHz9Ky-wM3mIC9El4kwl_SlX3lpraVaCLnp-K0WsgKmpYTV9XpYncHzbtvn591qfaAwpGyOvsS4v1Yj7OvpRw_iU4554RuSsvHpI9jaj4XUgTK5yzbWKEddANjAAbxF0s=
//Http Response (success)
{
"status":"0000",
"userBalance":1000.0,
"agentCashBalance":0.0,
"amount": 1000.0,
"serialNo":"2016081200105",
"pid": 14425,
"payDate":"08-12-2016 17:45:00"
}
// Http Response (error)
{
"status":"9005",
"err_text":"Assertion(SAML) didn't pass the timestamp validation."
}