接口文档说明示例

支付网关说明文档by:Q294500001

目录

##联盟支付网关说明文档 ..................................................................... 错误!未定义书签。 目录 .................................................................................................................................................. 1 第一章 文档描述 ........................................................................................... 错误!未定义书签。

1、文档说明 ............................................................................................................................. 1 2、阅读对象 ............................................................................................................................. 1 第二章 系统原理 ............................................................................................................................. 2

1、术语定义 ............................................................................................................................. 2 2、消费流程 ............................................................................................................................. 2 3、查询流程 ............................................................................................................................. 2 4、系统加密 ............................................................................................................................. 2 第三章 网银接口定义 ..................................................................................................................... 3

1、同步过程接口定义(商户系统发起请求) ..................................................................... 3 2、下行异步通知过程接口定义(##联盟接口发起请求) ................................................. 5 3、下行同步通知过程接口定义(##联盟接口发起请求) ................................................. 7 第四章 查询流程接口定义 ............................................................................................................. 8 第五章 订单外部查询独立网址 ................................................................... 错误!未定义书签。 附录1:##联盟支付网关银行类型说明 ........................................................................................ 9

第一章 文档描述

1、文档说明

本说明文档用于指导##联盟商户实现与##联盟网银接口的顺利对接。请相关技术人员详细阅读本文档。

2、阅读对象

商户开发人员。

第二章 系统原理

1、术语定义

商户:指已独立拥有在线销售系统,并成为##联盟网银接口系统会员,且已使用或者将使用##联盟网银接口实现收付费或其他相关功能需求的企业或者个人。

外部接入接口:指##联盟通过统一的方式接受外部请求的接口。

商户系统:指使用##联盟外部接入接口的计算机系统,一般指商户所拥有的在线销售系统。

用户:指在商户系统内进行消费的企业或者个人。

商户ID: 指##联盟为使用外部接入接口的商户统一分配的唯一标识。

商户密钥:指商户在和##联盟确定合作意向时##联盟为商户提供的16位字符串。该信息作为商户系统和##联盟交互时身份确认的依据,需商户妥善保管。

2、消费流程

通常,一次支付最少包括2个交互过程。第一个过程是商户系统将在线支付等信息提交到##联盟接口的过程,称之为上行过程。第二个过程是在支付完成后,##联盟接口通过server to server方式将支付结果告知商户系统的过程,称之为下行异步通知过程。

如果用户在跳转到##联盟接口完成支付操作后,需要##联盟接口将处理结果立即返回给商户系统的下一步页面,让用户继续完成整个操作流程,此时支付还应包括第三个流程,下行同步通知过程。该过程需要在上行过程中提交参数hrefbackurl。

3、查询流程

在商户系统将订单成功提交给##联盟接口后的任意时间,商户系统可发起请求查询订单的处理结果。该流程由商户系统发起,由接口返回相应结果。

4、系统加密

##联盟接口采用MD5加密方式对传输数据进行签名验证,具体请参考相关接口定义。对MD5加密后的签名值,请注意结果的大小写务必正确。

为了确保签名值不是因为MD5加密算法而导致结果不正确,请各商户在调用接口前对字符串1234567890abcdefghijklmnoprstuvwxyz使用MD5加密算法进行加密,若加密结果为

##################################则表示MD5加密正常。

第三章 网银接口定义

1、同步过程接口定义(商户系统发起请求)

1、接入URL:http://************/chargebank.aspx (最新地址)

2、接入方式:GET方式 3、请求协议参数:

表1 同步过程请求协议参数说明

参数名 商户ID 银行类型 金额 参数 parter type value 可空 加入签名 说明 N N N Y Y Y 商户id,由##联盟分配 银行类型,具体请参考附录1 单位元(人民币),2位小数,最小支付金额为0.02 商户订单号 orderid N Y 商户系统订单号,该订单号将作为##联盟接口的返回数据。该值需在商户系统内唯一,##联盟系统暂时不检查该值是否唯一 下行异步通知地址 下行同步通知地址 hrefbackurl Y N callbackurl N Y 下行异步通知过程的返回地址,需要以http://开头且没有任何参数 下行同步通知过程的返回地址(在支付完成后##联盟接口将会跳转到的商户系统连接地址)。 注:若提交值无该参数,或者该参数值为空,则在支付完成后,##联盟接口将不会跳转到商户系统,用户将停留在##联盟接口系统提示支付成功的页面。

联系客服:779662525#qq.com(#替换为@) 苏ICP备20003344号-4