小2支付网银接口对接技术文档V1.0版..docVIP

小二支付网银接口说明文档 小二支付平台网银接口对接技术文档 商户接入指南 HYPERLINK  2014年12月30日 目录 TOC \o 1-3 \h \z \u   HYPERLINK \l _Toc281327929 第一章 文档描述  PAGEREF _Toc281327929 \h 3  HYPERLINK \l _Toc281327930 1、文档说明  PAGEREF _Toc281327930 \h 3  HYPERLINK \l _Toc281327931 2、阅读对象  PAGEREF _Toc281327931 \h 3  HYPERLINK \l _Toc281327932 第二章 系统原理  PAGEREF _Toc281327932 \h 3  HYPERLINK \l _Toc281327933 1、术语定义  PAGEREF _Toc281327933 \h 3  HYPERLINK \l _Toc281327934 2、消费流程  PAGEREF _Toc281327934 \h 3  HYPERLINK \l _Toc281327935 3、查询流程  PAGEREF _Toc281327935 \h 4  HYPERLINK \l _Toc281327936 4、系统加密  PAGEREF _Toc281327936 \h 4  HYPERLINK \l _Toc281327937 第三章 网银接口定义  PAGEREF _Toc281327937 \h 4  HYPERLINK \l _Toc281327938 1、上行过程接口定义（商户系统发起请求）  PAGEREF _Toc281327938 \h 4  HYPERLINK \l _Toc281327939 2、下行异步通知过程接口定义（小二支付接口发起请求）  PAGEREF _Toc281327939 \h 7  HYPERLINK \l _Toc281327941 第四章 查询流程接口定义  PAGEREF _Toc281327941 \h 10  HYPERLINK \l _Toc281327944 附录1：小二支付网银接口银行类型说明  PAGEREF _Toc281327944 \h 11 第一章 文档描述 1、文档说明 本说明文档用于指导小二支付商户实现与小二支付网银接口的顺利对接。请相关技术人员详细阅读本文档。 2、阅读对象 商户开发人员。 第二章 系统原理 1、术语定义 商户：指已独立拥有在线销售系统，并成为小二支付网银接口系统会员，且已使用或者将使用小二支付网银接口实现收付费或其他相关功能需求的企业或者???人。 外部接入接口：指小二支付通过统一的方式接受外部请求的接口。 商户系统：指使用小二支付外部接入接口的计算机系统，一般指商户所拥有的在线销售系统。 用户：指在商户系统内进行消费的企业或者个人。 商户ID： 指小二支付为使用外部接入接口的商户统一分配的唯一标识。 商户密钥：指商户在和小二支付确定合作意向时小二支付为商户提供的32位字符串。该信息作为商户系统和小二支付交互时身份确认的依据，需商户妥善保管。 2、消费流程 通常，一次支付最少包括2个交互过程。第一个过程是商户系统将在线支付等信息提交到小二支付接口的过程，称之为上行过程。第二个过程是在支付完成后，小二支付接口通过server to server方式将支付结果告知商户系统的过程，称之为下行异步通知过程。 3、查询流程 在商户系统将订单成功提交给小二支付接口后的任意时间，商户系统可发起请求查询订单的处理结果。该流程由商户系统发起，由接口返回相应结果。 4、系统加密 小二支付接口采用MD5加密方式对传输数据进行签名验证，具体请参考相关接口定义。对MD5加密后的签名值，请注意结果全部为小写。 为了确保签名值不是因为MD5加密算法而导致结果不正确，请各商户在调用接口前对字符用MD5加密算法进行加密，若加密结果为25d55ad283aa400af464c76d713c07ad则表示MD5加密正常。 第三章 网银接口定义 1、上行过程接口定义（商户系统发起请求） 接入URL：/bankPay/bank.html 2、接入方式：GET/POST方式 3、请求协议参数： 表1 上行过程请求协议参数说明 参数名参数可空加入签名说明商户ID