Action 19：提款/存款
功能说明
- serialNo 为唯一值
- 若呼叫该 API 未收到响应，需再次执行时，请带入相同的 serialNo，避免重复执行。
- 错误讯息 6005，表示该笔 serialNo 重复执行。
- 错误讯息 6012，表示该笔 serialNo 正在执行中。
- 若需清空玩家账户余额，请使用 allCashOutFlag，会将所有余额包含小数一并归零。
- 玩家在游戏中或游戏大厅，若提款会收到错误讯息 6901，存款不受影响。
- 如需更即时提款，建议先执行 Action 17：踢出玩家。
- 特殊状况说明：
- 玩家离开
棋盘游戏30秒后可进行提款。 - 玩家离开
捕鱼机游戏5秒后可进行提款。 - 玩家离开
FC 捕鱼机游戏或YB 捕鱼机游戏10秒后可进行提款。 - 玩家离开
AMB或SWG游戏后，需将余额从游戏商转回，所以有可能发生提款金额不足的状况，如遇到此状况，请于5秒后重试提款。
- 玩家离开
- 存款金额不得超过 9 位数上限，否则会收到错误讯息 6009。
- 存款金额与余额合计不得超过 9 位数上限，否则会收到错误讯息 6010。
参数
| 参数 | 格式 | 强制 | 说明 |
|---|---|---|---|
| action | Integer | Y | 19 |
| ts | Long | Y | 当前系统时间 |
| parent | String(50) | Y | 代理账号 |
| uid | String(50) | Y | 玩家账号 |
| serialNo | String(50) | Y | 交易序号，限英文或数字 |
| allCashOutFlag | String(1) | N | 0：不全部提领（默认值） 1：全部提领（包含所有小数字金额） |
| amount | Double | N | 提款或存款金额 正数：存款 负数：提款 当 allCashOutFlag 为「0」时，此字段为必填金额最多允许三位小数 |
| remark | String(15) | N | 备注 |
Example
{
"action":19,
"ts":1447452951820,
"parent":"testag",
"uid":"testpl01",
"serialNo":"2016081200105",
"allCashOutFlag":"0",
"amount":1000.0,
"remark":"test deposit"
}返回结果
| 参数 | 格式 | 说明 |
|---|---|---|
| status | String(4) | 成功：0000 错误：参照附录 错误代码 |
| userBalance | Double | 玩家总余额 |
| agentCashBalance | Double | 代理现金余额 |
| amount | Double | 提领现金 |
| serialNo | String(50) | 输入的交易序号 |
| pid | Long | 交易号码：每次交易都会有一个专属的号码 |
| payDate | String(19) | 交易日期（dd-MM-yyyy HH:mm:ss） |
| err_text | String(255) | 错误讯息 |
操作范例
// 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."
}