布优API网银接口说明文档.doc

布优API网银接口开发指南
商户接口规范
版本()
目录
第一章 文档描述 3
1、 文档说明 3
2、 阅读对象 3
第二章 系统原理 3
1、 术语定义 3
2、 消费流程 4
3、 查询流程 4
4、 查询流程 4
第三章 网银接口定义 4
1、 同步过程接口定义（商户系统发起请求） 4
2、 下行异步通知过程接口定义（布优接口发起请求） 6
3、 下行同步通知过程接口定义（布优接口发起请求） 8
附录 1：布优支付网关银行类型说明 8
文档描述
文档说明
本说明文档用于指导布优API商户实现与布优API网银接口的顺利对接。请相关技术人员详细阅读本文档。
阅读对象
商户开发人员。
四川布优网络科技限公司布优API网银接口相关技术人员。
系统原理
术语定义
商户：指已独立拥有在线销售系统，并成为布优API网银接口系统会员，且已使用或者将使用布优API网银接口实现收付费或其他相关功能需求的企业或者个人。
外部接入接口：指布优API通过统一的方式接受外部请求的接口。
商户系统：指使用布优API外部接入接口的计算机系统，一般指商户所拥有的在线销售系统。
用户：指在商户系统内进行消费的企业或者个人。
商户ID： 指布优API为使用外部接入接口的商户统一分配的唯一标识。
商户密钥：指商户在和布优API确定合作意向时布优API为商户提供的16 位字符串。该信息作为商户系统和布优API交互时身份确认的依据，需商户妥善保管。
消费流程
通常，一次支付最少包括2 个交互过程。第一个过程是商户系统将在线支付等信息提交布优支付网关说明文档到布优接口的过程，称之为上行过程。第二个过程是在支付完成后，布优接口通过server to server 方式将支付结果告知商户系统的过程，称之为下行异步通知过程。
如果用户在跳转到布优API接口完成支付操作后，需要布优API接口将处理结果立即返回给商户系统的下一步页面，让用户继续完成整个操作流程，此时支付还应包括第三个流程，下行同步通知过程。该过程需要在上行过程中提交参数hrefbackurl。
查询流程
在商户系统将订单成功提交给布优接口后的任意时间，商户系统可发起请求查询订单的处理结果。该流程由商户系统发起，由接口返回相应结果。
查询流程
布优API采用MD5 加密方式对传输数据进行签名验证，具体请参考相关接口定义。对MD5 加密后的签名值，请注意结果的大小写务必正确。
为了确保签名值不是因为MD5 加密算法而导致结果不正确，请各商户在调用接口前对字符串abcdefghijklmnopqrstuvwxyz 使用MD5 加密算法进行加密，若加密结果为928f7bcdcd08869cc44c1bf24e7abec6 则表示MD5 加密正常。
网银接口定义
同步过程接口定义（商户系统发起请求）
接入URL： (最新地址)
接入方式：GET 方式
请求协议参数：
表1 同步过程请求协议参数说明
参数名
参数
可空
加入签名
说明