财付通批量银行代付接口开发手册汇编.docVIP

财付通批量银行代付接口开发手册 Version: 3.0 Public date: 2011-5-22 All copyright reserved by T 目 录 第1章 文档描述 5 1.1 文档说明 5 1.2 版本 5 1.3 预期读者和阅读建议 5 第2章 业务描述 5 2.1 接口作用 5 2.2 银行代付接口限制 5 第3章 前期准备 6 3.1.1 业务准备 6 3.1.2 技术准备 6 第4章 接口说明 6 4.1 结构说明 6 4.1.1 接入URL 6 4.1.2 接口原理 7 4.2 批量银行代付接口 7 4.2.1 功能描述： 7 4.2.2 需要开通功能： 7 4.2.3 接入URL 7 4.2.4 输入参数 8 4.2.5 返回参数 9 4.2.6 接口特别说明 9 4.3 批量银行代付查询接口 10 4.3.1 功能描述： 10 4.3.2 需要开通功能： 10 4.3.3 输入参数 10 4.3.4 返回参数 11 4.3.5 返回参数说明 13 4.4 退票查询接口 13 4.4.1 功能描述： 13 4.4.2 需要开通功能： 13 4.4.3 请求参数 13 4.4.4 返回参数 14 第5章 附录和枚举 16 5.1 付款到账时间 16 5.2 银行编码 17 5.3 开户地区编码 19 5.3.1 北京 19 5.3.2 上海 19 5.3.3 天津 19 5.3.4 重庆 19 5.3.5 河北 19 5.3.6 山西 20 5.3.7 内蒙古 20 5.3.8 辽宁 21 5.3.9 吉林 21 5.3.10 黑龙江 22 5.3.11 江苏 22 5.3.12 浙江 23 5.3.13 安徽 23 5.3.14 福建 24 5.3.15 江西 24 5.3.16 山东 25 5.3.17 河南 25 5.3.18 湖北 26 5.3.19 湖南 26 5.3.20 广东 27 5.3.21 广西 27 5.3.22 海南 28 5.3.23 四川 28 5.3.24 贵州 29 5.3.25 云南 29 5.3.26 西藏 30 5.3.27 陕西 30 5.3.28 甘肃 31 5.3.29 宁夏 31 5.3.30 青海 32 5.3.31 新疆 32 5.4 安全性说明 33 5.5 代付查询 33 5.6 代付明细查询 34 5.7 电子回单 35 5.8 对账单下载 35 5.9 财付通对应付款银行说明 36 5.10 财付通付款手机短信通知格式 36 5.11 错误码 37  文档修订日期 修订内容 修订版本 修订人 200-6-18 创建 1.0 2009-8-5 修订 2.0 fadyzhuang 2011-5-22 增加付款接收手机号参数 3.0 amoszhang 2011-7-8 增加界面查询说明 3.1 Sprucezhang 2011-9-15 增加中国邮政储蓄银行银行编码预期读者和阅读建议 接口作用 财付通批量银行代付是对商户账户内的可支配金额，批量转账到用户的银行卡中的解决方案。 银行代付接口限制 银行代付接口不是一个实时到账接口，接口调用成功只代表信息已经提交到财付通，财付通汇总后再提交到银行，银行到账也有一定延迟，一般1~2个工作日后可以到账（各银行的到账时间不同）。 代付接口调用成功后，有可能由于填写用户银行账户信息不完整或其他原因，导致付款失败。商户必须通过查询接口确认用户是否到账。 代付接口中需要按照财付通要求，填写开户地区、开户城市、支行名称等银行信息。 前期准备 业务准备 由于银行代付操作中，会验证商户发起请求的IP、权限等，所以在此之前，需要先申请操作权限以及配置信任IP列表。 申请此业务功能，请联系财付通商务人员 技术准备 因为该接口基于https的安全通信机制，因此商户在选择开发语言时需要能支持HTTPS协议通讯。 接口说明 接口协议源数据为XML格式字符串，源数据经过编码和加密之后生成接口参数。商户端需要完成加密，传输，证书验证等功能的开发。 结构说明 接入URL /cgi-bin/mchbatchtransfer.cgi 支持POST方式。如果付款数据太多，使用GET方式会有问题，建议统一使用POST方式。 接口原理 财付通接口接收两个参数，content和abstract，商户访问的形式是/cgi-bin/mchbatchtransfer.cgi?content=***abstract=***。 这两个参数值的具体生成规则是： 按照4.2、4.3节的规则生成XML字符串A； 对A进行BASE64编码生成B； 对B进行MD5生成C（小写）； C后面加上商户的ke