中国银行B2C商户端接口说明〔ver2.3〕.doc

中国银行网上支付 B2C商户端接口说明 -- PaymentGateway Interface Specification 单位 电子渠道开发部（网银团队） 撰写人 曹克、孙永、延冰、陈卫强、梁栋 版本 V2.3  序号 修改人 日期 修改说明 1 曹克 2008.10.28 创建文档，编写文档提纲。 2 陈卫强 2008.10.29 添加接口报文章节内容 3 孙永 2008.10.29 添加安全章节内容 4 曹克 2008.10.30 添加前言，补充及通讯协议章节，修改文档格式 5 延冰 2009.12.28 1、在2.2.1商户发送支付指令中增加WAP商户系统发送订单指令的指令参考 6 延冰 2009.12.29 1、增加银行主动通知接口：网关发送B2C支付结果通知 7 延冰 2010.01.28 1、在2.3.2签名与验签一节中增加商户验证银行数字签名异常后的处理 8 延冰 2010.04.15 1、在指令说明中增加：商户主动发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式 9 延冰 2010.08.30 1、修改2.2.1商户发送支付指令 接口名称为 商户发送网银支付订单；增加2.2.2商户发送手机银行支付订单；修改2.2.2 支付结果反馈接口 为 银行反馈订单支付结果；修改2.2.3 支付状态查询接口 为 商户查询订单信息；修改2.2.8 网关发送B2C支付结果通知 为 银行发送B2C支付结果通知； 2、支付结果反馈接口返回项增加：客户支付IP、客户浏览器Refer、银行交易流水号、返回操作类型； 3、增加联机退款接口：商户发送B2C退款指令； 4、网关发送B2C支付结果通知中增加：客户支付IP、客户浏览器Refer、银行交易流水号、返回操作类型； 5、在附件3.1中增加商户批量退货文件示例； 6、增加附件3.2错误码说明；  1 前言 5 1.1 文档说明 5 1.1.1 编写目的 5 1.1.2 参考资料 5 1.2 适用读者 5 2 接口规约 6 2.1 通讯协议 6 2.2 接口报文 8 2.2.1 商户发送网银支付订单 8 2.2.2 商户发送手机银行支付订单 10 2.2.3 银行反馈订单支付结果 13 2.2.4 银行发送B2C支付结果通知 15 2.2.5 商户查询订单信息 19 2.2.6 商户发送B2C退款指令 23 2.2.7 批量退货及反馈文件格式 28 2.2.8 业务对账文件格式 30 2.2.9 清算对账文件格式 31 2.3 安全机制 33 2.3.1 安全机制简介 33 2.3.2 签名与验签 33 3 附件 36 3.1 批量文件接口示例文件 36 3.2 错误码说明 36  前言 文档说明 本文描述了中国银行网上支付相关服务通讯协议、报文格式、安全机制。作为商户端系统技术人员开发的参考文档。 编写目的 为使商户端系统开发人员了解网上支付服务的相关通讯接口细节。 参考资料 中国银行网上支付相关的业务流程见《商户端开发指引》。本文不再复述。 适用读者 商户端系统开发人员（分析师、设计人员、程序员）。  接口规约 通讯协议 目前网银系统支持三种方式与商户之间传递信息： 通过客户浏览器间接通讯： a. 商户引导客户浏览器，将信息提交到网银系统，商户系统发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。商户发送支付指令接口采用该方式通讯。表单数据中需包含商户对订单信息的签名。 b. 网银引导客户浏览器将信息提交到商户系统。银行反馈订单支付结果接口采用该通讯方式。表单数据中包含网银系统的签名信息。 商户操作员通过浏览器操作网银： 商户操作员登录网银操作网银功能，用来提交批量退货文件，下载业务对账文件与清算对账文件。（网银系统提供的其他商户操作员功能如状态查询等由于不涉及系统之间的接口规范，因此不再描述） 直接通讯： 商户系统与网银系统之间直接建立通讯链路，商户系统采用HTTPS协议主动发起通讯，商户系统发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。商户查询订单信息、商户发送B2C退款指令接口采用此通讯方式。银行系统为保证商户收到订单支付处理结果，采用主动通知方式向商户发送B2C支付结果，银行系统采用POST方式向订单中接收通知的商户URL发送支付结果信息。  接口报文 商户发送网银支付订单 接口名称： RecvOrder.do 接口说明： 客户在商户网站确认进行订单支付，选择中行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统序号 名称 字段 最大长度 说明 01商户号 m