source/_posts/一卡通v5圈存对接前置接口文档.md

title: 一卡通v5圈存对接前置接口文档 date: 2016-06-21 13:45:23 tags:

日期	版本	作者	说明
2015-4-14	V1.0	汤成	初稿

背景

在项目中进行银行圈存对接开发时需要对悦校与一卡通同时支持，

接口定义

1. 查询银行卡余额

URL: /bankservice/bankquery 请求方式 GET/POST

查询银行余额，根据银行实际情况不是所有银行都支持

请求

bankaccount - 银行账号
custname - 用户名，必须是该用户在银行的开户名（可选）
stuempno - 学工号，可选
termid - 发起终端号
tradetime - 发起方时间，格式 yyyyMMddHHmmss
seqno - 发起方流水号（可选）
timeout - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10

返回

{
    ret:"00",
    retmsg:"msg", // 异常原因
    money:12.3 //单位（元）
}

ret - "00"标识操作成功，其余为异常情况
retmsg - 返回信息
money - 银行卡余额，单位元

2. 圈存请求

URL: /bankservice/load 请求方式 POST

银行圈存请求，通过该请求完成银行卡转账业务

请求

bankaccount - 银行卡号
seqno - 悦校/一卡通交易参考号
stuempno - (可选）学工号
custname - (可选）客户姓名
amount - 圈存金额，单位元
termid - （可选）终端编号
tradetime - 请求时间，格式yyyyMMddHHmmss
timeout - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10

返回

{
    "ret":"00",
    "bankseqno": "1231", // 如果银行支持，返回银行端流水号
    "retmsg":"msg" // 返回信息
}

ret - "00"标识操作成功，其余为异常情况
bankseqno - （可选）返回银行端流水号，但不是所有银行都支持返回银行端流水号
retmsg - 返回信息

3. 圈存结果查询

URL: /bankservice/transquery 请求方式 GET/POST

查询圈存请求的结果，一般是圈存请求超时后通过这个接口判断银行交易是否成功，但不是所有银行都支持这个接口

请求

bankaccount - 银行卡号
seqno - 悦校/一卡通交易参考号
loadseqno - 前一笔圈存交易的参考号
stuempno - (可选）学工号
custname - (可选）客户姓名
amount - 圈存金额，单位元
termid - （可选）终端编号
tradetime - 请求时间，格式yyyyMMddHHmmss
timeout - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10

返回

{
    "ret":"00",
    "bankseqno": 123, // 银行端流水号
    "retmsg":"msg" // 返回信息
}

ret - "00" 标识查询到指定的圈存流水，"01" 标识无指定流水，其它表示错误
bankseqno - （可选）如果查询到圈存流水则返回银行端流水号，但不是所有银行都支持返回银行端流水号
retmsg - 返回信息

4. 圈存冲正

URL: /bankservice/loadcancel 请求方式 GET/POST

圈存冲正接口，一般是圈存请求超时后通过这个接口冲正前面一笔圈存交易，但不是所有银行都支持这个接口

请求

bankaccount - 银行卡号
seqno - 悦校/一卡通交易参考号
loadseqno - 前一笔圈存交易的参考号
stuempno - (可选）学工号
custname - (可选）客户姓名
amount - 圈存金额，单位元
termid - （可选）终端编号
tradetime - 请求时间，格式yyyyMMddHHmmss
timeout - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10

返回

{
    "ret":"00",
    "retmsg":"msg" // 返回信息
    "bankseqno" : 12
}

ret - "00" 标识冲正成功，其它表示错误
bankseqno - （可选）返回银行端流水号，但不是所有银行都支持返回银行端流水号
retmsg - 返回信息