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

布优API网银接口开发指南 商户接口规范 版本(2.0.0) 目录 第一章 文档描述 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 加密算法而导致结果不正确，请各商户在调用接口前对字符串1234567890abcdefghijklmnopqrstuvwxyz 使用MD5 加密算法进行加密，若加密结果为928f7bcdcd08869cc44c1bf24e7abec6 则表示MD5 加密正常。 网银接口定义 同步过程接口定义（商户系统发起请求） 接入URL： /PayBank.aspx (必威体育精装版地址) 接入方式：GET 方式 请求协议参数： 表1 同步过程请求协议参数说明 参数名 参数 可空 加入签名 说明 商户ID partner N Y 商户id,由布优API分配 银行类型 banktype N Y 银行类型，具体参考附录1,default为跳转到布优接口进行选择支付 金额 paymoney N Y 单位元（人民币） 商户订单号 ordernumber N Y 商户系统订单号，该订单号将作为布优接口的返回数据。该值需在商户系统内唯一，布优系统暂时不检查该值是否唯一 下行异步通知地址 callbackurl N Y 下行异步通知的地址，需要以http://开头且没有任何参数 下行同步通知地址 hrefbackurl Y N 下行同步通知过程的返回地址(在支付完成后布优接口将会跳转到的商户系统连接地址)。 注：若提交值无该参数，或者该参数值为空，则在支付完成后，布优接口将不会跳转到商户系统，用户将停留在布优接口系统提示支付成功的页面。 备注信息 attach Y N 备注信息，下行中会原样返回。若该值包含中文，请注意编码 MD5签名 sign N N 32位小写MD5签名值，GB2312编码 MD5签名说明： 待签名数据为表1 中加入签名列值为Y 的参数以及商户密钥，签名顺序为表1 中partner到callbackurl 的顺序加商户密钥。具体MD5 签名源串及格式如下： partner={}banktype={}paymoney={}ordernumber={}callbackurl={}key 其中，key为商户签名。 接入实例：（假设商户 Id 为 10000，商户密钥为 4272fafab8869dbd292d959b7542530c） 请求提交方法： /PayBank.aspx?partner=100