增加接口文档
diff --git a/package.json b/package.json
index 62f98cc..fb401f4 100644
--- a/package.json
+++ b/package.json
@@ -3,7 +3,7 @@
"version": "0.0.0",
"private": true,
"hexo": {
- "version": "3.3.1"
+ "version": "3.3.7"
},
"dependencies": {
"hexo": "^3.2.2",
diff --git "a/source/_posts/\344\270\200\345\215\241\351\200\232v5-App-\346\216\245\345\217\243\346\226\207\346\241\243.md" "b/source/_posts/\344\270\200\345\215\241\351\200\232v5-App-\346\216\245\345\217\243\346\226\207\346\241\243.md"
new file mode 100644
index 0000000..4035fd1
--- /dev/null
+++ "b/source/_posts/\344\270\200\345\215\241\351\200\232v5-App-\346\216\245\345\217\243\346\226\207\346\241\243.md"
@@ -0,0 +1,1128 @@
+---
+title: 一卡通v5 App 接口文档
+date: 2017-07-13 09:09:48
+tags:
+---
+**修订历史**
+============
+
+| 版本 | 作者 | 日期 | 备注 |
+|--------|--------|------------|------------------|
+| V4.0.0 | 何林青 | 2015-01-06 | 初稿 |
+| v4.0.1 | 汤成 | 2016-3-16 | 增加设备相关接口 |
+
+
+## 前言
+### 编写目的
+
+本文档用于描述了易支付对外提供的所有api接口，包括提供手机app端和pos消费端，供内部业务依据此接口开发提供参考。
+
+### 约定
+
+1. 传输编码统一utf-8
+
+## 接口描述
+### 1. 手机api功能入口
+#### 1.1 注册绑定服务
+
+Uri: *https://ip:port/epayapi/services/bindservice*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|-----------|--------|----------|---------------------|
+| uid | String | 是 | 从终端获取的唯一号 |
+| phone | String | 否 | 手机号 |
+| school | String | 是 | 学校代码 |
+| userid | String | 是 | 学号 |
+| username | String | 是 | 姓名 |
+| idno | String | 是 | 身份证后六位 |
+| timestamp | String | 是 | 手机时间戳 |
+| platform | String | 是 | 手机平台android/ios |
+
+例子:
+
+URI：https://ip:port/epayapi/services/bindservice
+
+uid:12309487839029
+
+phone:15089039087
+
+school:01
+
+userid:09893092
+
+username:王小二
+
+idno:092010
+
+timestamp:2015-01-19 13:09:01
+
+platform:android
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+"timestamp": "2015-01-19 16:25:29",
+
+"uid": "12309487839029",
+
+"gid": "10000021",
+
+> "rsapbulic": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCG3ADBVO/ngyMGlIZ6LM62CXrmBQ/lvuo6u/03\\r\\namCFHgxBC9U0E+AawCgf4tgVOzePxlmqqkFgh2NIySAL9e2qcqvUa2a3jjutAdmamfo6raofnr9G\\r\\nf6hO1LZp7NRR0cXgojJyXkTRvDdkR46ZUydMng2AXm6jNr1Sdg643OQ83QIDAQAB\\r\\n",
+
+"isfirstreg": false,
+
+"ispwdset": false
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.2 登录密码初始设置
+
+Uri: *https://ip:port/epayapi/services/auth/pwdset*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|------|--------|----------|----------|
+| gid | String | 是 | 客户端号 |
+| pwd | String | 是 | 密码 |
+| dpwd | String | 是 | 重复密码 |
+
+例子:
+
+URI：https://ip:port/epayapi/services*/auth*/*pwdset*
+
+gid:10000001
+
+pwd:123456
+
+dpwd:123456
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+"retcode":"0",
+
+"retmsg":"设置成功"
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.3登录密码重置
+
+Uri: *https://ip:port/epayapi/services/auth/pwdreset*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|------|--------|----------|----------|
+| gid | String | 是 | 客户端号 |
+| opwd | String | 是 | 原始密码 |
+| pwd | String | 是 | 密码 |
+| dpwd | String | 是 | 重复密码 |
+
+例子:
+
+URI：https://ip:port/epayapi/services*/auth*/*pwdset*
+
+gid:10000001
+
+opwd:654321
+
+pwd:123456
+
+dpwd:123456
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+"retcode":"0",
+
+"retmsg":"重置成功"
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.4登录-设备授权码
+
+Uri: *https://ip:port/epayapi/services/oauth2/device*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|------------|--------|----------|---------------------------------------|
+| client\_id | String | 是 | 客户端标识,统一分配给平台指定客户端id |
+| type | String | 是 | 类型 device\_code/device\_token |
+| code | String | 否 | 验证码 |
+
+例子:
+
+URI：https://ip:port/epayapi/services/*oauth2/device*
+
+Client\_id:a9020b039900d9001
+
+type:device\_code
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+"retcode":"0",
+
+“code”:255409389383939
+
+“userCode”:1234,
+
+verifyURL:”/user/code”
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.5登录-oauth授权
+
+Uri: *https://ip:port/epayapi/services/oauth2/authlogin*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|----------|--------|----------|------------------|
+| uid | String | 是 | 客户端唯一识别码 |
+| gid | String | 是 | 终端编号 |
+| school | String | 否 | 学校代码 |
+| userid | String | 是 | 学工号 |
+| pwd | String | 是 | 密码 |
+| usercode | String | 否 | 验证码 |
+| platform | String | 否 | 手机平台 |
+
+例子:
+
+URI：[*https://ip:port/epayapi/services/oauth2/authlogin*](https://ip:port/epayapi/services/oauth2/authlogin)
+
+uid:12309487839029
+
+gid:2000100002020101
+
+school:01
+
+userid:09893092
+
+pwd:123456
+
+usercode:092010
+
+platform:android
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+"retcode":"0",
+
+“gid”:2001902902909,
+
+“accname”:”小二”,
+
+“token”:abcde32423523cabb434,
+
+“expiresin”:149059504,
+
+“schoolcode”:”01”
+
+“secretkey”:iosdkfjhs9293i98421kljsjflksjfd
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.6电控校区查询
+
+Uri: *https://ip:port/epayapi/services/elecfee/queryarea*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|------|------|----------|------|
+| | | | |
+
+
+例子:
+
+URI：*https://ip:port/epayapi/services/elecfee/queryarea*
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+\["areaId":"1",
+
+"areaName":"A校区"\]，\["areaId":"2",
+
+"areaName":"B校区"\]
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.7电控区域查询
+
+Uri: *https://ip:port/epayapi/services/elecfee/querydistricts*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------|--------|----------|------|
+| areaId | 校区id | 是 | |
+
+
+例子:
+
+URI：*https://ip:port/epayapi/services/elecfee/querydistricts*
+
+areaId:1
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+\["districtId":"101",
+
+" districtName":"A区域"\]，\["districtId ":"102",
+
+"districtName ":"B区域"\]
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.8电控楼栋查询
+
+Uri: *https://ip:port/epayapi/services/elecfee/querybuilds*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|------------|--------|----------|------|
+| areaId | 校区id | 是 | |
+| districtId | 区域id | 是 | |
+
+例子:
+
+URI：*https://ip:port/epayapi/services/elecfee/querybuilds*
+
+areaId:1
+
+districtId:102
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+\["buildId":"101",
+
+" buildName":"al楼"\]，\["buildId ":"102",
+
+"buildName ":"B1楼"\]
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.9电控楼层查询
+
+Uri: *https://ip:port/epayapi/services/elecfee/queryfloors*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|------------|--------|----------|------|
+| areaId | 校区id | 是 | |
+| districtId | 区域id | 是 | |
+| buildId | 楼栋id | 是 | |
+
+例子:
+
+URI：*https://ip:port/epayapi/services/elecfee/queryfloors*
+
+areaId:1
+
+districtId:101
+
+buildId:3001
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+\["floorId":"101",
+
+" floorName":"1楼"\]，\["floorId ":"102",
+
+"floorName ":"2楼"\]
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.10电控房间查询
+
+Uri: *https://ip:port/epayapi/services/elecfee/queryrooms*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|------------|--------|----------|------|
+| areaId | 校区id | 是 | |
+| districtId | 区域id | 是 | |
+| buildId | 楼栋id | 是 | |
+| floorId | 楼层id | 是 | |
+
+例子:
+
+URI：*https://ip:port/epayapi/services/elecfee/queryrooms*
+
+areaId:1
+
+districtId:101
+
+buildId:3001
+
+floorId:1
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+\["roomId":"101",
+
+" roomName":"301"\]，\["roomId ":"102",
+
+"roomName ":"302"\]
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.11电控房间电量信息查询
+
+Uri: *https://ip:port/epayapi/services/elecfee/queryroominfo*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|---------|--------|----------|------|
+| areaId | 校区id | 是 | |
+| buildId | 楼栋id | 是 | |
+| roomId | 房间id | 是 | |
+
+
+例子:
+
+URI：*https://ip:port/epayapi/services/elecfee/queryroominfo*
+
+areaId:1
+
+buildId:3001
+
+roomId:1
+
+返回：
+
+> 返回格式：application/json
+
+{"areaId":"1",
+
+“buildId”:3001,
+
+“roomId”:1,
+
+" roomName":"301",
+
+“restElecDegree”:20.9
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.12电控房间电量信息查询
+
+Uri: *https://ip:port/epayapi/services/elecfee/buyelectrity*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|------------|----------------|----------|--------|
+| areaId | 校区id | 是 | |
+| buildId | 楼栋id | 是 | |
+| roomId | 房间id | 是 | |
+| amount | 充值金额 | 是 | 单位元 |
+| gid | 客户端唯一标识 | 是 | |
+| payrouteid | 支付途径id | 是 | |
+| paypwd | 支付密码 | 是 | |
+
+例子:
+
+URI：*https://ip:port/epayapi/services/elecfee/queryroominfo*
+
+areaId:1
+
+buildId:3001
+
+roomId:1
+
+amount:10.4
+
+gid:10000001
+
+payrouteid:1
+
+paypwd:123456
+
+返回：
+
+> 返回格式：application/json
+
+{"retcode":"0",
+
+“retmsg”:”充值成功”
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.13账户信息查询
+
+Uri: *https://ip:port/epayapi/services/account/getaccountinfo*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------|----------------|----------|------|
+| gid | 客户端唯一标识 | 是 | |
+| userid | 学号 | 是 | |
+
+
+例子:
+
+URI：*https://ip:port/epayapi/services/account/getaccountinfo*
+
+gid:10000014
+
+userid:098298192
+
+返回：
+
+> 返回格式：application/json
+
+{ “accno”:1
+
+“accname“:”212”,
+
+“status“:1,
+
+“balance“:105,
+
+“availbal“:105,
+
+“frozebal“:0,
+
+“opendate“:”20140509”,
+
+“closedate”:null,
+
+“timelimit“:50,
+
+“daylimit“:100，
+
+Bankcards:1
+
+Schoolcards:1
+
+Schoolcollege:”A学院”
+
+Schoolprofessional:”武警”
+
+Schoolclass:”101”
+
+Mobile:”129839383993”
+
+Email:”sdkfj@kjsdf.com”
+
+Sex:”男”
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.14账单列表查询
+
+Uri: *https://ip:port/epayapi/services/billservice/getbilldata*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|----------|----------------|----------|----------|
+| gid | 客户端唯一标识 | 是 | |
+| pageNo | 页码 | 是 | |
+| billtype | 账单类型 | 是 | EPAY/YKT |
+
+例子:
+
+URI：*https://ip:port/epayapi/services/billservice/getbilldata*
+
+gid:10000014
+
+pageNo:1
+
+billtype:”EPAY”
+
+返回：
+
+> 返回格式：application/json
+
+{\[
+
+> *“refno“:20392103929303，*
+>
+> *“paytime“:20150802091029，*
+>
+> *“billname“:”pos消费”,*
+>
+> *“amount“:”10.9”,*
+>
+> *“billtype“:”EPAY”,*
+
+“billstatus“:”2”,
+
+“tradetype”:2\],
+
+\[
+
+> *“refno“:20392103929303,*
+>
+> *“paytime“:20150802091029,*
+>
+> *“billname“:”pos消费”,*
+>
+> *“amount“:”10.9”,*
+>
+> *“billtype“:”EPAY”,*
+
+“billstatus“:”2”,
+
+“tradetype”:2\],
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.15账单明细查询
+
+Uri: *https://ip:port/epayapi/services/billservice/getbilldetail*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|----------|----------------|----------|----------|
+| gid | 客户端唯一标识 | 是 | |
+| refno | 参考号 | 是 | |
+| billtype | 账单类型 | 是 | EPAY/YKT |
+
+例子:
+
+URI：*https://ip:port/epayapi/services/billservice/getbilldetail*
+
+gid:10000014
+
+refno:”2013040192029192”
+
+billtype:”EPAY”
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+> *“refno“:20392103929303*
+>
+> *“paytime“:20150802091029*
+>
+> *“billname“:”pos消费”*
+>
+> *“amount“:”10.9”*
+>
+> *“billtype“:”EPAY”*
+
+“billstatus“:”2”,
+
+“organname”:”财务处”,
+
+“paidmethod”:”卡余额”,
+
+“tradetype”:2}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.16挂失卡查询
+
+Uri: *https://ip:port/epayapi/services/ykt/cardlist*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|------|----------------|----------|------|
+| gid | 客户端唯一标识 | 是 | |
+
+例子:
+
+URI：*https://ip:port/epayapi/services/ykt/cardlist*
+
+gid:10000014
+
+返回：
+
+> 返回格式：application/json
+
+\[{
+
+> *“cardno“:100092*
+>
+> *“cardphytypename“:cpu卡*
+
+}\]
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.17卡挂失
+
+Uri: *https://ip:port/epayapi/services/ykt/cardloss*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|---------|----------------|----------|------|
+| gid | 客户端唯一标识 | 是 | |
+| cardno | 卡号 | 是 | |
+| cardpwd | 卡密码 | 是 | |
+
+例子:
+
+URI：*https://ip:port/epayapi/services/ykt/cardloss*
+
+gid:10000014
+
+cardno:”100092”
+
+cardpwd:”111111”
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+> *“retcode“:0，*
+>
+> *“retmsg“:”挂失成功”*
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.18圈存银行卡列表查询
+
+Uri: *https://ip:port/epayapi/services/charge/bankcard/list*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|----------|----------------|----------|------|
+| gid | 客户端唯一标识 | 是 | |
+| payroute | 充值方式 | 是 | |
+
+例子:
+
+URI：*https://ip:port/epayapi/services/charge/bankcard/list*
+
+gid:10000014
+
+payroute:”1”
+
+返回：
+
+> 返回格式：application/json
+
+\[{
+
+> *“bankcardno“:1002920192393909，*
+>
+> *“bankname“:”中国银行”，*
+
+}\]
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.19充值初始化
+
+Uri: *https://ip:port/epayapi/services/charge/term/init*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|----------|----------------|----------|------|
+| gid | 客户端唯一标识 | 是 | |
+| payroute | 充值方式 | 是 | |
+| amount | 充值金额 | 是 | |
+
+例子:
+
+URI：*https://ip:port/epayapi/services/charge/term/init*
+
+gid:10000014
+
+payroute:”1”
+
+amount:”10.4”
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+> *“retcode“:0，*
+>
+> *“retmsg“:”初始化成功”，*
+>
+> *“refno”:”20140809120901000001”*
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.20圈存充值
+
+Uri: *https://ip:port/epayapi/services/charge/term/qctrans*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|----------|----------------|----------|------|
+| gid | 客户端唯一标识 | 是 | |
+| payroute | 充值方式 | 是 | |
+| amount | 充值金额 | 是 | |
+| refno | 参考号 | 是 | |
+| paypwd | 支付密码 | 是 | |
+
+例子:
+
+URI：*https://ip:port/epayapi/services/charge/term/qctrans*
+
+gid:10000014
+
+payroute:”1”
+
+amount:”10.4”
+
+refno:”20140902103001000001”
+
+paypwd:123456
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+> *“retcode“:0，*
+>
+> *“retmsg“:”充值成功”，*
+>
+> *“refno”:”20140809120901000001”*
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
+#### 1.21圈存充值结果查询
+
+Uri: *https://ip:port/epayapi/services/charge/term/qcresultquery*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+| 名称 | 类型 | 是否必须 | 描述 |
+|----------|----------------|----------|------|
+| gid | 客户端唯一标识 | 是 | |
+| payroute | 充值方式 | 是 | |
+| amount | 充值金额 | 是 | |
+| refno | 参考号 | 是 | |
+
+例子:
+
+URI：*https://ip:port/epayapi/services/charge/term/qcresultquery*
+
+gid:10000014
+
+payroute:”1”
+
+amount:”10.4”
+
+refno:”20140902103001000001”
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+> *“retcode“:0，*
+>
+> *“retmsg“:”交易成功”，*
+>
+> *“refno”:”20140809120901000001”*
+>
+> *“successtime”:2014-05-05 10:43:29*
+
+}
+
+> **异常信息：**
+
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
+
diff --git "a/source/_posts/\344\270\200\345\215\241\351\200\232v5\345\271\263\345\217\260\347\273\210\347\253\257\346\216\245\345\217\243\346\226\207\346\241\243.md" "b/source/_posts/\344\270\200\345\215\241\351\200\232v5\345\271\263\345\217\260\347\273\210\347\253\257\346\216\245\345\217\243\346\226\207\346\241\243.md"
index 00d4f86..966e4af 100644
--- "a/source/_posts/\344\270\200\345\215\241\351\200\232v5\345\271\263\345\217\260\347\273\210\347\253\257\346\216\245\345\217\243\346\226\207\346\241\243.md"
+++ "b/source/_posts/\344\270\200\345\215\241\351\200\232v5\345\271\263\345\217\260\347\273\210\347\253\257\346\216\245\345\217\243\346\226\207\346\241\243.md"
@@ -4,1139 +4,27 @@
tags:
---
-[TOC]
+**修订历史**
+============
-## 修订历史
+| 版本 | 作者 | 日期 | 备注 |
+|--------|--------|------------|------------------|
+| V4.0.0 | 何林青 | 2015-01-06 | 初稿 |
+| v4.0.1 | 汤成 | 2016-3-16 | 增加设备相关接口 |
-| 版本 | 作者 | 日期 | 备注 |
-|-------- | --------| ------------| ------------------|
-| V4.0.0 | 何林青 | 2015-01-06 | 初稿 |
-| v4.0.1 | 汤成 | 2016-3-16 | 增加设备相关接口 |
-
+
## 前言
### 编写目的
+
本文档用于描述了易支付对外提供的所有api接口，包括提供手机app端和pos消费端，供内部业务依据此接口开发提供参考。
### 约定
-* 1. 传输编码统一utf-8
+1. 传输编码统一utf-8
-### 1. 系统结构描述
-## 1. 接口描述
-### **手机api功能入口**
-#### 注册绑定服务
-
-Uri: *https://ip:port/epayapi/services/bindservice*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
------------ -------- ---------- ---------------------
-uid String 是 从终端获取的唯一号
-phone String 否 手机号
-school String 是 学校代码
-userid String 是 学号
-username String 是 姓名
-idno String 是 身份证后六位
-timestamp String 是 手机时间戳
-platform String 是 手机平台android/ios
-
-例子:
-
-URI：https://ip:port/epayapi/services/bindservice
-
-uid:12309487839029
-
-phone:15089039087
-
-school:01
-
-userid:09893092
-
-username:王小二
-
-idno:092010
-
-timestamp:2015-01-19 13:09:01
-
-platform:android
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-"timestamp": "2015-01-19 16:25:29",
-
-"uid": "12309487839029",
-
-"gid": "10000021",
-
-> "rsapbulic":
-> "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCG3ADBVO/ngyMGlIZ6LM62CXrmBQ/lvuo6u/03\\r\\namCFHgxBC9U0E+AawCgf4tgVOzePxlmqqkFgh2NIySAL9e2qcqvUa2a3jjutAdmamfo6raofnr9G\\r\\nf6hO1LZp7NRR0cXgojJyXkTRvDdkR46ZUydMng2AXm6jNr1Sdg643OQ83QIDAQAB\\r\\n",
-
-"isfirstreg": false,
-
-"ispwdset": false
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 登录密码初始设置
-
-Uri: *https://ip:port/epayapi/services/auth/pwdset*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
------- -------- ---------- ----------
-gid String 是 客户端号
-pwd String 是 密码
-dpwd String 是 重复密码
-
-例子:
-
-URI：https://ip:port/epayapi/services*/auth*/*pwdset*
-
-gid:10000001
-
-pwd:123456
-
-dpwd:123456
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-"retcode":"0",
-
-"retmsg":"设置成功"
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 登录密码重置
-
-Uri: *https://ip:port/epayapi/services/auth/pwdreset*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
------- -------- ---------- ----------
-gid String 是 客户端号
-opwd String 是 原始密码
-pwd String 是 密码
-dpwd String 是 重复密码
-
-例子:
-
-URI：https://ip:port/epayapi/services*/auth*/*pwdset*
-
-gid:10000001
-
-opwd:654321
-
-pwd:123456
-
-dpwd:123456
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-"retcode":"0",
-
-"retmsg":"重置成功"
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 登录-设备授权码
-
-Uri: *https://ip:port/epayapi/services/oauth2/device*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
------------- -------- ---------- ---------------------------------------
-client\_id String 是 客户端标识,统一分配给平台指定客户端id
-type String 是 类型 device\_code/device\_token
-code String 否 验证码
-
-例子:
-
-URI：https://ip:port/epayapi/services/*oauth2/device*
-
-Client\_id:a9020b039900d9001
-
-type:device\_code
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-"retcode":"0",
-
-“code”:255409389383939
-
-“userCode”:1234,
-
-verifyURL:”/user/code”
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 登录-oauth授权
-
-Uri: *https://ip:port/epayapi/services/oauth2/authlogin*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
----------- -------- ---------- ------------------
-uid String 是 客户端唯一识别码
-gid String 是 终端编号
-school String 否 学校代码
-userid String 是 学工号
-pwd String 是 密码
-usercode String 否 验证码
-platform String 否 手机平台
-
-例子:
-
-URI：[*https://ip:port/epayapi/services/oauth2/authlogin*](https://ip:port/epayapi/services/oauth2/authlogin)
-
-uid:12309487839029
-
-gid:2000100002020101
-
-school:01
-
-userid:09893092
-
-pwd:123456
-
-usercode:092010
-
-platform:android
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-"retcode":"0",
-
-“gid”:2001902902909,
-
-“accname”:”小二”,
-
-“token”:abcde32423523cabb434,
-
-“expiresin”:149059504,
-
-“schoolcode”:”01”
-
-“secretkey”:iosdkfjhs9293i98421kljsjflksjfd
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 电控校区查询
-
-Uri: *https://ip:port/epayapi/services/elecfee/queryarea*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
------- ------ ---------- ------
-
-
-
-例子:
-
-URI：*https://ip:port/epayapi/services/elecfee/queryarea*
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-\["areaId":"1",
-
-"areaName":"A校区"\]，\["areaId":"2",
-
-"areaName":"B校区"\]
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 电控区域查询
-
-Uri: *https://ip:port/epayapi/services/elecfee/querydistricts*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
--------- -------- ---------- ------
-areaId 校区id 是
-
-
-例子:
-
-URI：*https://ip:port/epayapi/services/elecfee/querydistricts*
-
-areaId:1
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-\["districtId":"101",
-
-" districtName":"A区域"\]，\["districtId ":"102",
-
-"districtName ":"B区域"\]
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 电控楼栋查询
-
-Uri: *https://ip:port/epayapi/services/elecfee/querybuilds*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
------------- -------- ---------- ------
-areaId 校区id 是
-districtId 区域id 是
-
-例子:
-
-URI：*https://ip:port/epayapi/services/elecfee/querybuilds*
-
-areaId:1
-
-districtId:102
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-\["buildId":"101",
-
-" buildName":"al楼"\]，\["buildId ":"102",
-
-"buildName ":"B1楼"\]
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 电控楼层查询
-
-Uri: *https://ip:port/epayapi/services/elecfee/queryfloors*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
------------- -------- ---------- ------
-areaId 校区id 是
-districtId 区域id 是
-buildId 楼栋id 是
-
-例子:
-
-URI：*https://ip:port/epayapi/services/elecfee/queryfloors*
-
-areaId:1
-
-districtId:101
-
-buildId:3001
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-\["floorId":"101",
-
-" floorName":"1楼"\]，\["floorId ":"102",
-
-"floorName ":"2楼"\]
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 电控房间查询
-
-Uri: *https://ip:port/epayapi/services/elecfee/queryrooms*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
------------- -------- ---------- ------
-areaId 校区id 是
-districtId 区域id 是
-buildId 楼栋id 是
-floorId 楼层id 是
-
-例子:
-
-URI：*https://ip:port/epayapi/services/elecfee/queryrooms*
-
-areaId:1
-
-districtId:101
-
-buildId:3001
-
-floorId:1
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-\["roomId":"101",
-
-" roomName":"301"\]，\["roomId ":"102",
-
-"roomName ":"302"\]
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 电控房间电量信息查询
-
-Uri: *https://ip:port/epayapi/services/elecfee/queryroominfo*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
---------- -------- ---------- ------
-areaId 校区id 是
-buildId 楼栋id 是
-roomId 房间id 是
-
-
-例子:
-
-URI：*https://ip:port/epayapi/services/elecfee/queryroominfo*
-
-areaId:1
-
-buildId:3001
-
-roomId:1
-
-返回：
-
-> 返回格式：application/json
-
-{"areaId":"1",
-
-“buildId”:3001,
-
-“roomId”:1,
-
-" roomName":"301",
-
-“restElecDegree”:20.9
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 电控房间电量信息查询
-
-Uri: *https://ip:port/epayapi/services/elecfee/buyelectrity*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
------------- ---------------- ---------- --------
-areaId 校区id 是
-buildId 楼栋id 是
-roomId 房间id 是
-amount 充值金额 是 单位元
-gid 客户端唯一标识 是
-payrouteid 支付途径id 是
-paypwd 支付密码 是
-
-例子:
-
-URI：*https://ip:port/epayapi/services/elecfee/queryroominfo*
-
-areaId:1
-
-buildId:3001
-
-roomId:1
-
-amount:10.4
-
-gid:10000001
-
-payrouteid:1
-
-paypwd:123456
-
-返回：
-
-> 返回格式：application/json
-
-{"retcode":"0",
-
-“retmsg”:”充值成功”
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 账户信息查询
-
-Uri: *https://ip:port/epayapi/services/account/getaccountinfo*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
--------- ---------------- ---------- ------
-gid 客户端唯一标识 是
-userid 学号 是
-
-
-例子:
-
-URI：*https://ip:port/epayapi/services/account/getaccountinfo*
-
-gid:10000014
-
-userid:098298192
-
-返回：
-
-> 返回格式：application/json
-
-{ “accno”:1
-
-“accname“:”212”,
-
-“status“:1,
-
-“balance“:105,
-
-“availbal“:105,
-
-“frozebal“:0,
-
-“opendate“:”20140509”,
-
-“closedate”:null,
-
-“timelimit“:50,
-
-“daylimit“:100，
-
-Bankcards:1
-
-Schoolcards:1
-
-Schoolcollege:”A学院”
-
-Schoolprofessional:”武警”
-
-Schoolclass:”101”
-
-Mobile:”129839383993”
-
-Email:”sdkfj@kjsdf.com”
-
-Sex:”男”
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 账单列表查询
-
-Uri: *https://ip:port/epayapi/services/billservice/getbilldata*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
----------- ---------------- ---------- ----------
-gid 客户端唯一标识 是
-pageNo 页码 是
-billtype 账单类型 是 EPAY/YKT
-
-例子:
-
-URI：*https://ip:port/epayapi/services/billservice/getbilldata*
-
-gid:10000014
-
-pageNo:1
-
-billtype:”EPAY”
-
-返回：
-
-> 返回格式：application/json
-
-{\[
-
-> *“refno“:20392103929303，*
->
-> *“paytime“:20150802091029，*
->
-> *“billname“:”pos消费”,*
->
-> *“amount“:”10.9”,*
->
-> *“billtype“:”EPAY”,*
-
-“billstatus“:”2”,
-
-“tradetype”:2\],
-
-\[
-
-> *“refno“:20392103929303,*
->
-> *“paytime“:20150802091029,*
->
-> *“billname“:”pos消费”,*
->
-> *“amount“:”10.9”,*
->
-> *“billtype“:”EPAY”,*
-
-“billstatus“:”2”,
-
-“tradetype”:2\],
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 账单明细查询
-
-Uri: *https://ip:port/epayapi/services/billservice/getbilldetail*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
----------- ---------------- ---------- ----------
-gid 客户端唯一标识 是
-refno 参考号 是
-billtype 账单类型 是 EPAY/YKT
-
-例子:
-
-URI：*https://ip:port/epayapi/services/billservice/getbilldetail*
-
-gid:10000014
-
-refno:”2013040192029192”
-
-billtype:”EPAY”
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-> *“refno“:20392103929303*
->
-> *“paytime“:20150802091029*
->
-> *“billname“:”pos消费”*
->
-> *“amount“:”10.9”*
->
-> *“billtype“:”EPAY”*
-
-“billstatus“:”2”,
-
-“organname”:”财务处”,
-
-“paidmethod”:”卡余额”,
-
-“tradetype”:2}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 挂失卡查询
-
-Uri: *https://ip:port/epayapi/services/ykt/cardlist*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
------- ---------------- ---------- ------
-gid 客户端唯一标识 是
-
-
-
-例子:
-
-URI：*https://ip:port/epayapi/services/ykt/cardlist*
-
-gid:10000014
-
-返回：
-
-> 返回格式：application/json
-
-\[{
-
-> *“cardno“:100092*
->
-> *“cardphytypename“:cpu卡*
-
-}\]
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 卡挂失
-
-Uri: *https://ip:port/epayapi/services/ykt/cardloss*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
---------- ---------------- ---------- ------
-gid 客户端唯一标识 是
-cardno 卡号 是
-cardpwd 卡密码 是
-
-例子:
-
-URI：*https://ip:port/epayapi/services/ykt/cardloss*
-
-gid:10000014
-
-cardno:”100092”
-
-cardpwd:”111111”
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-> *“retcode“:0，*
->
-> *“retmsg“:”挂失成功”*
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 圈存银行卡列表查询
-
-Uri: *https://ip:port/epayapi/services/charge/bankcard/list*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
----------- ---------------- ---------- ------
-gid 客户端唯一标识 是
-payroute 充值方式 是
-
-
-例子:
-
-URI：*https://ip:port/epayapi/services/charge/bankcard/list*
-
-gid:10000014
-
-payroute:”1”
-
-返回：
-
-> 返回格式：application/json
-
-\[{
-
-> *“bankcardno“:1002920192393909，*
->
-> *“bankname“:”中国银行”，*
-
-}\]
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 充值初始化
-
-Uri: *https://ip:port/epayapi/services/charge/term/init*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
----------- ---------------- ---------- ------
-gid 客户端唯一标识 是
-payroute 充值方式 是
-amount 充值金额 是
-
-例子:
-
-URI：*https://ip:port/epayapi/services/charge/term/init*
-
-gid:10000014
-
-payroute:”1”
-
-amount:”10.4”
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-> *“retcode“:0，*
->
-> *“retmsg“:”初始化成功”，*
->
-> *“refno”:”20140809120901000001”*
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 圈存充值
-
-Uri: *https://ip:port/epayapi/services/charge/term/qctrans*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
----------- ---------------- ---------- ------
-gid 客户端唯一标识 是
-payroute 充值方式 是
-amount 充值金额 是
-refno 参考号 是
-paypwd 支付密码 是
-
-例子:
-
-URI：*https://ip:port/epayapi/services/charge/term/qctrans*
-
-gid:10000014
-
-payroute:”1”
-
-amount:”10.4”
-
-refno:”20140902103001000001”
-
-paypwd:123456
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-> *“retcode“:0，*
->
-> *“retmsg“:”充值成功”，*
->
-> *“refno”:”20140809120901000001”*
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-### 圈存充值结果查询
-
-Uri: *https://ip:port/epayapi/services/charge/term/qcresultquery*
-
-请求格式：application/x-www-form-urlencoded
-
-请求方式：post
-
-参数：
-
-名称 类型 是否必须 描述
----------- ---------------- ---------- ------
-gid 客户端唯一标识 是
-payroute 充值方式 是
-amount 充值金额 是
-refno 参考号 是
-
-
-例子:
-
-URI：*https://ip:port/epayapi/services/charge/term/qcresultquery*
-
-gid:10000014
-
-payroute:”1”
-
-amount:”10.4”
-
-refno:”20140902103001000001”
-
-返回：
-
-> 返回格式：application/json
-
-{
-
-> *“retcode“:0，*
->
-> *“retmsg“:”交易成功”，*
->
-> *“refno”:”20140809120901000001”*
->
-> *“successtime”:2014-05-05 10:43:29*
-
-}
-
-> **异常信息：**
-
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
-
-1. **终端消费功能入口**
---------------------
-
-1. ### 消费初始化
+### 2.终端消费功能入口
+#### 2.1 消费初始化
Uri: *https://ip:port/epayapi/services/consume/pos/init*
@@ -1146,18 +34,17 @@
参数：
-名称 类型 是否必须 描述
--------------- -------- ---------- ------------
-barcode String 是 客户支付码
-app\_id String 是 应用分配id
-term\_id String 是 终端id
-term\_no String 是 Psam卡号
-merchaccno String 是 商户号
-amount String 是 交易金额
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法
-
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|--------|----------|------------|
+| barcode | String | 是 | 客户支付码 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 终端id |
+| term\_no | String | 是 | Psam卡号 |
+| merchaccno | String | 是 | 商户号 |
+| amount | String | 是 | 交易金额 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法 |
例子:
@@ -1195,7 +82,7 @@
}
-### 消费确认
+#### 2.2消费确认
Uri: *https://ip:port/epayapi/services/consume/pos/confirm*
@@ -1205,15 +92,15 @@
参数：
-名称 类型 是否必须 描述
--------------- -------- ---------- ------------
-refno String 是 交易参考号
-app\_id String 是 应用分配id
-term\_id String 是 终端id
-term\_no String 是 Psam卡号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|--------|----------|------------|
+| refno | String | 是 | 交易参考号 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 终端id |
+| term\_no | String | 是 | Psam卡号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法 |
例子:
@@ -1249,7 +136,7 @@
}
-### 卡片信息查询
+#### 2.3卡片信息查询
Uri: *https://ip:port/epayapi/services/consume/pos/accquery*
@@ -1259,18 +146,18 @@
参数：
-名称 类型 是否必须 描述
------------------ --------- ---------- ------------------------------------------
-cardno Integer 是 卡号
-credittotal Long 否 授信消费总额
-creditpaycnt Integer 否 授信消费次数
-creditavailable Long 否 可用授信
-creditseqno Integer 否 授信序号
-sourcetype String 否 消费渠道来源cardreader/pos/thirdpart/dmt
-app\_id String 是 应用分配id
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|-----------------|---------|----------|--------------------------|
+| cardno | Integer | 是 | 卡号 |
+| credittotal | Long | 否 | 授信消费总额 |
+| creditpaycnt | Integer | 否 | 授信消费次数 |
+| creditavailable | Long | 否 | 可用授信 |
+| creditseqno | Integer | 否 | 授信序号 |
+| sourcetype | String | 否 | 消费渠道来源cardreader/pos/thirdpart/dmt |
+| app\_id | String | 是 | 应用分配id |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段cardno+credittotal+creditpaycnt+creditavailable+nTimestamp+session\_key
@@ -1310,7 +197,7 @@
备注：retcode=0为正常，其他非0为错误
-### 卡片在线消费
+#### 2.4卡片在线消费
Uri: *https://ip:port/epayapi/services/consume/pos/cardpay*
@@ -1320,26 +207,26 @@
参数：
-名称 类型 是否必须 描述
------------------ --------- -------------- ------------------------------------------
-termid Integer 是（二选一） 设备终端号
-devphyid String 是（二选一） 设备物理id
-termseqno Integer 是 设备终端流水号
-cardno Integer 是 卡号
-amount Long 是 消费金额（分）
-managefee Long 否 管理费（分）
-managefeetype String 否 管理费类型（discont,mealer,none,…）
-credittotal Long 否 授信消费总额
-creditpaycnt Integer 否 授信消费次数
-creditavailable Long 否 可用授信
-creditseqno Integer 否 授信序号
-creditflag Boolean 否 更新授信标识
-sourcetype String 否 消费渠道来源cardreader/pos/thirdpart/dmt
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|-----------------|---------|--------------|------------------------------------------|
+| termid | Integer | 是（二选一） | 设备终端号 |
+| devphyid | String | 是（二选一） | 设备物理id |
+| termseqno | Integer | 是 | 设备终端流水号 |
+| cardno | Integer | 是 | 卡号 |
+| amount | Long | 是 | 消费金额（分） |
+| managefee | Long | 否 | 管理费（分） |
+| managefeetype | String | 否 | 管理费类型（discont,mealer,none,…） |
+| credittotal | Long | 否 | 授信消费总额 |
+| creditpaycnt | Integer | 否 | 授信消费次数 |
+| creditavailable | Long | 否 | 可用授信 |
+| creditseqno | Integer | 否 | 授信序号 |
+| creditflag | Boolean | 否 | 更新授信标识 |
+| sourcetype | String | 否 | 消费渠道来源cardreader/pos/thirdpart/dmt |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段termid+devphyid+termseqno+cardno+amount+managefee+managefeetype+credittotal+creditpaycnt+creditavailable+creditflag+nTimestamp+session\_key
@@ -1405,10 +292,9 @@
备注：retcode=0为正常，其他非0为错误
-Needpwdconfirm
-如果交易金额超过单日累计或者单次限额，标识为true，需要密码确认，交易暂未成功，需要输入密码成功发送成功交易确认才完成交易。
+Needpwdconfirm 如果交易金额超过单日累计或者单次限额，标识为true，需要密码确认，交易暂未成功，需要输入密码成功发送成功交易确认才完成交易。
-### 卡片在线消费密码确认
+#### 2.5卡片在线消费密码确认
Uri: *https://ip:port/epayapi/services/consume/pos/cardpayconfirm*
@@ -1418,19 +304,19 @@
参数：
-名称 类型 是否必须 描述
--------------- --------- -------------- --------------------
-termid Integer 是（二选一） 设备终端号
-devphyid String 是（二选一） 设备物理id
-termseqno Integer 是 设备终端流水号
-accdate String 是 记账日期
-refno String 是 交易参考号
-issuccess boolean 是 密码校验是否成功
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|---------|--------------|--------------------|
+| termid | Integer | 是（二选一） | 设备终端号 |
+| devphyid | String | 是（二选一） | 设备物理id |
+| termseqno | Integer | 是 | 设备终端流水号 |
+| accdate | String | 是 | 记账日期 |
+| refno | String | 是 | 交易参考号 |
+| issuccess | boolean | 是 | 密码校验是否成功 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段termid+devphyid+termseqno+accdate+refno+issuccess+nTimestamp+session\_key
@@ -1484,7 +370,7 @@
备注：retcode=0为正常，其他非0为错误
-### 卡片在线消费充正
+#### 2.6卡片在线消费充正
Uri: *https://ip:port/epayapi/services/consume/pos/cardpayreverse*
@@ -1494,23 +380,22 @@
参数：
-名称 类型 是否必须 描述
------------------- ----------- -------------- -------------------------
-termid Integer 是（二选一） 设备终端号
-devphyid String 是（二选一） 设备物理id
-termseqno Integer 是 设备终端流水号
-reversetermseqno Integer 是 充正终端流水号
-reversalflag String 是 充正类型CANCEL/REVERSAL
-termdate String(8) 否 充正日期YYYYMMDD
-termtime String(6) 否 充正时间HH24MISS
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|------------------|-----------|--------------|-------------------------|
+| termid | Integer | 是（二选一） | 设备终端号 |
+| devphyid | String | 是（二选一） | 设备物理id |
+| termseqno | Integer | 是 | 设备终端流水号 |
+| reversetermseqno | Integer | 是 | 充正终端流水号 |
+| reversalflag | String | 是 | 充正类型CANCEL/REVERSAL |
+| termdate | String(8) | 否 | 充正日期YYYYMMDD |
+| termtime | String(6) | 否 | 充正时间HH24MISS |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
-签名字段termid+devphyid+termseqno+reversetermseqno
-+nTimestamp+session\_key
+签名字段termid+devphyid+termseqno+reversetermseqno +nTimestamp+session\_key
例子:
@@ -1554,7 +439,7 @@
备注：retcode=0为正常，其他非0为错误
-### 卡片授信消费流水上传
+#### 2.7卡片授信消费流水上传
Uri: *https://ip:port/epayapi/services/consume/pos/creditdtlupload*
@@ -1564,39 +449,38 @@
参数：
-名称 类型 是否必须 描述
---------------------- --------- ---------- -----------------------------------------
-devphyid String 是 设备物理id
-termseqno Integer 是 设备终端流水号
-transdate String 是 交易日期
-transtime String 是 交易时间
-cardno Integer 是 卡号
-amount Long 是 消费金额（分）
-managefee Long 否 管理费（分）
-managefeetype String 否 管理费类型（discont,mealer,none,…）
-credittotal Long 否 授信消费总额
-creditpaycnt Integer 否 授信消费次数
-creditavailable Long 否 可用授信
-creditseqno Integer 否 授信序号
-lastdevphyid String 是 上次设备物理id
-lasttermseqno Integer 是 上次设备终端流水号
-lasttransdate String 是 上次交易日期
-lasttranstime String 是 上次交易时间
-lastamount Long 是 上次消费金额（分）
-lastmanagefee Long 否 上次管理费（分）
-lastmanagefeetype String 否 上次管理费类型（discont,mealer,none,…）
-lastcreditavailable Long 否 上次可用授信
-lastcreditseqno Integer 否 上次授信序号
-available boolean 是 是否可用
-reversalflag Boolean 是 充正标识
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|---------------------|---------|----------|-----------------------------------------|
+| devphyid | String | 是 | 设备物理id |
+| termseqno | Integer | 是 | 设备终端流水号 |
+| transdate | String | 是 | 交易日期 |
+| transtime | String | 是 | 交易时间 |
+| cardno | Integer | 是 | 卡号 |
+| amount | Long | 是 | 消费金额（分） |
+| managefee | Long | 否 | 管理费（分） |
+| managefeetype | String | 否 | 管理费类型（discont,mealer,none,…） |
+| credittotal | Long | 否 | 授信消费总额 |
+| creditpaycnt | Integer | 否 | 授信消费次数 |
+| creditavailable | Long | 否 | 可用授信 |
+| creditseqno | Integer | 否 | 授信序号 |
+| lastdevphyid | String | 是 | 上次设备物理id |
+| lasttermseqno | Integer | 是 | 上次设备终端流水号 |
+| lasttransdate | String | 是 | 上次交易日期 |
+| lasttranstime | String | 是 | 上次交易时间 |
+| lastamount | Long | 是 | 上次消费金额（分） |
+| lastmanagefee | Long | 否 | 上次管理费（分） |
+| lastmanagefeetype | String | 否 | 上次管理费类型（discont,mealer,none,…） |
+| lastcreditavailable | Long | 否 | 上次可用授信 |
+| lastcreditseqno | Integer | 否 | 上次授信序号 |
+| available | boolean | 是 | 是否可用 |
+| reversalflag | Boolean | 是 | 充正标识 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
-签名字段devphyid+termseqno+transdate+transtime+cardno+amount+managefee+managefeetype+credittotal+creditpaycnt+creditavailable
-+nTimestamp+session\_key
+签名字段devphyid+termseqno+transdate+transtime+cardno+amount+managefee+managefeetype+credittotal+creditpaycnt+creditavailable +nTimestamp+session\_key
例子:
@@ -1672,7 +556,7 @@
备注：retcode=0为正常，其他非0为错误
-### 卡片充值
+#### 2.8卡片充值
Uri: *https://ip:port/epayapi/services/charge/pos/confirmcharge*
@@ -1682,27 +566,27 @@
参数：
-名称 类型 是否必须 描述
------------------ --------- -------------- ----------------------------
-termid Integer 是（二选一） 设备终端号
-devphyid String 是（二选一） 设备物理id
-termseqno Integer 是 设备终端流水号
-cardno Integer 是 卡号
-fundtype Integer 是 资金类型1现金,2支票3经费本
-voucherno String 否 支票/经费本号
-amount Long 是 消费金额（分）
-opercode String 是 操作员号
-credittotal Long 否 授信消费总额
-creditpaycnt Integer 否 授信消费次数
-creditavailable Long 否 可用授信
-creditseqno Integer 否 授信序号
-creditflag Boolean 否 更新授信标识
-sourcetype String 否 消费渠道来源cardreader/pos
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|-----------------|---------|--------------|----------------------------|
+| termid | Integer | 是（二选一） | 设备终端号 |
+| devphyid | String | 是（二选一） | 设备物理id |
+| termseqno | Integer | 是 | 设备终端流水号 |
+| cardno | Integer | 是 | 卡号 |
+| fundtype | Integer | 是 | 资金类型1现金,2支票3经费本 |
+| voucherno | String | 否 | 支票/经费本号 |
+| amount | Long | 是 | 消费金额（分） |
+| opercode | String | 是 | 操作员号 |
+| credittotal | Long | 否 | 授信消费总额 |
+| creditpaycnt | Integer | 否 | 授信消费次数 |
+| creditavailable | Long | 否 | 可用授信 |
+| creditseqno | Integer | 否 | 授信序号 |
+| creditflag | Boolean | 否 | 更新授信标识 |
+| sourcetype | String | 否 | 消费渠道来源cardreader/pos |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段termid+devphyid+termseqno+cardno+fundtype+voucherno+amount+opercode+credittotal+creditpaycnt+creditavailable+creditflag+nTimestamp+session\_key
@@ -1766,7 +650,7 @@
备注：retcode=0为正常，其他非0为错误
-### 卡片充值充正
+#### 2.9卡片充值充正
Uri: *https://ip:port/epayapi/services/charge/pos/chargereverse*
@@ -1776,20 +660,19 @@
参数：
-名称 类型 是否必须 描述
------------------- --------- -------------- --------------------
-termid Integer 是（二选一） 设备终端号
-devphyid String 是（二选一） 设备物理id
-termseqno Integer 是 设备终端流水号
-reversetermseqno Integer 是 充正终端流水号
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|------------------|---------|--------------|--------------------|
+| termid | Integer | 是（二选一） | 设备终端号 |
+| devphyid | String | 是（二选一） | 设备物理id |
+| termseqno | Integer | 是 | 设备终端流水号 |
+| reversetermseqno | Integer | 是 | 充正终端流水号 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
-签名字段termid+devphyid+termseqno+reversetermseqno
-+nTimestamp+session\_key
+签名字段termid+devphyid+termseqno+reversetermseqno +nTimestamp+session\_key
例子:
@@ -1827,7 +710,7 @@
备注：retcode=0为正常，其他非0为错误
-### 终端流水号查询
+#### 2.10终端流水号查询
Uri: *https://ip:port/epayapi/services/consume/term/cardpaysearch*
@@ -1837,16 +720,16 @@
参数：
-名称 类型 是否必须 描述
--------------- --------- ---------- ----------------------------
-termid Integer 是 设备终端号
-termseqno Integer 是 终端当前流水号
-sourcetype String 否 消费渠道来源cardreader/pos
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|---------|----------|----------------------------|
+| termid | Integer | 是 | 设备终端号 |
+| termseqno | Integer | 是 | 终端当前流水号 |
+| sourcetype | String | 否 | 消费渠道来源cardreader/pos |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段termid+termseqno +nTimestamp+session\_key
@@ -1886,7 +769,7 @@
备注：retcode=0为正常，其他非0为错误
-### 水控流水上传
+#### 2.11水控流水上传
Uri: *https://ip:port/epayapi/services/consume/pos/waterdtlupload*
@@ -1896,21 +779,21 @@
参数：
-名称 类型 是否必须 描述
--------------- --------- ---------- --------------------
-devphyid String 是 设备物理id
-termseqno Integer 是 设备终端流水号
-transdate String 是 交易日期
-transtime String 是 交易时间
-cardno Integer 是 卡号
-amount Long 是 消费金额（分）
-available boolean 是 是否可用
-reversalflag Boolean 是 充正标识
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|---------|----------|--------------------|
+| devphyid | String | 是 | 设备物理id |
+| termseqno | Integer | 是 | 设备终端流水号 |
+| transdate | String | 是 | 交易日期 |
+| transtime | String | 是 | 交易时间 |
+| cardno | Integer | 是 | 卡号 |
+| amount | Long | 是 | 消费金额（分） |
+| available | boolean | 是 | 是否可用 |
+| reversalflag | Boolean | 是 | 充正标识 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段devphyid+termseqno+transdate+transtime+cardno+amount+nTimestamp+session\_key
@@ -1958,7 +841,7 @@
备注：retcode=0为正常，其他非0为错误
-### 终端设备签到
+#### 2.12终端设备签到
Uri: *https://ip:port/epayapi/services/consume/pos/login*
@@ -1968,24 +851,23 @@
参数：
-名称 类型 是否必须 描述
--------------- --------- ---------- ------------------
-devphyid String 是 设备物理id
-termtype String 是 终端类型，SWPOS
-termdate String 是 交易日期
-termtime String 是 交易时间
-deviceno Integer 是 终端机号
-devseqno Integer 是 终端流水号
-termno String 是 SAM 卡号
-paraverno intger 是 设备参数版本号
-cardverno String 是 黑名单版本号
-feeverno Integer 是 卡权限费率版本号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|---------|----------|------------------|
+| devphyid | String | 是 | 设备物理id |
+| termtype | String | 是 | 终端类型，SWPOS |
+| termdate | String | 是 | 交易日期 |
+| termtime | String | 是 | 交易时间 |
+| deviceno | Integer | 是 | 终端机号 |
+| devseqno | Integer | 是 | 终端流水号 |
+| termno | String | 是 | SAM 卡号 |
+| paraverno | intger | 是 | 设备参数版本号 |
+| cardverno | String | 是 | 黑名单版本号 |
+| feeverno | Integer | 是 | 卡权限费率版本号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
-签名字段devphyid+termtype+deviceno+termno+paraverno+cardverno+feeverno
-+nTimestamp+session\_key
+签名字段devphyid+termtype+deviceno+termno+paraverno+cardverno+feeverno +nTimestamp+session\_key
例子:
@@ -2051,7 +933,7 @@
备注：retcode=0为正常，其他非0为错误
-### 下载设备黑名单位图
+#### 2.13下载设备黑名单位图
Uri: *https://ip:port/epayapi/services/consume/pos/blacklistbitmap*
@@ -2061,17 +943,17 @@
参数：
-名称 类型 是否必须 描述
--------------- --------- ---------- ---------------------------
-devphyid String 是 设备物理id
-termid Integer 是 终端ID号
-blkindex Integer 是 黑名单位图索引号，从0开始
-cardverno String 是 设备黑名单版本号
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|---------|----------|---------------------------|
+| devphyid | String | 是 | 设备物理id |
+| termid | Integer | 是 | 终端ID号 |
+| blkindex | Integer | 是 | 黑名单位图索引号，从0开始 |
+| cardverno | String | 是 | 设备黑名单版本号 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段devphyid+termid+blkindex+cardverno +nTimestamp+session\_key
@@ -2115,7 +997,7 @@
备注：retcode=0为正常，其他非0为错误
-### 增量下载黑名单
+#### 2.14增量下载黑名单
Uri: *https://ip:port/epayapi/services/consume/pos/downloadblacklist*
@@ -2125,17 +1007,17 @@
参数：
-名称 类型 是否必须 描述
--------------- --------- ---------- --------------------
-devphyid String 是 设备物理id
-termid Integer 是 设备ID
-cardverno String 是 设备黑名单版本号
-maxcount Integer 是 最大返回黑名单条数
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|---------|----------|--------------------|
+| devphyid | String | 是 | 设备物理id |
+| termid | Integer | 是 | 设备ID |
+| cardverno | String | 是 | 设备黑名单版本号 |
+| maxcount | Integer | 是 | 最大返回黑名单条数 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段devphyid+termid+cardverno+maxcount+nTimestamp+session\_key
@@ -2179,7 +1061,7 @@
备注：retcode=0为正常，其他非0为错误
-### 设备心跳
+#### 2.15设备心跳
Uri: *https://ip:port/epayapi/services/consume/pos/heartbeat*
@@ -2189,23 +1071,23 @@
参数：
-名称 类型 是否必须 描述
--------------- --------- ---------- ----------------------
-devphyid String 是 设备物理id
-termid Integer 是 设备ID
-termdate String 是 终端日期
-termtime String 是 终端时间
-termtype String 是 终端标志 SWPOS
-termno String 是 SAM卡号
-devseqno Integer 是 设备流水号
-paraverno Integer 是 系统参数版本
-feeverno Integer 是 卡权限及费率参数版本
-cardverno String 是 黑名单版本号
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|---------|----------|----------------------|
+| devphyid | String | 是 | 设备物理id |
+| termid | Integer | 是 | 设备ID |
+| termdate | String | 是 | 终端日期 |
+| termtime | String | 是 | 终端时间 |
+| termtype | String | 是 | 终端标志 SWPOS |
+| termno | String | 是 | SAM卡号 |
+| devseqno | Integer | 是 | 设备流水号 |
+| paraverno | Integer | 是 | 系统参数版本 |
+| feeverno | Integer | 是 | 卡权限及费率参数版本 |
+| cardverno | String | 是 | 黑名单版本号 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段devphyid+termid+paraverno+feeverno+cardverno+nTimestamp+session\_key
@@ -2271,7 +1153,7 @@
备注：retcode=0为正常，其他非0为错误
-### 下载设备参数
+#### 2.16下载设备参数
Uri: *https://ip:port/epayapi/services/consume/pos/updatesyspara*
@@ -2281,20 +1163,20 @@
参数：
-名称 类型 是否必须 描述
--------------- --------- ---------- --------------------
-devphyid String 是 设备物理id
-termid Integer 是 设备ID
-termdate String 是 终端日期
-termtime String 是 终端时间
-termtype String 是 终端标识, SWPOS
-paragroupid Integer 是 参数组号
-classname String 是 参数分类， syspara
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|---------|----------|--------------------|
+| devphyid | String | 是 | 设备物理id |
+| termid | Integer | 是 | 设备ID |
+| termdate | String | 是 | 终端日期 |
+| termtime | String | 是 | 终端时间 |
+| termtype | String | 是 | 终端标识, SWPOS |
+| paragroupid | Integer | 是 | 参数组号 |
+| classname | String | 是 | 参数分类， syspara |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段devphyid+termid+paragroupid+classname+nTimestamp+session\_key
@@ -2344,7 +1226,7 @@
备注：retcode=0为正常，其他非0为错误
-### 下载设备卡权限费率
+#### 2.17下载设备卡权限费率
Uri: *https://ip:port/epayapi/services/consume/pos/updatefeecfg*
@@ -2354,16 +1236,16 @@
参数：
-名称 类型 是否必须 描述
--------------- --------- ---------- --------------------
-devphyid String 是 设备物理id
-termid Integer 是 设备ID
-devcfgverno Integer 是 设备参数版本
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|---------|----------|--------------------|
+| devphyid | String | 是 | 设备物理id |
+| termid | Integer | 是 | 设备ID |
+| devcfgverno | Integer | 是 | 设备参数版本 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段devphyid+termid+devcfgverno+nTimestamp+session\_key
@@ -2401,7 +1283,7 @@
备注：retcode=0为正常，其他非0为错误
-### B Mode 消费流水上传
+#### 2.18 B Mode 消费流水上传
Uri: *https://ip:port/epayapi/services/consume/pos/bmodeuploadrecord*
@@ -2411,35 +1293,35 @@
参数：
-名称 类型 是否必须 描述
---------------- --------- ---------- ------------------------------------------------------
-devphyid String 是 设备物理id
-termseqno Integer 是 设备终端流水号
-transdate String 是 交易日期
-transtime String 是 交易时间
-cardno Integer 是 卡号
-amount Long 是 交易金额（分）
-payamt Long 是 实际扣款金额（分）
-cardbefbal Long 是 卡交易前余额（分）
-cardaftbal Long 是 卡交易后余额（分）
-feeamt Long 是 折扣/搭伙费金额（分）
-paycnt Integer 是 卡交易前次数
-withpasswd Boolean 是 是否启用密码消费
-termno String 是 SAM卡号
-tac String 是 Tac
-datatype String 是 记录类型10-正常，20-带搭伙费，30-带折扣，80-锁卡流水
-sendtype Integer 是 交易模式，2-批上送
-updresult Integer 是 写卡结果，9-写卡成功，2-中途拔卡，0-未写卡
-lasttranstime String 否 上笔交易日期时间
-lasttermno String 否 上一笔交易终端
-lastamt Long 否 上一笔交易金额
-lasttranscnt Integer 否 上一笔交易前次数
-lasttransflag Integer 否 上一笔交易标识
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|---------------|---------|----------|------------------------------------------------------|
+| devphyid | String | 是 | 设备物理id |
+| termseqno | Integer | 是 | 设备终端流水号 |
+| transdate | String | 是 | 交易日期 |
+| transtime | String | 是 | 交易时间 |
+| cardno | Integer | 是 | 卡号 |
+| amount | Long | 是 | 交易金额（分） |
+| payamt | Long | 是 | 实际扣款金额（分） |
+| cardbefbal | Long | 是 | 卡交易前余额（分） |
+| cardaftbal | Long | 是 | 卡交易后余额（分） |
+| feeamt | Long | 是 | 折扣/搭伙费金额（分） |
+| paycnt | Integer | 是 | 卡交易前次数 |
+| withpasswd | Boolean | 是 | 是否启用密码消费 |
+| termno | String | 是 | SAM卡号 |
+| tac | String | 是 | Tac |
+| datatype | String | 是 | 记录类型10-正常，20-带搭伙费，30-带折扣，80-锁卡流水 |
+| sendtype | Integer | 是 | 交易模式，2-批上送 |
+| updresult | Integer | 是 | 写卡结果，9-写卡成功，2-中途拔卡，0-未写卡 |
+| lasttranstime | String | 否 | 上笔交易日期时间 |
+| lasttermno | String | 否 | 上一笔交易终端 |
+| lastamt | Long | 否 | 上一笔交易金额 |
+| lasttranscnt | Integer | 否 | 上一笔交易前次数 |
+| lasttransflag | Integer | 否 | 上一笔交易标识 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段devphyid+termseqno+transdate+transtime+cardno+amount+paycnt+cardbefbal
@@ -2515,10 +1397,8 @@
备注：retcode=0为正常，其他非0为错误
-1. **多媒体对接功能入口**
-----------------------
-
-1. ### 充值初始化
+### 3.多媒体对接功能入口
+#### 3.1充值初始化
Uri: *https://ip:port/epayapi/services/charge/dmtqc/init*
@@ -2528,17 +1408,17 @@
参数：
-名称 类型 是否必须 描述
--------------- --------- ---------- --------------------
-termid Integer 是 设备终端号
-termseqno Integer 是 设备终端流水号
-cardno Integer 是 卡号
-amount Long 是 消费金额（分）
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|---------|----------|--------------------|
+| termid | Integer | 是 | 设备终端号 |
+| termseqno | Integer | 是 | 设备终端流水号 |
+| cardno | Integer | 是 | 卡号 |
+| amount | Long | 是 | 消费金额（分） |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段termid +termseqno+cardno+amount+nTimestamp+session\_key
@@ -2578,13 +1458,13 @@
> **异常信息：**
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
-### 圈存充值
+#### 3.2圈存充值
Uri: *https://ip:port/epayapi/services/charge/dmtqc/transfer*
@@ -2594,17 +1474,17 @@
参数：
-名称 类型 是否必须 描述
--------------- --------- ---------- --------------------
-termid Integer 是 设备终端号
-refno String 是 参考号
-cardno Integer 是 卡号
-amount Long 是 消费金额（分）
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|---------|----------|--------------------|
+| termid | Integer | 是 | 设备终端号 |
+| refno | String | 是 | 参考号 |
+| cardno | Integer | 是 | 卡号 |
+| amount | Long | 是 | 消费金额（分） |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段termid+refno+ cardno+amount+nTimestamp+session\_key
@@ -2644,13 +1524,13 @@
> **异常信息：**
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
-### 圈存充值结果查询
+#### 3.3圈存充值结果查询
Uri: *https://ip:port/epayapi/services/charge/dmtqc/resultquery*
@@ -2660,15 +1540,15 @@
参数：
-名称 类型 是否必须 描述
--------------- --------- ---------- --------------------
-termid Integer 是 设备终端号
-refno String 是 参考号
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|---------|----------|--------------------|
+| termid | Integer | 是 | 设备终端号 |
+| refno | String | 是 | 参考号 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段termid+refno+ cardno+amount+nTimestamp+session\_key
@@ -2706,13 +1586,13 @@
> **异常信息：**
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
-### 终端在线消费（第三方/多媒体）
+#### 3.4终端在线消费（第三方/多媒体）
Uri: *https://ip:port/epayapi/services/consume/dmtterm/cardpay*
@@ -2722,27 +1602,27 @@
参数：
-名称 类型 是否必须 描述
------------------ --------- -------------- -------------------------------------
-termid Integer 是（二选一） 设备终端号
-devphyid String 是（二选一） 设备物理id
-termseqno Integer 是 设备终端流水号
-cardno Integer 是 卡号
-amount Long 是 消费金额（分）
-managefee Long 否 管理费（分）
-managefeetype String 否 管理费类型（discont,mealer,none,…）
-credittotal Long 否 授信消费总额
-creditpaycnt Integer 否 授信消费次数
-creditavailable Long 否 可用授信
-creditseqno Integer 否 授信序号
-creditflag Boolean 否 更新授信标识
-shopid Integer 否 商户号（只有多媒体启用）
-sourcetype String 否 消费渠道来源cardreader/pos/dmt
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|-----------------|---------|--------------|-------------------------------------|
+| termid | Integer | 是（二选一） | 设备终端号 |
+| devphyid | String | 是（二选一） | 设备物理id |
+| termseqno | Integer | 是 | 设备终端流水号 |
+| cardno | Integer | 是 | 卡号 |
+| amount | Long | 是 | 消费金额（分） |
+| managefee | Long | 否 | 管理费（分） |
+| managefeetype | String | 否 | 管理费类型（discont,mealer,none,…） |
+| credittotal | Long | 否 | 授信消费总额 |
+| creditpaycnt | Integer | 否 | 授信消费次数 |
+| creditavailable | Long | 否 | 可用授信 |
+| creditseqno | Integer | 否 | 授信序号 |
+| creditflag | Boolean | 否 | 更新授信标识 |
+| shopid | Integer | 否 | 商户号（只有多媒体启用） |
+| sourcetype | String | 否 | 消费渠道来源cardreader/pos/dmt |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段termid+devphyid+termseqno+cardno+amount+managefee+managefeetype+credittotal+creditpaycnt+creditavailable+creditflag+shopid+nTimestamp+session\_key
@@ -2810,10 +1690,9 @@
备注：retcode=0为正常，其他非0为错误
-Needpwdconfirm
-如果交易金额超过单日累计或者单次限额，标识为true，需要密码确认，交易暂未成功，需要输入密码成功发送成功交易确认才完成交易。(目前只有需要pos输入密码)
+Needpwdconfirm 如果交易金额超过单日累计或者单次限额，标识为true，需要密码确认，交易暂未成功，需要输入密码成功发送成功交易确认才完成交易。(目前只有需要pos输入密码)
-### 终端在线消费充正
+#### 3.5终端在线消费充正
Uri: *https://ip:port/epayapi/services/consume/dmtterm/cardpayreverse*
@@ -2823,20 +1702,19 @@
参数：
-名称 类型 是否必须 描述
------------------- --------- -------------- --------------------
-termid Integer 是（二选一） 设备终端号
-devphyid String 是（二选一） 设备物理id
-termseqno Integer 是 设备终端流水号
-reversetermseqno Integer 是 充正终端流水号
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|------------------|---------|--------------|--------------------|
+| termid | Integer | 是（二选一） | 设备终端号 |
+| devphyid | String | 是（二选一） | 设备物理id |
+| termseqno | Integer | 是 | 设备终端流水号 |
+| reversetermseqno | Integer | 是 | 充正终端流水号 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
-签名字段termid+devphyid+termseqno+reversetermseqno
-+nTimestamp+session\_key
+签名字段termid+devphyid+termseqno+reversetermseqno +nTimestamp+session\_key
例子:
@@ -2874,7 +1752,7 @@
备注：retcode=0为正常，其他非0为错误
-### 水控转账（多媒体）
+#### 3.6水控转账（多媒体）
Uri: *https://ip:port/epayapi/services/consume/dmtterm/watertrans*
@@ -2884,27 +1762,27 @@
参数：
-名称 类型 是否必须 描述
------------------ --------- -------------- -------------------------------------
-termid Integer 是（二选一） 设备终端号
-devphyid String 是（二选一） 设备物理id
-termseqno Integer 是 设备终端流水号
-cardno Integer 是 卡号
-amount Long 是 消费金额（分）
-managefee Long 否 管理费（分）
-managefeetype String 否 管理费类型（discont,mealer,none,…）
-credittotal Long 否 授信消费总额
-creditpaycnt Integer 否 授信消费次数
-creditavailable Long 否 可用授信
-creditseqno Integer 否 授信序号
-creditflag Boolean 否 更新授信标识
-shopid Integer 否 商户号（只有多媒体启用）
-sourcetype String 否 消费渠道来源cardreader/pos/dmt
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|-----------------|---------|--------------|-------------------------------------|
+| termid | Integer | 是（二选一） | 设备终端号 |
+| devphyid | String | 是（二选一） | 设备物理id |
+| termseqno | Integer | 是 | 设备终端流水号 |
+| cardno | Integer | 是 | 卡号 |
+| amount | Long | 是 | 消费金额（分） |
+| managefee | Long | 否 | 管理费（分） |
+| managefeetype | String | 否 | 管理费类型（discont,mealer,none,…） |
+| credittotal | Long | 否 | 授信消费总额 |
+| creditpaycnt | Integer | 否 | 授信消费次数 |
+| creditavailable | Long | 否 | 可用授信 |
+| creditseqno | Integer | 否 | 授信序号 |
+| creditflag | Boolean | 否 | 更新授信标识 |
+| shopid | Integer | 否 | 商户号（只有多媒体启用） |
+| sourcetype | String | 否 | 消费渠道来源cardreader/pos/dmt |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段termid+devphyid+termseqno+cardno+amount+managefee+managefeetype+credittotal+creditpaycnt+creditavailable+creditflag+shopid+nTimestamp+session\_key
@@ -2972,10 +1850,9 @@
备注：retcode=0为正常，其他非0为错误
-Needpwdconfirm
-如果交易金额超过单日累计或者单次限额，标识为true，需要密码确认，交易暂未成功，需要输入密码成功发送成功交易确认才完成交易。(目前只有需要pos输入密码)
+Needpwdconfirm 如果交易金额超过单日累计或者单次限额，标识为true，需要密码确认，交易暂未成功，需要输入密码成功发送成功交易确认才完成交易。(目前只有需要pos输入密码)
-### 水控转账小钱包写卡确认（多媒体）
+#### 3.7水控转账小钱包写卡确认（多媒体）
Uri: *https://ip:port/epayapi/services/consume/dmtterm/waterconfirm*
@@ -2985,20 +1862,20 @@
参数：
-名称 类型 是否必须 描述
--------------- --------- -------------- --------------------
-termid Integer 是（二选一） 设备终端号
-devphyid String 是（二选一） 设备物理id
-refno String 是 转账流水号
-cardno Integer 是 卡号
-pursetype Short 是 水控钱包类型
-waterisok Boolean 是 水控是否成功
-waterisbreak Boolean 是 水控是否中途拔卡
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|---------|--------------|--------------------|
+| termid | Integer | 是（二选一） | 设备终端号 |
+| devphyid | String | 是（二选一） | 设备物理id |
+| refno | String | 是 | 转账流水号 |
+| cardno | Integer | 是 | 卡号 |
+| pursetype | Short | 是 | 水控钱包类型 |
+| waterisok | Boolean | 是 | 水控是否成功 |
+| waterisbreak | Boolean | 是 | 水控是否中途拔卡 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段termid+devphyid+refno+cardno+waterisok+waterisbereak+nTimestamp+session\_key
@@ -3040,10 +1917,8 @@
备注：retcode=0为正常，其他非0为错误
-1. **支付宝前置对接功能入口**
---------------------------
-
-1. ### 支付宝充值初始化
+### 4.支付宝前置对接功能入口
+#### 4.1支付宝充值初始化
Uri: *https://ip:port/epayapi/services/charge/alipay/init*
@@ -3053,15 +1928,15 @@
参数：
-名称 类型 是否必须 描述
--------------- -------- ---------- --------------------
-stuempno String 是 学工号
-amount Long 是 消费金额（分）
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|--------|----------|--------------------|
+| stuempno | String | 是 | 学工号 |
+| amount | Long | 是 | 消费金额（分） |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段stuempno+amount+nTimestamp+session\_key
@@ -3097,13 +1972,13 @@
> **异常信息：**
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
-### 支付宝充值确认
+#### 4.2支付宝充值确认
Uri: *https://ip:port/epayapi/services/charge/alipay/confirm*
@@ -3113,16 +1988,16 @@
参数：
-名称 类型 是否必须 描述
--------------- -------- ---------- --------------------
-stuempno String 是 学工号
-refno String 是 交易参考号
-amount Long 是 消费金额（分）
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|--------|----------|--------------------|
+| stuempno | String | 是 | 学工号 |
+| refno | String | 是 | 交易参考号 |
+| amount | Long | 是 | 消费金额（分） |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段stuempno+refno+amount+nTimestamp+session\_key
@@ -3160,16 +2035,14 @@
> **异常信息：**
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
-1. **第三方对接功能入口**
-----------------------
-
-1. ### 换卡初始化
+### 5. 第三方对接功能
+#### 5.1换卡初始化
Uri: *https://ip:port/epayapi/services/consume/zzsb/init*
@@ -3179,15 +2052,15 @@
参数：
-名称 类型 是否必须 描述
--------------- -------- ---------- --------------------
-idno String 是 身份证号
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
-
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|--------|----------|--------------------|
+| idno | String | 是 | 身份证号 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
+| | | | |
签名字段idno+nTimestamp+session\_key
@@ -3231,13 +2104,13 @@
}
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
-### 换卡请求
+#### 5.2换卡请求
Uri: *https://ip:port/epayapi/services/consume/zzsb/renewcard*
@@ -3247,24 +2120,23 @@
参数：
-名称 类型 是否必须 描述
------------------ -------- ---------- --------------------
-opercode String 是 操作员号
-checksum String 是 校验码
-operseqno String 是 操作员流水号
-oldcardno String 是 老卡卡号
-newcardphyid String 是 新卡物理卡号
-cardphytypecode String 是 卡物理类型
-feeamt String 是 卡成本费
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
-
+| 名称 | 类型 | 是否必须 | 描述 |
+|-----------------|--------|----------|--------------------|
+| opercode | String | 是 | 操作员号 |
+| checksum | String | 是 | 校验码 |
+| operseqno | String | 是 | 操作员流水号 |
+| oldcardno | String | 是 | 老卡卡号 |
+| newcardphyid | String | 是 | 新卡物理卡号 |
+| cardphytypecode | String | 是 | 卡物理类型 |
+| feeamt | String | 是 | 卡成本费 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
+| | | | |
-签名字段opercode+checksum+operseqno+oldcardno+newcardphyid+cardphytypecode+feeamt
-+nTimestamp+session\_key
+签名字段opercode+checksum+operseqno+oldcardno+newcardphyid+cardphytypecode+feeamt +nTimestamp+session\_key
例子:
@@ -3358,13 +2230,13 @@
}
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
-### 换卡确认
+#### 5.3换卡确认
Uri: *https://ip:port/epayapi/services/consume/zzsb/renewcardconfirm*
@@ -3374,18 +2246,18 @@
参数：
-名称 类型 是否必须 描述
--------------- --------- ---------- --------------------
-opercode String 是 操作员号
-checksum String 是 校验码
-refno String 是 参考号
-isok Boolean 是 是否写卡成功
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
-
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|---------|----------|--------------------|
+| opercode | String | 是 | 操作员号 |
+| checksum | String | 是 | 校验码 |
+| refno | String | 是 | 参考号 |
+| isok | Boolean | 是 | 是否写卡成功 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
+| | | | |
签名字段opercode+checksum+refno+isok+nTimestamp+session\_key
@@ -3423,16 +2295,15 @@
}
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
-### 取照片
+#### 5.4取照片
-Uri:
-*https://ip:port/epayapi/services/photoservice/getphoto/base64/{idno}*
+Uri: *https://ip:port/epayapi/services/photoservice/getphoto/base64/{idno}*
请求格式：text/plain
@@ -3440,15 +2311,15 @@
参数：
-名称 类型 是否必须 描述
--------------- -------- ---------- --------------------
-idno String 是 身份证号
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
-
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|--------|----------|--------------------|
+| idno | String | 是 | 身份证号 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
+| | | | |
签名字段idno+nTimestamp+session\_key
@@ -3482,16 +2353,14 @@
}
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
-1. **车载机功能入口**
-------------------
-
-1. ### 车载机获取url二维码
+### 6.车载机功能入口
+#### 6.1车载机获取url二维码
Uri: *https://ip:port/epayapi/services/carpos/geturlcode*
@@ -3501,17 +2370,17 @@
参数：
-名称 类型 是否必须 描述
--------------- -------- -------------- --------------------
-termid String 是（二选一） 终端id
-devphyid String 是 设备物理id
-merchaccno String 是 商户号
-amount Long 是 消费金额（分）
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|--------|--------------|--------------------|
+| termid | String | 是（二选一） | 终端id |
+| devphyid | String | 是 | 设备物理id |
+| merchaccno | String | 是 | 商户号 |
+| amount | Long | 是 | 消费金额（分） |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段termid+devphyid+merchaccno+amount+nTimestamp+session\_key
@@ -3551,13 +2420,13 @@
> **异常信息：**
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |
-### 车载机二维码支付
+#### 6.2车载机二维码支付
Uri: *https://ip:port/epayapi/services/carpos/pay/init/{reqdata}*
@@ -3567,15 +2436,15 @@
参数：
-名称 类型 是否必须 描述
--------------- -------- ---------- --------------------
-gid String 是 终端编号
-reqdata String 是 请求数据内容
-app\_id String 是 应用分配id
-term\_id String 是 应用内部分配终端号
-timestamp String 是 时间戳
-sign String 是 签名
-sign\_method String 是 签名方法HMAC
+| 名称 | 类型 | 是否必须 | 描述 |
+|--------------|--------|----------|--------------------|
+| gid | String | 是 | 终端编号 |
+| reqdata | String | 是 | 请求数据内容 |
+| app\_id | String | 是 | 应用分配id |
+| term\_id | String | 是 | 应用内部分配终端号 |
+| timestamp | String | 是 | 时间戳 |
+| sign | String | 是 | 签名 |
+| sign\_method | String | 是 | 签名方法HMAC |
签名字段termid+devphyid+amount+nTimestamp+session\_key
@@ -3611,10 +2480,10 @@
> **异常信息：**
-HTTP 错误码 英文索引 中文消息
-------------- ------------------ ---------------------------------------
-400 SC\_BAD\_REQUEST 请求信息不完整
-400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
-401 SC\_UNAUTHORIZED 密码验证错误
+| HTTP 错误码 | 英文索引 | 中文消息 |
+|-------------|------------------|---------------------------------------|
+| 400 | SC\_BAD\_REQUEST | 请求信息不完整 |
+| 400 | SC\_BAD\_REQUEST | 请求时间戳错误,格式为：yyyyMMddHHmmss |
+| 401 | SC\_UNAUTHORIZED | 密码验证错误 |