中国银行网上支付b2c商户端接口说明

《中国银行网上支付b2c商户端接口说明》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、网上支付接口说明中国银行网上支付B2C商户端接口说明--PaymentGatewayInterfaceSpecification单位电子渠道开发部（网银团队）撰写人曹克、孙永、延冰、陈卫强、梁栋版本V2.3第37页网上支付接口说明序号修改人日期修改说明1曹克2008.10.28创建文档，编写文档提纲。2陈卫强2008.10.29添加接口报文章节内容3孙永2008.10.29添加安全章节内容4曹克2008.10.30添加前言，补充及通讯协议章节，修改文档格式5延冰2009.12.281、在2.2.1商户发送支付指

2、令中增加WAP商户系统发送订单指令的指令参考6延冰2009.12.291、增加银行主动通知接口：网关发送B2C支付结果通知7延冰2010.01.281、在2.3.2签名与验签一节中增加商户验证银行数字签名异常后的处理8延冰2010.04.151、在指令说明中增加：商户主动发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式9延冰2010.08.301、修改2.2.1商户发送支付指令接口名称为商户发送网银支付订单；增加2.2.2商户发送手机银行支付订单；修改2.2.2支付结果反馈接口为银行反馈订单支付

3、结果；修改2.2.3支付状态查询接口为商户查询订单信息；修改2.2.8网关发送B2C支付结果通知为银行发送B2C支付结果通知；2、支付结果反馈接口返回项增加：客户支付IP、客户浏览器Refer、银行交易流水号、返回操作类型；3、增加联机退款接口：商户发送B2C退款指令；4、网关发送B2C支付结果通知中增加：客户支付IP、客户浏览器Refer、银行交易流水号、返回操作类型；5、在附件3.1中增加商户批量退货文件示例；6、增加附件3.2错误码说明；第37页网上支付接口说明1前言51.1文档说明51.1.1编写目的5

4、1.1.2参考资料51.2适用读者52接口规约62.1通讯协议62.2接口报文82.2.1商户发送网银支付订单82.2.2商户发送手机银行支付订单102.2.3银行反馈订单支付结果132.2.4银行发送B2C支付结果通知152.2.5商户查询订单信息192.2.6商户发送B2C退款指令232.2.7批量退货及反馈文件格式282.2.8业务对账文件格式302.2.9清算对账文件格式312.3安全机制332.3.1安全机制简介332.3.2签名与验签333附件363.1批量文件接口示例文件363.2错误码说明36第

5、37页网上支付接口说明1前言1.1文档说明本文描述了中国银行网上支付相关服务通讯协议、报文格式、安全机制。作为商户端系统技术人员开发的参考文档。1.1.1编写目的为使商户端系统开发人员了解网上支付服务的相关通讯接口细节。1.1.2参考资料中国银行网上支付相关的业务流程见《商户端开发指引》。本文不再复述。1.2适用读者商户端系统开发人员（分析师、设计人员、程序员）。第37页网上支付接口说明1接口规约1.1通讯协议目前网银系统支持三种方式与商户之间传递信息：Ø通过客户浏览器间接通讯：a.商户引导客户浏览器，将信息提

6、交到网银系统，商户系统发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。商户发送支付指令接口采用该方式通讯。表单数据中需包含商户对订单信息的签名。b.网银引导客户浏览器将信息提交到商户系统。银行反馈订单支付结果接口采用该通讯方式。表单数据中包含网银系统的签名信息。第37页网上支付接口说明Ø商户操作员通过浏览器操作网银：商户操作员登录网银操作网银功能，用来提交批量退货文件，下载业务对账文件与清算对账文件。（网银系统提供的其他商户操作员功能如状态查询等由于不涉及系统之间的接口规范，因此不再描述）Ø直

7、接通讯：商户系统与网银系统之间直接建立通讯链路，商户系统采用HTTPS协议主动发起通讯，商户系统发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。商户查询订单信息、商户发送B2C退款指令接口采用此通讯方式。银行系统为保证商户收到订单支付处理结果，采用主动通知方式向商户发送B2C支付结果，银行系统采用POST方式向订单中接收通知的商户URL发送支付结果信息。第37页网上支付接口说明1.1接口报文1.1.1商户发送网银支付订单接口名称：RecvOrder.do接口说明：客户在商户网站确认进行订单支付

8、，选择中行网上银行支付后，商户系统负责按此数据规格将消费交易信息发往中行支付网关系统；商户主动发往银行网关的指令均以POST方式发送，并且使用UTF8编码格式。数据项说明：序号名称字段最大长度说明01商户号merchantNoX(20)必填BOC商户ID02支付类型payTypeX(10)必填商户支付服务类型1：网上购物2：基金直销03商户订单号orderNoX(19)必填商户系统产生