添加在线支付交易-读卡器签到
diff --git "a/source/_posts/\344\270\200\345\215\241\351\200\232v5\347\263\273\347\273\237\345\272\224\347\224\250\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\347\263\273\347\273\237\345\272\224\347\224\250\346\216\245\345\217\243\346\226\207\346\241\243.md"
index 3729563..0065dcb 100644
--- "a/source/_posts/\344\270\200\345\215\241\351\200\232v5\347\263\273\347\273\237\345\272\224\347\224\250\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\347\263\273\347\273\237\345\272\224\347\224\250\346\216\245\345\217\243\346\226\207\346\241\243.md"
@@ -4,9 +4,9 @@
tags:
---
-| 版本 | 日期 | 说明 |
-| --- | --- | --- |
-| 1.0 | 2016-8-5 | 初始版本 |
+| 版本 | 日期 | 说明 |
+| ---- | -------- | ---- |
+| 1.0 | 2016-8-5 | 初始版本 |
## 1.1 文档说明 ##
@@ -16,12 +16,12 @@
## 1.2 约定 ##
1. 传输编码统一为utf-8
-2. RSA 加密算法为本接口采用的非对称加密算法，**`SIGN_ALGORITHMS ="SHA1WithRSA"`**;
-3. RSA公钥由本系统提供，本系统返回信息的签名数据，第三方系统得到后通过公钥校验算法，验证返回数据的合法性
-4. HMAC加密算法为用户请求本系统采用的加密算法，**`SIGN_ALGORITHMS ="HMAC-SHA1"`**;
-5. 具体签名生成参考后面的签名章节
-6. **retcode** 等于0表示成功，非0表示失败，失败具体信息查看 **retmsg**
-7. 密码加密的原始串为 **timestamp:pwd**
+ 2.RSA 加密算法为本接口采用的非对称加密算法，**`SIGN_ALGORITHMS ="SHA1WithRSA"`**;
+ 3.RSA公钥由本系统提供，本系统返回信息的签名数据，第三方系统得到后通过公钥校验算法，验证返回数据的合法性
+ 4.HMAC加密算法为用户请求本系统采用的加密算法，**`SIGN_ALGORITHMS ="HMAC-SHA1"`**;
+ 5.具体签名生成参考后面的签名章节
+ 6.**retcode** 等于0表示成功，非0表示失败，失败具体信息查看 **retmsg**
+ 7.密码加密的原始串为 **timestamp:pwd**
## 2.1 充值操作员签到 ##
@@ -36,15 +36,15 @@
**请求参数:**
-|参数名 | 类型 | 必选 | 说明 |
-|-----|------|-----|------|
-|app_id|String|是 |本系统分配给各个接入应用的合作伙伴id号|
-|cardphyid|String|是|操作员授权卡物理卡号|
-|cardpwd|String|是|操作员密码， MD5串|
-|deviceid|Integer|否|充值POS机设备ID|
-|devphyid|String|否|充值POS机物理ID，devphyid 和 deviceid 二选一|
-|sign|String|是| 签名|
-|sign_method|String|是|参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1|
+| 参数名 | 类型 | 必选 | 说明 |
+| ----------- | ------- | ------------------------------------- | ---------------------------------- |
+| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
+| cardphyid | String | 是 | 操作员授权卡物理卡号 |
+| cardpwd | String | 是 | 操作员密码， MD5串 |
+| deviceid | Integer | 否 | 充值POS机设备ID |
+| devphyid | String | 否 | 充值POS机物理ID，devphyid 和 deviceid 二选一 |
+| sign | String | 是 | 签名 |
+| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
**请求内容示例:**
@@ -101,21 +101,21 @@
**返回参数说明:**
-|参数名 | 类型 | 说明 |
-|-----|-----|------|
-|retcode|String|返回码（0=成功，其他为失败）|
-|retmsg|String|返回消息|
-|termid|Integer|终端ID|
-|termseqno|Integer|终端流水号|
-|checknum|Integer|校验码|
-|cardno|Integer|卡号|
-|opername|String|操作员名称|
-|operid|Integer|操作员ID|
-|authcode|Integer|授权号|
-|batchno|Integer|批次号|
-|hostdate|String|主机日期|
-|hosttime|String|主机时间|
-|mainkey|String|M1卡密钥（暂时为空）|
+| 参数名 | 类型 | 说明 |
+| --------- | ------- | --------------- |
+| retcode | String | 返回码（0=成功，其他为失败） |
+| retmsg | String | 返回消息 |
+| termid | Integer | 终端ID |
+| termseqno | Integer | 终端流水号 |
+| checknum | Integer | 校验码 |
+| cardno | Integer | 卡号 |
+| opername | String | 操作员名称 |
+| operid | Integer | 操作员ID |
+| authcode | Integer | 授权号 |
+| batchno | Integer | 批次号 |
+| hostdate | String | 主机日期 |
+| hosttime | String | 主机时间 |
+| mainkey | String | M1卡密钥（暂时为空） |
## 2.2 操作员充值接口 ##
@@ -131,29 +131,29 @@
**请求参数:**
-|参数名 | 类型 | 必选 | 说明 |
-|-----|------|-----|------|
-|app_id|String|是 |本系统分配给各个接入应用的合作伙伴id号|
-|cardno|Integer|是|交易卡号|
-|cardphyid|String|是|物理卡号|
-|dpscnt|Integer|是|充值前次数|
-|paycnt|Integer|是|消费前次数|
-|cardbefbal|Integer|是|充值前卡余额|
-|amount|Integer|是|充值金额|
-|dpsamt|Integer|是|实际写卡金额|
-|fundtype|Integer|是|资金类型：1-现金；2-支票；3-经费本|
-|samno|String|是|SAM终端号|
-|random_num|String|是|随机数|
-|mac1|String|是|MAC1|
-|operid|Integer|是|操作员ID|
-|authcode|Integer|是|授权号|
-|batchno|Integer|是|批次号|
-|deviceid|Integer|是|终端ID，操作员签到返回的termid|
-|devseqno|Integer|是|终端流水号|
-|refno|String|否|交易参考号，重发请求时上传|
-|reqflag|String|是|请求标志，重发请求时 'Q'|
-|sign|String|是| 签名|
-|sign_method|String|是|参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1|
+| 参数名 | 类型 | 必选 | 说明 |
+| ----------- | ------- | ------------------------------------- | ---------------------------------- |
+| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
+| cardno | Integer | 是 | 交易卡号 |
+| cardphyid | String | 是 | 物理卡号 |
+| dpscnt | Integer | 是 | 充值前次数 |
+| paycnt | Integer | 是 | 消费前次数 |
+| cardbefbal | Integer | 是 | 充值前卡余额 |
+| amount | Integer | 是 | 充值金额 |
+| dpsamt | Integer | 是 | 实际写卡金额 |
+| fundtype | Integer | 是 | 资金类型：1-现金；2-支票；3-经费本 |
+| samno | String | 是 | SAM终端号 |
+| random_num | String | 是 | 随机数 |
+| mac1 | String | 是 | MAC1 |
+| operid | Integer | 是 | 操作员ID |
+| authcode | Integer | 是 | 授权号 |
+| batchno | Integer | 是 | 批次号 |
+| deviceid | Integer | 是 | 终端ID，操作员签到返回的termid |
+| devseqno | Integer | 是 | 终端流水号 |
+| refno | String | 否 | 交易参考号，重发请求时上传 |
+| reqflag | String | 是 | 请求标志，重发请求时 'Q' |
+| sign | String | 是 | 签名 |
+| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
**请求内容示例:**
@@ -204,16 +204,16 @@
**返回参数说明:**
-| 参数名 | 类型 | 说明 |
-| --- | --- | --- |
-| retcode | String | 返回码（0=成功，其他为失败） |
-| retmsg | String | 返回消息 |
-| termid | Integer | 终端ID |
-| cardno | Integer | 卡号 |
-| refno | String | 交易参考号 |
-| hostdate | String | 主机日期 |
-| hosttime | String | 主机时间 |
-| mac2 | String | MAC2 |
+| 参数名 | 类型 | 说明 |
+| -------- | ------- | --------------- |
+| retcode | String | 返回码（0=成功，其他为失败） |
+| retmsg | String | 返回消息 |
+| termid | Integer | 终端ID |
+| cardno | Integer | 卡号 |
+| refno | String | 交易参考号 |
+| hostdate | String | 主机日期 |
+| hosttime | String | 主机时间 |
+| mac2 | String | MAC2 |
## 2.3 操作员充值确认接口 ##
@@ -228,15 +228,15 @@
**请求参数:**
-| 参数名 | 类型 | 必选 | 说明 |
-| --- | --- | --- | --- |
-| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
-| refno | String | 是 | 交易参考号 |
-| isok | Integer | 是 | 是否成功 1: 成功，其他失败 |
-| isbreak | Integer | 是 | 是否是中途拔卡 0-不是，1-是 |
-| tac | String | 是 | TAC |
-| sign | String | 是 | 签名 |
-| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
+| 参数名 | 类型 | 必选 | 说明 |
+| ----------- | ------- | ---- | ---------------------------------- |
+| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
+| refno | String | 是 | 交易参考号 |
+| isok | Integer | 是 | 是否成功 1: 成功，其他失败 |
+| isbreak | Integer | 是 | 是否是中途拔卡 0-不是，1-是 |
+| tac | String | 是 | TAC |
+| sign | String | 是 | 签名 |
+| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
**请求内容示例:**
@@ -287,13 +287,13 @@
**返回参数说明:**
-| 参数名 | 类型 | 说明 |
-| --- | --- | --- |
-| retcode | String | 返回码（0=成功，其他为失败） |
-| retmsg | String | 返回消息 |
-| termid | Integer | 终端ID |
-| nextTermseqno | Integer | 下一笔终端流水号 |
-| refno | String | 交易参考号 |
+| 参数名 | 类型 | 说明 |
+| ------------- | ------- | --------------- |
+| retcode | String | 返回码（0=成功，其他为失败） |
+| retmsg | String | 返回消息 |
+| termid | Integer | 终端ID |
+| nextTermseqno | Integer | 下一笔终端流水号 |
+| refno | String | 交易参考号 |
## 2.4 B模式卡消费初始化 ##
@@ -309,19 +309,19 @@
**请求参数:**
-| 参数名 | 类型 | 必选 | 说明 |
-| --- | --- | --- | --- |
-| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
-| cardno | Integer | 是 | 交易卡号 |
-| paycnt | Integer | 是 | 消费前次数 |
-| cardbefbal | Integer | 是 | 卡消费前余额 |
-| amount | Integer | 是 | 消费金额 |
-| termid | Integer | 是 | 终端号 |
-| termseqno | Integer | 是 | 终端流水号 |
-| termdate | String | 是 | 终端日期 |
-| termtime | String | 是 | 终端时间 |
-| sign | String | 是 | 签名 |
-| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
+| 参数名 | 类型 | 必选 | 说明 |
+| ----------- | ------- | ---- | ---------------------------------- |
+| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
+| cardno | Integer | 是 | 交易卡号 |
+| paycnt | Integer | 是 | 消费前次数 |
+| cardbefbal | Integer | 是 | 卡消费前余额 |
+| amount | Integer | 是 | 消费金额 |
+| termid | Integer | 是 | 终端号 |
+| termseqno | Integer | 是 | 终端流水号 |
+| termdate | String | 是 | 终端日期 |
+| termtime | String | 是 | 终端时间 |
+| sign | String | 是 | 签名 |
+| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
**请求内容示例:**
@@ -372,18 +372,18 @@
**返回参数说明:**
-| 参数名 | 类型 | 说明 |
-| --- | --- | --- |
-| retcode | String | 返回码（0=成功，其他为失败） |
-| retmsg | String | 返回消息 |
-| termid | Integer | 终端ID |
-| cardno | Integer | 交易卡号 |
-| refno | String | 交易参考号 |
-| payamt | Integer | 实际消费金额（分） |
-| otheramt | Integer | 其它金额（分） |
-| otheramt_desc | String | 说明 |
-| sign | String | 签名 |
-| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
+| 参数名 | 类型 | 说明 |
+| ------------- | ------- | --------------- |
+| retcode | String | 返回码（0=成功，其他为失败） |
+| retmsg | String | 返回消息 |
+| termid | Integer | 终端ID |
+| cardno | Integer | 交易卡号 |
+| refno | String | 交易参考号 |
+| payamt | Integer | 实际消费金额（分） |
+| otheramt | Integer | 其它金额（分） |
+| otheramt_desc | String | 说明 |
+| sign | String | 签名 |
+| sign_method | String | 是 |
## 2.5 B模式卡消费确认 ##
@@ -398,16 +398,16 @@
**请求参数:**
-| 参数名 | 类型 | 必选 | 说明 |
-| --- | --- | --- | --- |
-| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
-| refno | String | 是 | 交易参考号 |
-| isok | Integer | 是 | 是否消费成功 |
-| tac | String | 是 | TAC |
-| samno | String | 是 | SAM卡号 |
-| samseqno | Integer | 是 | SAM卡流水号 |
-| sign | String | 是 | 签名 |
-| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
+| 参数名 | 类型 | 必选 | 说明 |
+| ----------- | ------- | ---- | ---------------------------------- |
+| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
+| refno | String | 是 | 交易参考号 |
+| isok | Integer | 是 | 是否消费成功 |
+| tac | String | 是 | TAC |
+| samno | String | 是 | SAM卡号 |
+| samseqno | Integer | 是 | SAM卡流水号 |
+| sign | String | 是 | 签名 |
+| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
**请求内容示例:**
@@ -457,12 +457,12 @@
**返回参数说明:**
-| 参数名 | 类型 | 说明 |
-| --- | --- | --- |
-| retcode | String | 返回码（0=成功，其他为失败） |
-| retmsg | String | 返回消息 |
-| refno | String | 交易参考号 |
-| sign | String | 签名 |
+| 参数名 | 类型 | 说明 |
+| ----------- | ------ | ---------------------------------- |
+| retcode | String | 返回码（0=成功，其他为失败） |
+| retmsg | String | 返回消息 |
+| refno | String | 交易参考号 |
+| sign | String | 签名 |
| sign_method | String | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
@@ -479,15 +479,15 @@
**请求参数:**
-| 参数名 | 类型 | 必选 | 说明 |
-| --- | --- | --- | --- |
-| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
-| cardno | Integer | 否 | 交易卡号 |
-| stuempno | String | 否 | 学工号， 与交易卡号二选一 |
-| needcardpwd | Boolean | 是 | 是否校验卡密码 |
-| cardpwd | String | 否 | 卡密码，MD5加密 |
-| sign | String | 是 | 签名 |
-| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
+| 参数名 | 类型 | 必选 | 说明 |
+| ----------- | ------- | ---- | ---------------------------------- |
+| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
+| cardno | Integer | 否 | 交易卡号 |
+| stuempno | String | 否 | 学工号， 与交易卡号二选一 |
+| needcardpwd | Boolean | 是 | 是否校验卡密码 |
+| cardpwd | String | 否 | 卡密码，MD5加密 |
+| sign | String | 是 | 签名 |
+| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
**请求内容示例:**
@@ -542,12 +542,12 @@
**返回参数说明:**
-| 参数名 | 类型 | 说明 |
-| --- | --- | --- |
-| retcode | String | 返回码（0=成功，其他为失败） |
-| retmsg | String | 返回消息 |
-| refno | String | 交易参考号 |
-| sign | String | 签名 |
+| 参数名 | 类型 | 说明 |
+| ----------- | ------ | ---------------------------------- |
+| retcode | String | 返回码（0=成功，其他为失败） |
+| retmsg | String | 返回消息 |
+| refno | String | 交易参考号 |
+| sign | String | 签名 |
| sign_method | String | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
@@ -564,15 +564,15 @@
**请求参数:**
-| 参数名 | 类型 | 必选 | 说明 |
-| --- | --- | --- | --- |
-| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
-| cardno | Integer | 否 | 交易卡号 |
-| stuempno | String | 否 | 学工号， 与交易卡号二选一 |
-| needcardpwd | Boolean | 是 | 是否校验卡密码 |
-| cardpwd | String | 否 | 卡密码，MD5加密 |
-| sign | String | 是 | 签名 |
-| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
+| 参数名 | 类型 | 必选 | 说明 |
+| ----------- | ------- | ---- | ---------------------------------- |
+| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
+| cardno | Integer | 否 | 交易卡号 |
+| stuempno | String | 否 | 学工号， 与交易卡号二选一 |
+| needcardpwd | Boolean | 是 | 是否校验卡密码 |
+| cardpwd | String | 否 | 卡密码，MD5加密 |
+| sign | String | 是 | 签名 |
+| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
**请求内容示例:**
@@ -627,12 +627,12 @@
**返回参数说明:**
-| 参数名 | 类型 | 说明 |
-| --- | --- | --- |
-| retcode | String | 返回码（0=成功，其他为失败） |
-| retmsg | String | 返回消息 |
-| refno | String | 交易参考号 |
-| sign | String | 签名 |
+| 参数名 | 类型 | 说明 |
+| ----------- | ------ | ---------------------------------- |
+| retcode | String | 返回码（0=成功，其他为失败） |
+| retmsg | String | 返回消息 |
+| refno | String | 交易参考号 |
+| sign | String | 签名 |
| sign_method | String | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
@@ -651,17 +651,17 @@
**请求参数:**
-| 参数名 | 类型 | 必选 | 说明 |
-| --- | --- | --- | --- |
-| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
-| cardno | Integer | 是 | 交易卡号 |
-| cardphyid | String | 是 | 物理卡号 |
-| paycnt | Integer | 是 | 卡消费次数 |
-| dpscnt | Integer | 是 | 卡充值次数 |
-| expiredate | String | 是 | 卡有效期，yyyyMMdd |
-| reqflag | String | 是 | “1”-卡基本信息更新；“2”-修改卡有效期; |
-| sign | String | 是 | 签名 |
-| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
+| 参数名 | 类型 | 必选 | 说明 |
+| ----------- | ------- | ---- | ---------------------------------- |
+| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
+| cardno | Integer | 是 | 交易卡号 |
+| cardphyid | String | 是 | 物理卡号 |
+| paycnt | Integer | 是 | 卡消费次数 |
+| dpscnt | Integer | 是 | 卡充值次数 |
+| expiredate | String | 是 | 卡有效期，yyyyMMdd |
+| reqflag | String | 是 | “1”-卡基本信息更新；“2”-修改卡有效期; |
+| sign | String | 是 | 签名 |
+| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
**请求内容示例:**
@@ -716,12 +716,12 @@
**返回参数说明:**
-| 参数名 | 类型 | 说明 |
-| --- | --- | --- |
-| retcode | String | 返回码（0=成功，其他为失败） |
-| retmsg | String | 返回消息 |
-| data | String | 写卡数据，成功时返回 |
-| sign | String | 签名 |
+| 参数名 | 类型 | 说明 |
+| ----------- | ------ | ---------------------------------- |
+| retcode | String | 返回码（0=成功，其他为失败） |
+| retmsg | String | 返回消息 |
+| data | String | 写卡数据，成功时返回 |
+| sign | String | 签名 |
| sign_method | String | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
@@ -738,15 +738,15 @@
**请求参数:**
-| 参数名 | 类型 | 必选 | 说明 |
-| --- | --- | --- | --- |
-| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
-| cardno | Integer | 是 | 交易卡号 |
-| cardphyid | String | 是 | 物理卡号 |
-| singlemaxamt | Integer | 是 | 单次消费限额。金额（分） |
-| daymaxamt | Integer | 是 | 日累计消费限额。金额（分） |
-| sign | String | 是 | 签名 |
-| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
+| 参数名 | 类型 | 必选 | 说明 |
+| ------------ | ------- | ---- | ---------------------------------- |
+| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
+| cardno | Integer | 是 | 交易卡号 |
+| cardphyid | String | 是 | 物理卡号 |
+| singlemaxamt | Integer | 是 | 单次消费限额。金额（分） |
+| daymaxamt | Integer | 是 | 日累计消费限额。金额（分） |
+| sign | String | 是 | 签名 |
+| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
**请求内容示例:**
@@ -801,12 +801,12 @@
**返回参数说明:**
-| 参数名 | 类型 | 说明 |
-| --- | --- | --- |
-| retcode | String | 返回码（0=成功，其他为失败） |
-| retmsg | String | 返回消息 |
-| data | String | 写卡数据，成功时返回 |
-| sign | String | 签名 |
+| 参数名 | 类型 | 说明 |
+| ----------- | ------ | ---------------------------------- |
+| retcode | String | 返回码（0=成功，其他为失败） |
+| retmsg | String | 返回消息 |
+| data | String | 写卡数据，成功时返回 |
+| sign | String | 签名 |
| sign_method | String | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
@@ -823,14 +823,14 @@
**请求参数:**
-| 参数名 | 类型 | 必选 | 说明 |
-| --- | --- | --- | --- |
-| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
-| cardno | Integer | 是 | 交易卡号 |
-| oldcardpwd | String | 是 | 旧密码 |
-| newcardpwd | String | 是 | 新密码 |
-| sign | String | 是 | 签名 |
-| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
+| 参数名 | 类型 | 必选 | 说明 |
+| ----------- | ------- | ---- | ---------------------------------- |
+| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
+| cardno | Integer | 是 | 交易卡号 |
+| oldcardpwd | String | 是 | 旧密码 |
+| newcardpwd | String | 是 | 新密码 |
+| sign | String | 是 | 签名 |
+| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
**请求内容示例:**
@@ -841,7 +841,6 @@
cardno:123
sign:1231231234
sign_method:HMAC
-
```
**返回示例:**
@@ -867,7 +866,6 @@
"sign":"hjAtBGygGjFyOKEZmWdxi1tk51/xqLYTr5tm2+zQVfD1RHRzGVC9GNm4ZaXnUsHnu5o3kAZ4U32m0YNiSFpncs0pl1AnnCf1n2hhn39ruABsvD//GzkEINHjyHsnxBr44G2UhyNxplUj+s7s0a7ggjbiMk+BYC3u7VkU9/l+kZOTkEyqs+wZKumfByMZGvKVkY2c2Nr67RaSWd7bsfOJ6HYw2spvu3ptAo2RTrfCxZ0Kn5DcSDm4cagzPMZSHxB8isqqNGrdUaAU0wzzC7704iA5zze//SvCqpCJfYt0OrHOiJEN5kw1d4KESrKGMG6bezlXzAp0LbNlhl+HwZJcag==",
"sign_method": "RSA"
}
-
```
- 失败
@@ -880,24 +878,83 @@
"sign": "hjAtBGygGjFyOKEZmWdxi1tk51/xqLYTr5tm2+zQVfD1RHRzGVC9GNm4ZaXnUsHnu5o3kAZ4U32m0YNiSFpncs0pl1AnnCf1n2hhn39ruABsvD//GzkEINHjyHsnxBr44G2UhyNxplUj+s7s0a7ggjbiMk+BYC3u7VkU9/l+kZOTkEyqs+wZKumfByMZGvKVkY2c2Nr67RaSWd7bsfOJ6HYw2spvu3ptAo2RTrfCxZ0Kn5DcSDm4cagzPMZSHxB8isqqNGrdUaAU0wzzC7704iA5zze//SvCqpCJfYt0OrHOiJEN5kw1d4KESrKGMG6bezlXzAp0LbNlhl+HwZJcag==",
"sign_method":"RSA"
}
+```
+
+**返回参数说明:**
+
+| 参数名 | 类型 | 说明 |
+| ----------- | ------ | ---------------------------------- |
+| retcode | String | 返回码（0=成功，其他为失败） |
+| retmsg | String | 返回消息 |
+| newcardpwd | String | 新密码，成功时返回 |
+| sign | String | 签名 |
+| sign_method | String | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
+
+
+
+## 4.0 在线支付交易-读卡器签到
+
+**请求URL:**
+
+- `https://ip:port/epay/api/onlinepay/cardreaderlogin`
+
+**请求方式/格式:**
+
+- POST
+- application/x-www-form-urlencoded
+
+**请求参数:**
+
+| 参数名 | 类型 | 必选 | 说明 |
+| ----------- | ------- | ---- | ---------------------------------- |
+| app_id | String | 是 | 本系统分配给各个接入应用的合作伙伴id号 |
+| termno | String | 是 | PSAM卡终端编号 |
+| termid | Integer | 是 | 读卡器设备编号 |
+| | | | |
+| sign | String | 是 | 签名 |
+| sign_method | String | 是 | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
+
+**请求内容示例:**
+
+```
+URI：https://ip:port/epay/api/cardmanage/cardpwdresetapp_id:10001cardno:123sign:1231231234sign_method:HMAC
+```
+
+**返回示例:**
+
+- 成功
+
+```
+{
+
+ "retcode":"0", "retmsg":"签到成功", "termid":123, "termseqno":58, "checknum":123454, "cardno":456, "opername":"张三", "operid":45, "authcode": 64551, "batchno": 4757, "hostdate": "20160803", "hosttime": "154311", "mainkey": "434582727485", "timestamp":"20160606150902", "sign":"hjAtBGygGjFyOKEZmWdxi1tk51/xqLYTr5tm2+zQVfD1RHRzGVC9GNm4ZaXnUsHnu5o3kAZ4U32m0YNiSFpncs0pl1AnnCf1n2hhn39ruABsvD//GzkEINHjyHsnxBr44G2UhyNxplUj+s7s0a7ggjbiMk+BYC3u7VkU9/l+kZOTkEyqs+wZKumfByMZGvKVkY2c2Nr67RaSWd7bsfOJ6HYw2spvu3ptAo2RTrfCxZ0Kn5DcSDm4cagzPMZSHxB8isqqNGrdUaAU0wzzC7704iA5zze//SvCqpCJfYt0OrHOiJEN5kw1d4KESrKGMG6bezlXzAp0LbNlhl+HwZJcag==", "sign_method": "RSA"}
+
+```
+
+- 失败
+
+```
+{
+
+ "retcode":"1", "retmsg":"操作员密码错误", "timestamp":"20160606150902", "sign": "hjAtBGygGjFyOKEZmWdxi1tk51/xqLYTr5tm2+zQVfD1RHRzGVC9GNm4ZaXnUsHnu5o3kAZ4U32m0YNiSFpncs0pl1AnnCf1n2hhn39ruABsvD//GzkEINHjyHsnxBr44G2UhyNxplUj+s7s0a7ggjbiMk+BYC3u7VkU9/l+kZOTkEyqs+wZKumfByMZGvKVkY2c2Nr67RaSWd7bsfOJ6HYw2spvu3ptAo2RTrfCxZ0Kn5DcSDm4cagzPMZSHxB8isqqNGrdUaAU0wzzC7704iA5zze//SvCqpCJfYt0OrHOiJEN5kw1d4KESrKGMG6bezlXzAp0LbNlhl+HwZJcag==", "sign_method":"RSA"}
```
**返回参数说明:**
-| 参数名 | 类型 | 说明 |
-| --- | --- | --- |
-| retcode | String | 返回码（0=成功，其他为失败） |
-| retmsg | String | 返回消息 |
-| newcardpwd | String | 新密码，成功时返回 |
-| sign | String | 签名 |
-| sign_method | String | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
+| 参数名 | 类型 | 说明 |
+| :-------- | ------- | ---------------------------------- |
+| retcode | String | 返回码（0=成功，其他为失败） |
+| retmsg | String | 返回消息 |
+| mfkey | String | 读卡密钥 |
+| termid | integer | 终端号 |
+| termseqno | integer | 终端流水号 |
+| shopid | Integer | 商户号 |
+| shopname | String | 商户名称 |
+| sign | String | 签名 |
+| 签名 | String | 参数的加密方法选择，可选值是：HMAC 加密方式为HAMC-SHA1 |
-
-
-
-
-
+