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 - 返回信息 money - 银行卡余额，单位元

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

2. 圈存请求

URL: /bankservice/load
请求方式 POST

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

请求 bankaccount - 银行卡号 seqno - 悦校/一卡通交易参考号 stuempno - (可选）学工号 custname - (可选）客户姓名 amount - 圈存金额，单位元 termid - （可选）终端编号 tradetime - 请求时间，格式yyyyMMddHHmmss timeout - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
返回 ret - "00"标识操作成功，其余为异常情况 bankseqno - （可选）返回银行端流水号，但不是所有银行都支持返回银行端流水号 retmsg - 返回信息

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

3. 圈存结果查询

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

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

请求 bankaccount - 银行卡号 seqno - 悦校/一卡通交易参考号 loadseqno - 前一笔圈存交易的参考号 stuempno - (可选）学工号 custname - (可选）客户姓名 amount - 圈存金额，单位元 termid - （可选）终端编号 tradetime - 请求时间，格式yyyyMMddHHmmss timeout - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
返回 ret - "00" 标识查询到指定的圈存流水，"01" 标识无指定流水，其它表示错误 bankseqno - （可选）如果查询到圈存流水则返回银行端流水号，但不是所有银行都支持返回银行端流水号 retmsg - 返回信息

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

4. 圈存冲正

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

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

请求 bankaccount - 银行卡号 seqno - 悦校/一卡通交易参考号 loadseqno - 前一笔圈存交易的参考号 stuempno - (可选）学工号 custname - (可选）客户姓名 amount - 圈存金额，单位元 termid - （可选）终端编号 tradetime - 请求时间，格式yyyyMMddHHmmss timeout - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
返回 ret - "00" 标识冲正成功，其它表示错误 bankseqno - （可选）返回银行端流水号，但不是所有银行都支持返回银行端流水号 retmsg - 返回信息

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