支付宝公共事业缴费接口规范.docVIP

第 PAGE 21页 共 NUMPAGES 62页 支付宝公共事业缴费接口规范 副标题：通讯报文接口 版本 8.1 修订历史 版本号 作者 内容提要 核准人 发布日期 1.0 **** 起草标准通讯报文 2009-06-08 2.0 **** 更新对账及错误码 2012-05-22 3.0 **** 添加以机构或支付宝为准的对账文件格式 2012-07-03 4.0 **** 更新缴费模式，开放欠费自由缴模式的余额显示，以及以机构为准的对账文件格式与上传到sftp的时间要求与规则 2013-07-29 5.0 **** 新增实时订阅接口 新增发账单-标准文件交互 2014-03-24 6.0 **** 新增补销账处理 2014-05-19 6.1 修改.2，新增捞取对账流水时间基准说明 2014-07-30 修改.2下的例子主要是时间格式的变更（线上解析groovy脚本变更导致） 2014-08-13 修改5.1.2、5.2.2、5.3.2、5.5.2业务约束.。删除了7补销账部分，整合到了5.3中。 2014-08-20 6.2 更新5.2.4销账请求格式说明，删除billDate，新增params 2014-09-09 7.0 黄翔翔 新增5.7清算后退款模块 2014-10-28 新增2个查询错误码1007、1009，细节优化 2014-10-30 修改5.6.4这一章节，优化对账表述。 2014-11-13 新增3个查询错误码1021、1022、1023 2015-03-27 新增2个销账错误码2006、2007、4006 2015-04-08 沈建平 销帐新增处理中错误码: UNDERWAY 章节5.3异步通知交互通讯 billNo 升级32位 2015-07-28 钱天福 新增2008销账失败返回码 2015-08-28 7.1 黄翔翔 5.1.5 添加余额说明 修复流水号长度为28位，非32位 将5.5实时订阅报文章节设为过时，不再支持 新增若干最新错误码 2016-06-07 8.0 章淑芬 5.1、5.2新增错误码 删除不再支持的5.5缴费单实时订阅报文 修改5.7对账文件 2018-02-07 8.1 章淑芬 5.7轧差退款更新 2020-04-08 目 录 TOC \o 1-3 \h \z \u 1 概述 8 1.1 名词解释 8 1.2 目标读者 9 1.3 版本规范 9 2 交互模式 10 2.1 请求/响应交互模式 10 2.2 外部系统主动通知交互模式 10 3 数据格式 11 3.1 字符集约定 11 3.2 参数名约定 11 3.3 基本参数约定 11 3.3.1 金额单位 11 3.3.2 日期格式 12 4 报文说明 12 4.1 报文格式 12 4.1.1 基本格式 12 4.1.2 说明 13 4.2 报文模板 14 4.2.1 请求报文模板 14 4.2.2 响应报文模板 14 4.3 错误码 16 4.3.1 基本错误码 16 4.3.2 业务错误代码 17 4.3.3 通知错误码 17 5 标准通讯报文 17 5.1 查询缴费单信息报文 17 5.1.1 接口描述 17 5.1.2 业务约束 18 5.1.3 协作模式 18 5.1.4 请求格式 18 5.1.5 应答格式 20 5.1.6 业务错误码 24 5.2 缴费单销账报文 26 5.2.1 接口描述 26 5.2.2 业务约束 26 5.2.3 协作模式 26 5.2.4 请求格式 27 5.2.5 应答格式 29 5.2.6 业务错误码 32 5.3 缴费单销账结果通知（异步通知） 33 5.3.1 接口描述 33 5.3.2 业务约束 33 5.3.3 协作模式 33 5.3.4 请求格式 33 5.3.5 应答格式 35 5.3.6 业务错误码 37 5.4 缴费单销账结果查询报文(补销账) 37 5.4.1 接口描述 37 5.4.2 业务约束 37 5.4.3 协作模式 39 5.4.4 请求格式 39 5.4.5 应答格式 41 5.4.6 业务错误码 42 5.5 缴费单实时订阅报文 43 5.5.1 接口描述 43 5.5.2 业务约束 43 5.5.3 协作模式 44 5.5.4 请求格式 44 5.5.5 应答格式 46 5.5.