增加原悦校接口文档
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"
new file mode 100644
index 0000000..00d4f86
--- /dev/null
+++ "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"
@@ -0,0 +1,3620 @@
+---
+title: 一卡通v5平台终端接口文档
+date: 2017-07-12 15:04:23
+tags:
+---
+
+[TOC]
+
+## 修订历史
+
+| 版本 | 作者 | 日期 | 备注 |
+|-------- | --------| ------------| ------------------|
+| V4.0.0 | 何林青 | 2015-01-06 | 初稿 |
+| v4.0.1 | 汤成 | 2016-3-16 | 增加设备相关接口 |
+
+## 前言
+### 编写目的
+本文档用于描述了易支付对外提供的所有api接口，包括提供手机app端和pos消费端，供内部业务依据此接口开发提供参考。
+
+### 约定
+* 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. ### 消费初始化
+
+Uri: *https://ip:port/epayapi/services/consume/pos/init*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- -------- ---------- ------------
+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 是 签名方法
+
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/init
+
+barcode:12309487839029
+
+app\_id:15089039087
+
+term\_id:01
+
+term\_no:10001
+
+merchaccno:09893092
+
+amount:100
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:2015-01-19 13:09:01
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”初始化成功”
+
+“refno”:”交易参考号”
+
+}
+
+### 消费确认
+
+Uri: *https://ip:port/epayapi/services/consume/pos/confirm*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- -------- ---------- ------------
+refno String 是 交易参考号
+app\_id String 是 应用分配id
+term\_id String 是 终端id
+term\_no String 是 Psam卡号
+timestamp String 是 时间戳
+sign String 是 签名
+sign\_method String 是 签名方法
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/confirm
+
+refno:12309487839029
+
+app\_id:15089039087
+
+term\_id:01
+
+term\_no:10001
+
+amount:100
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:2015-01-19 13:09:01
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”
+
+“refno”:”交易参考号”
+
+}
+
+### 卡片信息查询
+
+Uri: *https://ip:port/epayapi/services/consume/pos/accquery*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+----------------- --------- ---------- ------------------------------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/*accquery*
+
+cardno:10
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:2015-01-19 13:09:01
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+“balance”:”可用余额”,
+
+“frozenbal”:”冻结金额”,
+
+“expiredate”:”有效期”,
+
+“status”:”账户状态”
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### 卡片在线消费
+
+Uri: *https://ip:port/epayapi/services/consume/pos/cardpay*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+----------------- --------- -------------- ------------------------------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/*cardpay*
+
+termid:11
+
+devphyid:00000001
+
+termseqno:1
+
+cardno:10
+
+amount:200
+
+managefee:0
+
+managefeetype:none
+
+credittotal:208
+
+creditavailable:10000
+
+creditseqno:2
+
+creditflag:false
+
+sourcetype:pos
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+“refno”:”交易参考号”,
+
+“accdate”:”记账日期”,
+
+“balance”:”账户余额”,
+
+“creditline”:”授信额度”,
+
+“creditseqno”:”授信交易序号”，
+
+“needpwdconfirm”:true
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+Needpwdconfirm
+如果交易金额超过单日累计或者单次限额，标识为true，需要密码确认，交易暂未成功，需要输入密码成功发送成功交易确认才完成交易。
+
+### 卡片在线消费密码确认
+
+Uri: *https://ip:port/epayapi/services/consume/pos/cardpayconfirm*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- --------- -------------- --------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/*cardpayconfirm*
+
+termid:11
+
+devphyid:00000001
+
+termseqno:1
+
+accdate:20150809
+
+refno:20001290214309182312
+
+issuccess:true
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+“refno”:”交易参考号”,
+
+“accdate”:”记账日期”,
+
+“balance”:”账户余额”,
+
+“creditline”:”授信额度”,
+
+“creditseqno”:”授信交易序号”，
+
+“needpwdconfirm”:false
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### 卡片在线消费充正
+
+Uri: *https://ip:port/epayapi/services/consume/pos/cardpayreverse*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+------------------ ----------- -------------- -------------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/*cardpayreverse*
+
+termid:11
+
+devphyid:00000001
+
+termseqno:1
+
+reversetermseqno:10
+
+reversalflag:reversal
+
+termdate:20150901
+
+termtime:090802
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+“termseqno”:”流水号”
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### 卡片授信消费流水上传
+
+Uri: *https://ip:port/epayapi/services/consume/pos/creditdtlupload*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+--------------------- --------- ---------- -----------------------------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/*cardpay*
+
+devphyid:09200101
+
+termseqno:1
+
+transdate:”20150909”
+
+transtime:”050606”
+
+cardno:123
+
+amount:100
+
+managefee:0
+
+managefeetype:none
+
+credittotal:209
+
+creditpaycnt:14
+
+creditavailable:10000
+
+creditseqno:1
+
+lastdevphyid:90299
+
+lasttermseqno:1
+
+lasttransdate:”20150909”
+
+lasttranstime:”092802”
+
+lastamount:200
+
+lastmanagefee:0
+
+lastmanagefeetype:none
+
+lastcreditavailable:900
+
+lastcreditseqno:1
+
+available:true
+
+reversalfalg:reserval
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+“termseqno”:”授信交易序号”
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### 卡片充值
+
+Uri: *https://ip:port/epayapi/services/charge/pos/confirmcharge*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+----------------- --------- -------------- ----------------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/charge/pos/*chargeconfirm*
+
+termid:11
+
+cardno:10
+
+fundtype:2
+
+vocherno:123
+
+amount:200
+
+opercode:099
+
+credittotal:208
+
+creditavailable:10000
+
+creditseqno:2
+
+creditflag:false
+
+sourcetype:cardreader
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+“refno”:”交易参考号”,
+
+“accdate”:”记账日期”,
+
+“balance”:”账户余额”,
+
+“frozenbal”:”冻结金额”
+
+“creditline”:”授信额度”,
+
+“creditseqno”:”授信交易序号”
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### 卡片充值充正
+
+Uri: *https://ip:port/epayapi/services/charge/pos/chargereverse*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+------------------ --------- -------------- --------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/*charge/pos/chargereverse*
+
+termid:11
+
+devphyid:00000001
+
+termseqno:1
+
+reversetermseqno:10
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+“termseqno”:”流水号”
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### 终端流水号查询
+
+Uri: *https://ip:port/epayapi/services/consume/term/cardpaysearch*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- --------- ---------- ----------------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/*consume/term/cardpaysearch*
+
+termid:11
+
+termseqno:1111
+
+fundtype:2
+
+sourcetype:cardreader
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+“termseqno”:”终端流水号”
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### 水控流水上传
+
+Uri: *https://ip:port/epayapi/services/consume/pos/waterdtlupload*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- --------- ---------- --------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/*waterdtlupload*
+
+devphyid:09200101
+
+termseqno:1
+
+transdate:”20150909”
+
+transtime:”050606”
+
+cardno:123
+
+amount:100
+
+available:true
+
+reversalfalg:reserval
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+“termseqno”:”授信交易序号”
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### 终端设备签到
+
+Uri: *https://ip:port/epayapi/services/consume/pos/login*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- --------- ---------- ------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/ *login*
+
+devphyid: 09200101
+
+termtype:SWPOS
+
+termdate:20160316
+
+termtime:113545
+
+deviceno:5
+
+devseqno:0
+
+termno:100000000015
+
+paraverno:0
+
+feeverno:0
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”签到成功”,
+
+“systime”:” 20160316104034”,
+
+> "devphyid": "09200101",
+>
+> "deviceid":234,
+>
+> "paraverno":3,
+>
+> "feeverno":2,
+>
+> "cardverno":"160316000001",
+>
+> "m1key":"EDFEDE234323"
+>
+> "paragroupid":1,
+>
+> "feecfgid":3,
+>
+> "keyindex":1
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### 下载设备黑名单位图
+
+Uri: *https://ip:port/epayapi/services/consume/pos/blacklistbitmap*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- --------- ---------- ---------------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/ *blacklistbitmap*
+
+devphyid:09200101
+
+termid:0
+
+blkindex:0
+
+cardverno: 160316000001
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+“cardverno”:” 160316000001”,
+
+"endflag":0, // 1表示结束，0表示未结束
+
+"blkdata": "FE123DE......" //, 512 个字符
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### 增量下载黑名单
+
+Uri: *https://ip:port/epayapi/services/consume/pos/downloadblacklist*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- --------- ---------- --------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/ *downloadblacklist*
+
+devphyid:09200101
+
+termid:0
+
+cardverno: 160312000001
+
+maxcount:10
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+cardverno: 160316000001,
+
+count:5,
+
+blkdata:\[\[123,1\],\[3234,1\],\[5646,0\],\[76,1\],\[876,0\]\]
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### 设备心跳
+
+Uri: *https://ip:port/epayapi/services/consume/pos/heartbeat*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- --------- ---------- ----------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/ *heartbeat*
+
+devphyid:09200101
+
+termid:0
+
+termdate:20160316
+
+termtime:113545
+
+termtype:SWPOS
+
+termno: 100000000015
+
+devseqno:45
+
+paraverno:3
+
+feeverno:4
+
+cardverno: 160316000001
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+"devphyid":"09200101",
+
+"systime":"20160316132234",
+
+"deviceid":123,
+
+"paraverno":4,
+
+"paragroupid":1,
+
+"feeverno":3,
+
+"feecfgid":4,
+
+"cardverno": "160316000001"
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### 下载设备参数
+
+Uri: *https://ip:port/epayapi/services/consume/pos/updatesyspara*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- --------- ---------- --------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/ *updatesyspara*
+
+devphyid:09200101
+
+termid:0
+
+termsdate:”20150909”
+
+termtime:”050606”
+
+termtype:"SWPOS"
+
+paragroupid:2
+
+classname:"syspara"
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+"syspara":\[\[ "day\_limit", 5000\], \["max\_cardbal ", 99999\]\],
+
+"paraverno":4,
+
+"paragroupid":2
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### 下载设备卡权限费率
+
+Uri: *https://ip:port/epayapi/services/consume/pos/updatefeecfg*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- --------- ---------- --------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/*updatefeecfg*
+
+devphyid:09200101
+
+devcfgverno:4
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+"cfgverno":6,
+
+"feecfg":\[\[10,100\],\[11,110\],\[15,90\],\[16,100\]\]
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### B Mode 消费流水上传
+
+Uri: *https://ip:port/epayapi/services/consume/pos/bmodeuploadrecord*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+--------------- --------- ---------- ------------------------------------------------------
+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
+
++cardaftbal+withpasswd+datatype+updresult+nTimestamp+session\_key
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/pos/ *bmodeuploadrecord*
+
+devphyid:09200101
+
+termseqno:1
+
+transdate:”20150909”
+
+transtime:”050606”
+
+cardno:123
+
+amount:1000
+
+payamt:1100
+
+cardbefbal:5000
+
+cardaftbal:3900
+
+feeamt:100
+
+paycnt:5
+
+withpasswd:0
+
+termno:100000000015
+
+tac:ABCD45ED
+
+datatype:20
+
+sendtype:2
+
+updresult:9
+
+lasttranstime:20150908181223
+
+lasttermno:100000000231
+
+lastamt:500
+
+lasttranscnt:4
+
+lasttransflag:6app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+“termseqno”:”交易序号”
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+1. **多媒体对接功能入口**
+----------------------
+
+1. ### 充值初始化
+
+Uri: *https://ip:port/epayapi/services/charge/dmtqc/init*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- --------- ---------- --------------------
+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
+
+例子:
+
+URI：*https://ip:port/epayapi/services/charge/dmtqc/init*
+
+termid:10000014
+
+termseqno:”1”
+
+cardno:”12312”
+
+amount:”104”
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：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/dmtqc/transfer*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- --------- ---------- --------------------
+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
+
+例子:
+
+URI：*https://ip:port/epayapi/services/charge/dmtqc/transfer*
+
+termid:10000014
+
+refno:”20040000100200102001”
+
+cardno:”12312”
+
+amount:”104”
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：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/dmtqc/resultquery*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- --------- ---------- --------------------
+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
+
+例子:
+
+URI：*https://ip:port/epayapi/services/charge/dmtqc/resultquery*
+
+termid:10000014
+
+refno:”20040000100200102001”
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：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 密码验证错误
+
+### 终端在线消费（第三方/多媒体）
+
+Uri: *https://ip:port/epayapi/services/consume/dmtterm/cardpay*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+----------------- --------- -------------- -------------------------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/dmtterm/*cardpay*
+
+termid:11
+
+devphyid:00000001
+
+termseqno:1
+
+cardno:10
+
+amount:200
+
+managefee:0
+
+managefeetype:none
+
+credittotal:208
+
+creditavailable:10000
+
+creditseqno:2
+
+creditflag:false
+
+shopid:111
+
+sourcetype:pos
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+“refno”:”交易参考号”,
+
+“accdate”:”记账日期”,
+
+“balance”:”账户余额”,
+
+“creditline”:”授信额度”,
+
+“creditseqno”:”授信交易序号”，
+
+“needpwdconfirm”:true
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+Needpwdconfirm
+如果交易金额超过单日累计或者单次限额，标识为true，需要密码确认，交易暂未成功，需要输入密码成功发送成功交易确认才完成交易。(目前只有需要pos输入密码)
+
+### 终端在线消费充正
+
+Uri: *https://ip:port/epayapi/services/consume/dmtterm/cardpayreverse*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+------------------ --------- -------------- --------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/dmtterm/*cardpayreverse*
+
+termid:11
+
+devphyid:00000001
+
+termseqno:1
+
+reversetermseqno:10
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+“termseqno”:”流水号”
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+### 水控转账（多媒体）
+
+Uri: *https://ip:port/epayapi/services/consume/dmtterm/watertrans*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+----------------- --------- -------------- -------------------------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/dmtterm/*cardpay*
+
+termid:11
+
+devphyid:00000001
+
+termseqno:1
+
+cardno:10
+
+amount:200
+
+managefee:0
+
+managefeetype:none
+
+credittotal:208
+
+creditavailable:10000
+
+creditseqno:2
+
+creditflag:false
+
+shopid:111
+
+sourcetype:pos
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+“refno”:”交易参考号”,
+
+“accdate”:”记账日期”,
+
+“balance”:”账户余额”,
+
+“creditline”:”授信额度”,
+
+“creditseqno”:”授信交易序号”，
+
+“needpwdconfirm”:true
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+Needpwdconfirm
+如果交易金额超过单日累计或者单次限额，标识为true，需要密码确认，交易暂未成功，需要输入密码成功发送成功交易确认才完成交易。(目前只有需要pos输入密码)
+
+### 水控转账小钱包写卡确认（多媒体）
+
+Uri: *https://ip:port/epayapi/services/consume/dmtterm/waterconfirm*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- --------- -------------- --------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/dmtterm/*waterconfirm*
+
+termid:11
+
+devphyid:00000001
+
+refno:20150902010201201
+
+cardno:10
+
+waterisok:true
+
+waterisbreak:false
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”交易成功”,
+
+}
+
+备注：retcode=0为正常，其他非0为错误
+
+1. **支付宝前置对接功能入口**
+--------------------------
+
+1. ### 支付宝充值初始化
+
+Uri: *https://ip:port/epayapi/services/charge/alipay/init*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- -------- ---------- --------------------
+stuempno String 是 学工号
+amount Long 是 消费金额（分）
+app\_id String 是 应用分配id
+term\_id String 是 应用内部分配终端号
+timestamp String 是 时间戳
+sign String 是 签名
+sign\_method String 是 签名方法HMAC
+
+签名字段stuempno+amount+nTimestamp+session\_key
+
+例子:
+
+URI：*https://ip:port/epayapi/services/charge/alipay/init*
+
+stuempno:901920
+
+amount:”104”
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：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/alipay/confirm*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- -------- ---------- --------------------
+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
+
+例子:
+
+URI：*https://ip:port/epayapi/services/charge/alipay/confirm*
+
+stuempno:901920
+
+refno:2015098309283930921
+
+amount:”104”
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+> *“retcode“:0，*
+>
+> *“retmsg“:” 支付确认已接受”，*
+>
+> *“refno”:”20140809120901000001”*
+
+}
+
+> **异常信息：**
+
+HTTP 错误码 英文索引 中文消息
+------------- ------------------ ---------------------------------------
+400 SC\_BAD\_REQUEST 请求信息不完整
+400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
+401 SC\_UNAUTHORIZED 密码验证错误
+
+1. **第三方对接功能入口**
+----------------------
+
+1. ### 换卡初始化
+
+Uri: *https://ip:port/epayapi/services/consume/zzsb/init*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- -------- ---------- --------------------
+idno String 是 身份证号
+app\_id String 是 应用分配id
+term\_id String 是 应用内部分配终端号
+timestamp String 是 时间戳
+sign String 是 签名
+sign\_method String 是 签名方法HMAC
+
+
+签名字段idno+nTimestamp+session\_key
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/zzsb/init
+
+idno:210201929309389922
+
+app\_id:15089039087
+
+term\_id:01
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:2015-01-19 13:09:01
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”初始化成功”
+
+“oldcardno”:”老卡卡号”
+
+“stuempno”:”学号”
+
+“custname”:”姓名”
+
+“feetype”:40
+
+“feeamt”:”20.00”
+
+“expiredate”:”20150909”
+
+}
+
+HTTP 错误码 英文索引 中文消息
+------------- ------------------ ---------------------------------------
+400 SC\_BAD\_REQUEST 请求信息不完整
+400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
+401 SC\_UNAUTHORIZED 密码验证错误
+
+### 换卡请求
+
+Uri: *https://ip:port/epayapi/services/consume/zzsb/renewcard*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+----------------- -------- ---------- --------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/zzsb/renewcard
+
+opercode:6666
+
+checksum:1920
+
+operseqno:1029932929
+
+oldcardno:1000092
+
+newcardphyid:0D908A11
+
+cardphytypecode:257
+
+feeamt:2000
+
+app\_id:15089039087
+
+term\_id:01
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:2015-01-19 13:09:01
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”补办成功”
+
+"accdate":"日期";
+
+> "refno":"参考号";
+>
+> "amount":"金额";
+>
+> "feeamt":"收费费用";
+>
+> "hostdate":"主机日期";
+>
+> "hosttime":"主机时间";
+>
+> "feetype":"收费类别";
+>
+> "expiredate":"过期日期";
+>
+> "cardno":"卡号";
+>
+> "cardtype":"卡类别";
+>
+> "showcardno":"显示卡号";
+>
+> "cardverno":"黑名单版本号";
+>
+> "cardpwd":"卡密码";
+>
+> "custid":"客户号";
+>
+> "country":"国籍";
+>
+> "nation":"民族";
+>
+> "areacode":"校区";
+>
+> "custtype":"客户类别";
+>
+> "custname":"客户名";
+>
+> "stuempno":"学号";
+>
+> "deptcode":"部门";
+>
+> "idtype":"证件类型";
+>
+> "idno":"证件号";
+>
+> "sex":"性别";
+>
+> "singlemaxamt":"单次限额";
+>
+> "daymaxamt":"单日限额";
+
+}
+
+HTTP 错误码 英文索引 中文消息
+------------- ------------------ ---------------------------------------
+400 SC\_BAD\_REQUEST 请求信息不完整
+400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
+401 SC\_UNAUTHORIZED 密码验证错误
+
+### 换卡确认
+
+Uri: *https://ip:port/epayapi/services/consume/zzsb/renewcardconfirm*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- --------- ---------- --------------------
+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
+
+例子:
+
+URI：https://ip:port/epayapi/services/consume/zzsb/renewcardconfirm
+
+opercode:6666
+
+checksum:1920
+
+refno:1000092123124123123
+
+isok:true
+
+app\_id:15089039087
+
+term\_id:01
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:2015-01-19 13:09:01
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+“retcode”:0,
+
+“retmsg”:”确认成功”
+
+}
+
+HTTP 错误码 英文索引 中文消息
+------------- ------------------ ---------------------------------------
+400 SC\_BAD\_REQUEST 请求信息不完整
+400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
+401 SC\_UNAUTHORIZED 密码验证错误
+
+### 取照片
+
+Uri:
+*https://ip:port/epayapi/services/photoservice/getphoto/base64/{idno}*
+
+请求格式：text/plain
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- -------- ---------- --------------------
+idno String 是 身份证号
+app\_id String 是 应用分配id
+term\_id String 是 应用内部分配终端号
+timestamp String 是 时间戳
+sign String 是 签名
+sign\_method String 是 签名方法HMAC
+
+
+签名字段idno+nTimestamp+session\_key
+
+例子:
+
+URI：https://ip:port/epayapi/services/*photoservice/getphoto/base64/{idno}*
+
+idno:1000092123124123123
+
+app\_id:15089039087
+
+term\_id:01
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:2015-01-19 13:09:01
+
+返回：
+
+> 返回格式：text/plain
+
+{
+
+“retcode”:0,
+
+“retmsg”:”确认成功”
+
+“photo”:”base64 数据”
+
+}
+
+HTTP 错误码 英文索引 中文消息
+------------- ------------------ ---------------------------------------
+400 SC\_BAD\_REQUEST 请求信息不完整
+400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
+401 SC\_UNAUTHORIZED 密码验证错误
+
+1. **车载机功能入口**
+------------------
+
+1. ### 车载机获取url二维码
+
+Uri: *https://ip:port/epayapi/services/carpos/geturlcode*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- -------- -------------- --------------------
+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
+
+例子:
+
+URI：*https://ip:port/epayapi/services/carpos/geturlcode*
+
+termid:901920
+
+devphyid:12312
+
+merchaccno:10929
+
+amount:”104”
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+> *“retcode“:0，*
+>
+> *“retmsg“:” success”，*
+>
+> *“url”:”http://102.29.20.10/epayapi/service/carpos/pay/init/base64串”*
+
+}
+
+> **异常信息：**
+
+HTTP 错误码 英文索引 中文消息
+------------- ------------------ ---------------------------------------
+400 SC\_BAD\_REQUEST 请求信息不完整
+400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
+401 SC\_UNAUTHORIZED 密码验证错误
+
+### 车载机二维码支付
+
+Uri: *https://ip:port/epayapi/services/carpos/pay/init/{reqdata}*
+
+请求格式：application/x-www-form-urlencoded
+
+请求方式：post
+
+参数：
+
+名称 类型 是否必须 描述
+-------------- -------- ---------- --------------------
+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
+
+例子:
+
+URI：*https://ip:port/epayapi/services/carpos/pay/init/{reqdata}*
+
+gid:901920
+
+reqdata:ksjfijsalkjflksajdfl
+
+app\_id:15089039087
+
+sign:a910bba901d9919c
+
+sing\_method:HMAC
+
+timestamp:20150119130901
+
+返回：
+
+> 返回格式：application/json
+
+{
+
+> *“retcode“:0，*
+>
+> *“retmsg“:” success”，*
+>
+> *“refno”:”20159120392839129”*
+
+}
+
+> **异常信息：**
+
+HTTP 错误码 英文索引 中文消息
+------------- ------------------ ---------------------------------------
+400 SC\_BAD\_REQUEST 请求信息不完整
+400 SC\_BAD\_REQUEST 请求时间戳错误,格式为：yyyyMMddHHmmss
+401 SC\_UNAUTHORIZED 密码验证错误
+
+