圈存API接收对账单接口文档
diff --git "a/source/_posts/\344\270\200\345\215\241\351\200\232v5\345\234\210\345\255\230\345\257\271\346\216\245\345\211\215\347\275\256\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\234\210\345\255\230\345\257\271\346\216\245\345\211\215\347\275\256\346\216\245\345\217\243\346\226\207\346\241\243.md"
index 792c4cd..081f334 100644
--- "a/source/_posts/\344\270\200\345\215\241\351\200\232v5\345\234\210\345\255\230\345\257\271\346\216\245\345\211\215\347\275\256\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\234\210\345\255\230\345\257\271\346\216\245\345\211\215\347\275\256\346\216\245\345\217\243\346\226\207\346\241\243.md"
@@ -205,57 +205,46 @@
}
```
-### 5. 圈存对账
-* **URL: .../bankservice/{bank}/chargedtlchk**
+### 5. 发送对账单
+* **URL: http(s)://ip:port/epayapi/services/bankservice/sendchkbilldata**
* **请求方式**
`POST`
-圈存流水对账接口,一卡通系统每天定时的访问这个接口查询前一天或过去某一天的全部圈存流水(交易成功),与系统记录的圈存流水进行比对,不一致时进行业务处理。
+API接收对账单统一接口,由前置发起调用。前置拉取对账单后调用此接口向API发送解析后的对账数据。
* **请求**
-- `transdate` - 查询日期,yyyyMMdd
-- `bankcode` - 银行标识
-- `billtype` - 查询类型,有的银行圈存转账和退款可能是分开的。"ALL"-查询圈存和冲正(退款)所有交易成功的流水;"SUCCESS"-查询圈存交易成功的流水;"REFUND"-查询冲正(退款)所有交易成功的流水。
-- `offset` - 偏移量,int型,初始为0
-- `tradetime` - 请求时间, 格式yyyyMMddHHmmss
-- `timeout` - (可选)前置机与银行通讯的超时时间,单位秒,范围 1 ~ 90 , 默认值为10
-- `checkagain` - 重新对账标志,1-是重新对账;0-不是
-- `sign` 签名。除sign的非空字段按上述顺序拼接进行签名加密(transdate + bankcode + billtype + offset + tradetime + timeout + checkagain)。
+- `accdate` - 账单日期,yyyyMMdd
+- `chkcode` - 账单标识,若是银行对账,传银行标识{bankcode}。‘alipay’-支付宝,‘wechat’-微信,‘wmxy’-完美校园等
+- `pageno` - 分批次上传时,pageno逐次递增,初始为1(1,2,3,...),不能跳跃
+- `endflag` - 结束标志。true-全部上传完成,false-未上传完成,还需继续
+- `app_id` - 前置配置的APPID
+- `timestamp` - 时间戳 ‘yyyyMMddHHmmss’
+- `sign ` - 签名数据 (accdate+chkcode+pageno+endflag+APPKEY 最后MD5)
+- `data` -数据集合
+ - `transdate` - 交易日期 yyyyMMdd
+ - `transtime` - 交易时间 HHmmss
+ - `stuempno` - 系统唯一号,如学工号、客户号
+ - `thirdpartaccno` - 支付宝、微信、银行卡号等账号
+ - `refno` - 系统交易参考号,本地流水号
+ - `thirdpartrefno` - 第三方流水号,银行、支付宝、微信流水号
+ - `amount` - 交易金额,单位分。
+ - `billtype` - 流水状态标志。('SUCCESS'-圈存成功流水;‘BEREFD’-被冲正的圈存流水; -'REFUND'-冲正流水)
+
* **返回**
- `retcode` - "0" 标识冲正成功,其它表示错误
- `retmsg` -"msg" 返回信息
-- `hasnext` - true或false。是否继续查询的标志。true继续查询,false结束查询
-- `offset` - 继续查询时的偏移量,int型。
-- `data` - 流水数据集合。
- - `transdate` - 交易日期 yyyyMMdd
- - `transtime` - 交易时间 HHmmss
- - `stuempno` - 系统唯一号,如学工号、客户号
- - `bankcardno` - 银行账号
- - `refno` - 系统交易参考号,
- - `bankseqno` - 银行端流水号
- - `amount` - 交易金额,单位分
- - `billtype` - 圈存或冲正的标志。('SUCCESS'-圈存成功流水;‘BEREFD’-被冲正的圈存流水; -'REFUND'-冲正流水)
-
+- `totalcnt` - 收到的流水笔数
+- `totalamt` - 收到的流水金额,单位分
+
```json
{
"retcode":"0",
"retmsg":"msg", // 返回信息
- "hasnext":true,
- "offset":100,
- "data":[
- {
- "transdate":"20160901",
- "tramsdate":"142328",
- "stuempno":"20170001",
- "bankcardno":"6022111001004394733",
- "refno":"20160901142328000023",
- "bankseqno":"1020160901142328130713",
- "amount":5000,
- "billtype":"SUCCESS"
- },...]
+ "totalcnt":100,
+ "totalamt":234000
}
```