常规验证-扣余额

请求地址

管理后台创建软件后获取例：http://demo.huweidun.cn/ac.php?s=8508c320cacb0634c0e241df2f3345fe

公共提交参数

参数名	示例值	参数说明
sid	00362ace-e994-411a-a9bf-f31f9177b6f3	软件SID，后台添加软件后获得。
uuid	d6fadd40-7267-4178-9b35-4c8ff61e0c07	封包安全码，每次必须变动，用于校验数据合法性方案之一。
t	1630766594	客户端10位时间戳。
m1	590b782aa78cc3333c84eaa975ab9dc1	封包token（sid+key+t 拼接后取MD5值）
m2	b1dfd79c7cf0f5df8f77c12352af952c	当前程序MD5值，如果开启校验MD5，则此值必填，可于程序运行时动态读取自身MD5值。
m3	f50ebce838ae4b8e212578dd0bc23d9f	moduleMd5，购买授权后获得，如使用dll文件,请传入DLLMD5值，同时在”后台-系统-系统设置”中填写。
mcode	b4f43bb8-32dc-4d9a-9094-74e39cd61c37	客户端机器码（自行获取机器码，若机器码变动则会提示转绑[如果开启”绑定机器码”]）
clientid	36ebe72d-51d8-4252-b99c-37da152717ac	客户端运行ID，此ID在软件退出之前不可变动，也就是每次启动都生成一个新的clientid，软件退出即作废。
webkey	0241946994e62e289e4622b07154b961	通用秘钥(webKey)，购买授权后获得。

公共返回参数

参数名	示例值	参数说明
status	success	success为正常，error为错误。
code	200	200为正常，其它为错误。
msg	账号或密码错误.	错误内容，无错误返回空。
token	324daaf6558361aa8f27d607c72262af	返回封包token（提交封包中的m1+返回封包中t，拼接后取MD5值）
t	1630766888	封包时间戳
uuid	d6fadd40-7267-4178-9b35-4c8ff61e0c07	提交封包的UUID，原样返回。
result	请查看不同函数说明	数据主体，Json格式，每个函数返回的数据不同，具体请参照对应函数说明。
result_token	627b0d546ccb1d4896373305d74c6933	数据主体token，将数据以ASCII首字母递增排序，拼接键名与键值，拼接完毕后加上通信秘钥一起取MD5值。

传参说明

只需按规则拼接参数后加密传送即可。
封包内参数分为公共参数和函数参数。
公共参数为所有命令均需要提交的参数。
函数参数根据不同函数说明决定提交哪个参数，对应函数内均有说明。

函数参数

action=deductbalance&user=扣除账号&num=扣除余额&msg=扣除备注&interval=0

提交示例

{
    "action": "deductbalance",
    "clientid": "bcc41962-18ee-4c17-9287-d7ade0572055",
    "interval": "0",
    "key": "GorgBdTnRDYxQGxKC9pYB42O933Pzxx4",
    "m1": "1db1cbdc1f37019c3a9b97d554ab5096",
    "m2": "d41d8cd98f00b204e9800998ecf8427e",
    "m3": "a0368bba05140b66e8172247da2650ab",
    "mcode": "de11dbe0-aff6-d5ff-0e38-76e51d30ee21",
    "msg": "测试扣余额0.5元.",
    "num": "0.5",
    "sid": "c1162b61-fa71-4214-b66b-014ae6b0a99a",
    "t": "1630822945",
    "user": "user6",
    "uuid": "c8038c98-8825-4edd-a964-6ba81a0b794b",
    "webkey": "943e508419c4cd486ab894d3f7dbee50"
}

扣除成功返回

{
    "status": "success",
    "code": "200",
    "uuid": "c8038c98-8825-4edd-a964-6ba81a0b794b",
    "result": {
        "balance": "631.16"
    },
    "msg": "",
    "token": "b4576a52ee20aa0a54d3e8683fa21de8",
    "t": 1630822944,
    "result_token": "b5e429fd55e8a386660760e202fc6b15"
}

数据主体解析（result）

balance 扣除成功后的账户余额。

失败返回

{
    "status": "error",
    "code": "256",
    "uuid": "6dd01f3a-b38f-4e40-9455-bfd7b5424a44",
    "result": null,
    "msg": "\u8d26\u6237\u4f59\u989d\u4e0d\u8db3,\u6263\u9664\u5931\u8d25.",
    "token": "3890a2654983622ff602e6ad3979c5cd",
    "t": 1630823016,
    "result_token": null
}

高级用法

与扣点相同，高级用法请参见WebAPI-常规验证-扣点下方的特别说明。

错误码

错误码	错误消息
255	扣除余额账户不存在.
257	扣除余额失败,未知原因,请联系客服.’
256	账户余额不足,扣除失败.

## 请求地址
`管理后台创建软件后获取`例：`http://demo.huweidun.cn/ac.php?s=8508c320cacb0634c0e241df2f3345fe`
## 公共提交参数
|  参数名   | 示例值 | 参数说明  |
|  ----  | ----  | ----  |
| sid  | <div style="width: 350px">00362ace-e994-411a-a9bf-f31f9177b6f3 | 软件SID，后台添加软件后获得。</div>  |
| uuid  | d6fadd40-7267-4178-9b35-4c8ff61e0c07 | 封包安全码，每次必须变动，用于校验数据合法性方案之一。  |
|  t  | 1630766594  | 客户端10位时间戳。  |
|  m1  | 590b782aa78cc3333c84eaa975ab9dc1  | 封包token（sid+key+t 拼接后取MD5值）  |
|  m2  | b1dfd79c7cf0f5df8f77c12352af952c  | 当前程序MD5值，如果开启校验MD5，则此值必填，可于程序运行时动态读取自身MD5值。  |
|  m3  | f50ebce838ae4b8e212578dd0bc23d9f  | moduleMd5，购买授权后获得，如使用dll文件,请传入DLLMD5值，同时在"后台-系统-系统设置"中填写。  |
|  mcode  | b4f43bb8-32dc-4d9a-9094-74e39cd61c37  | 客户端机器码（自行获取机器码，若机器码变动则会提示转绑[如果开启"绑定机器码"]）  |
|  clientid  | 36ebe72d-51d8-4252-b99c-37da152717ac  | 客户端运行ID，此ID在软件退出之前不可变动，也就是每次启动都生成一个新的clientid，软件退出即作废。  |
|  webkey  | 0241946994e62e289e4622b07154b961  | 通用秘钥(webKey)，购买授权后获得。  |

## 公共返回参数
|  参数名   | 示例值 | 参数说明  |
|  ----  | ----  | ----  |
|  status  | <div style="width: 350px">success</div>  | success为正常，error为错误。  |
|  code  | 200  | 200为正常，其它为错误。  |
|  msg  | 账号或密码错误.  | 错误内容，无错误返回空。  |
|  token  | 324daaf6558361aa8f27d607c72262af  | 返回封包token（提交封包中的m1+返回封包中t，拼接后取MD5值）  |
|  t  | 1630766888  | 封包时间戳  |
|  uuid  | d6fadd40-7267-4178-9b35-4c8ff61e0c07  | 提交封包的UUID，原样返回。  |
|  result  |  请查看不同函数说明 | 数据主体，Json格式，每个函数返回的数据不同，具体请参照对应函数说明。  |
|  result_token  | 627b0d546ccb1d4896373305d74c6933  | 数据主体token，将数据以ASCII首字母递增排序，拼接键名与键值，拼接完毕后加上通信秘钥一起取MD5值。  |

## 传参说明
* 只需按规则拼接参数后加密传送即可。

* 封包内参数分为公共参数和函数参数。

* 公共参数为所有命令均需要提交的参数。

* 函数参数根据不同函数说明决定提交哪个参数，对应函数内均有说明。

---

## 函数参数
`action=deductbalance&user=扣除账号&num=扣除余额&msg=扣除备注&interval=0`

## 提交示例
```
{
	"action": "deductbalance",
	"clientid": "bcc41962-18ee-4c17-9287-d7ade0572055",
	"interval": "0",
	"key": "GorgBdTnRDYxQGxKC9pYB42O933Pzxx4",
	"m1": "1db1cbdc1f37019c3a9b97d554ab5096",
	"m2": "d41d8cd98f00b204e9800998ecf8427e",
	"m3": "a0368bba05140b66e8172247da2650ab",
	"mcode": "de11dbe0-aff6-d5ff-0e38-76e51d30ee21",
	"msg": "测试扣余额0.5元.",
	"num": "0.5",
	"sid": "c1162b61-fa71-4214-b66b-014ae6b0a99a",
	"t": "1630822945",
	"user": "user6",
	"uuid": "c8038c98-8825-4edd-a964-6ba81a0b794b",
	"webkey": "943e508419c4cd486ab894d3f7dbee50"
}
```

## 扣除成功返回
```
{
	"status": "success",
	"code": "200",
	"uuid": "c8038c98-8825-4edd-a964-6ba81a0b794b",
	"result": {
		"balance": "631.16"
	},
	"msg": "",
	"token": "b4576a52ee20aa0a54d3e8683fa21de8",
	"t": 1630822944,
	"result_token": "b5e429fd55e8a386660760e202fc6b15"
}
```

## 数据主体解析（result）
`balance` 扣除成功后的账户余额。

## 失败返回
```
{
	"status": "error",
	"code": "256",
	"uuid": "6dd01f3a-b38f-4e40-9455-bfd7b5424a44",
	"result": null,
	"msg": "\u8d26\u6237\u4f59\u989d\u4e0d\u8db3,\u6263\u9664\u5931\u8d25.",
	"token": "3890a2654983622ff602e6ad3979c5cd",
	"t": 1630823016,
	"result_token": null
}
```

## 高级用法
与扣点相同，高级用法请参见[WebAPI-常规验证-扣点](../doc-view-55.htm "WebAPI-常规验证-扣点")下方的特别说明。

## 错误码
|  错误码 | 错误消息  |
| ------------ | ------------ |
| 255  | 扣除余额账户不存在.  |
|  257 | 扣除余额失败,未知原因,请联系客服.'  |
| 256  | 账户余额不足,扣除失败.  |