昆明市公租房银行接口说明书8.30

1、招商银行昆明分行接口说明书昆明市公租房银行接口说明书编撰：武元编撰日期：2016-7-5保密级别：保密当前版本：1.0.0目录1引言31.1编写目的31.2背景31.3术语定义及缩写说明31.4引用标准42接口设计说明：42.1接口协议42.2请求应答编码说明42.3批量代扣52.3.1代扣请求报文52.3.2代扣请求文件52.3.3代扣应答报文62.3.4代扣处理返回报文62.3.5代扣处理文件62.4批量退款62.5单笔代扣62.5.1 代扣请求72.5.2 代扣应答72.6单笔退款72.6.1 退款请求72.6.2 退款应答72.7物业费查询缴纳72.7.1查询请求72.7.2查询应答7

2、2.7.3缴费请求82.7.4缴费应答82.8房租费查询缴纳82.9 对账82.10 编码说明82.10.1时间、日期82.10.2金额92.10.3银行返回码、商户返回码92.10.4项目编码92.10.5代扣结果编码、退款结果编码91引言1.1编写目的规定昆明市公租房公司与招商银行昆明分行相关缴费业务的接口。1.2背景为实现对昆明市公租房公司下安居房住户的统一管理，解决安居卡持卡客户的综合服务，方便安居卡持卡客户通过我行各种渠道缴纳以及退还相关费用，特制定此接口说明。1.3术语定义及缩写说明 商户：本文中的商户指昆明市公租房公司1.4引用标准无2接口设计说明：2.1接口协议（1）采用TCP

3、/IP 流套接字方式。（2）套接字采用短连接、多进程方式。（3）超时限定为1 分钟。（4）数据包内容以管道符（|）为分格标志。（5）数据包内容以（*）起（#）止，数据包最后以0结束。（6） 数据包为一对一方式。（7）每次请求发送一条记录。（8）每次应答返回一条记录。2.2请求应答编码说明批量代扣代扣请求码 05代扣应答码 15代扣处理返回码 06批量退款退款请求码 07退款应答码 17退款处理返回码 08单笔退款退款请求 09退款应答 19单笔代扣代扣请求 10 代扣应答 20物业费查询缴纳查询请求编码 01 查询应答编码 11缴费请求编码 02缴费应答编码 12房租费查询缴纳查询请求编码 0

4、3 查询应答编码 13缴费请求编码 04缴费应答编码 142.3批量代扣 商户方需要批量代扣时组装代扣请求报文发送到银行，银行收到报文后到商户的ftp服务器取代扣请求文件，然后银行组装代扣应答报文发送商户。 银行处理代扣请求文件，完成代扣后 组装代扣处理返回报文发送商户，同时将代扣处理文件通过ftp发送给商户。2.3.1代扣请求报文 本报文由商户发送，银行接收。 格式：*代扣请求码|商户方流水号|商户系统时间|代扣请求文件名|总代扣笔数|总代扣金额|备注#2.3.2代扣请求文件本文件由银行收到商户发来的代扣请求报文后主动去商户ftp获取。格式：文件编码采用GBK文件名为 14位时间-pay.D

5、AT 如 20160705122334-pay.DAT文件内容首行为 总代扣笔数 |总代扣金额|其余每行为一条代扣请求 格式为：序号|身份证号 | 姓名 |卡号 | 项目编码 |缴费开始| 缴费结束|代扣金额|每行中各个字段之间用管道符|隔开，其中序号从1开始依次递增。2.3.3代扣应答报文 银行收到商户的代扣请求报文并取得代扣请求文件后发送此报文给商户 格式： *代扣应答码|商户方流水号|银行返回码|银行返回说明|银行流水号|银行系统时间#2.3.4代扣处理返回报文银行处理完商户的代扣请求文件后发送此报文到商户。格式：*代扣处理返回码|商户方流水号|银行返回码|银行返回说明|代扣处理文件名|

6、代扣总笔数|代扣成功笔数|代扣成功金额|银行流水号|银行系统时间#2.3.5代扣处理文件银行处理完商户的代扣请求文件后生成此文件并通过ftp发送给商户。格式：文件编码采用GBK文件名为相应的代扣请求文件名后加return如 20160705122334-pay-return.DAT文件内容首行为 总代扣笔数 |总代扣金额 |代扣成功笔数 | 代扣成功金额|其余每行为一条代扣请求 格式为：序号|身份证号 | 姓名 |卡号|项目编码|缴费月份| 代扣金额| 代扣结果编码 | 代扣结果说明|每行中各个字段之间用管道符|隔开，其中序号从1开始依次递增。2.4批量退款 批量退款的 请求文件、处理文件名分

7、别为20160705122334-back.DAT、20160705122334-back-return.DAT。也就是将批量扣款中的pay换成back。其余的交易流程、报文格式、文件格式跟批量代扣完全一样，只是相应的编码不同。此处不再赘述。2.5单笔代扣商户组代扣请求报文发送银行，银行处理完后回复代扣应答报文2.5.1 代扣请求*代扣请求编码|商户流水号|商户系统时间|客户身份证号码|客户姓名|客户账号|客户号|缴费开始|缴费结束|项目编码|代扣金额#2.5.2 代扣应答*代扣应答编码|商户流水号|银行返回码|银行返回说明|银行流水号|银行系统时间#2.6单笔退款商户组退款请求报文发送银行，

8、银行处理完后回复退款应答报文2.6.1 退款请求*退款请求编码|商户流水号|商户系统时间|客户身份证号码|客户姓名|客户账号|客户号|项目编码|退款金额#2.6.2 退款应答*退款应答编码|商户流水号|银行返回码|银行返回说明|银行流水号|银行系统时间#2.7物业费查询缴纳用户通过我行各渠道查询物业欠费，缴纳物业费。2.7.1查询请求此报文由银行发送，商户接收格式：*查询请求编码|用户号|查询月份|银行流水号|银行系统时间#注：其中查询月份为六位，如201607. 如果为999999表示查询最早的欠费月份2.7.2查询应答此报文由商户发送，银行接收格式：*查询应答编码|商户返回码|商户返回说明

9、|银行流水号|用户号|查询月份|欠费金额|商户流水号|商户系统时间#2.7.3缴费请求*缴费请求编码|用户号|缴费月份|缴费金额|银行流水号|银行系统时间#2.7.4缴费应答*缴费应答编码|商户返回码|商户返回说明|银行流水号|用户号|缴费月份|缴费金额|商户流水号|商户系统时间#2.8房租费查询缴纳房租费查询缴纳的流程、报文格式和物业费查询缴纳完全一样，只是相应编码不同，此处不再赘述。2.9 对账每日日初银行将上日发生的成功的记账交易按如下格式组装成对账文件发送到商户的ftp服务器。文件编码为：GBK文件名为 8位日期-ACC.DAT,如20160705-ACC.DAT文件首行内容为 自助缴

10、费总笔数|自助缴费总金额|批量代扣总笔数|批量代扣总金额|批量退款总笔数|批量退款总金额|单笔代扣总笔数|单笔代扣总金额|单笔退款总笔数|单笔退款总金额|其余每行为一条明细，包括自助缴费、单笔代扣、单笔退款，不包括批量代扣、批量退款。格式为：序号|类型|银行流水|银行处理时间|商户流水|商户处理时间|项目编码|用户号|缴费月份|金额|其中序号从1开始依次递增。其中类型包括selfpay（自助缴费），payment（单笔代扣），drawback（单笔退款）2.10 编码说明2.10.1时间、日期月份为6位，如201607日期为8位，如20160415时间为14位，精确到秒，如201604151645362.10.2金额不定长，带小数点角分格式。如1023.362.10.3银行返回码