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

小二支付平台接口对接技术文档 商户接入指南 2014年月日 第一章 文档描述 3 1、文档说明 3 2、阅读对象 3 第二章 系统原理 3 1、术语定义 3 2、消费流程 3 3、查询流程 4 4、系统加密 4 第三章 网银接口定义 4 1、上行过程接口定义（商户系统发起请求） 4 2、下行异步通知过程接口定义（小二支付接口发起请求） 7 第四章 查询流程接口定义 10 附录1：小二支付网银接口银行类型说明 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 userid N Y 商户id 银行类型 bankid N Y 银行类型，具体请参考附录1 金额 money N N 单位元（人民币），2位小数，最小支付金额为0.02 商户订单号 orderid N Y 商户系统订单号，该订单号将作为小二支付接口的返回数据。该值需在商户系统内唯一，小二支付系统暂时不检查该值是否唯一 下行异步通知地址 url N N 下行异步通知过程的返回地址，需要以http://开头且没有任何参数 支付用户IP ip N N 用户在下单时的真实IP，小二支付接口将会判断玩家支付时的ip和该值是否相同。若不相同，小二支付接口将提示用户支付风险 备注消息 ext Y N 备注信息，下行中会原样返回。若该值包含中文，请注意编码!默认utf-8 MD5签名 sign N - 32位小写MD5签名值 代理商id agentid N N 代理商id,没有则留空,请勿传’null’ 4、MD5签名说明 待签名数据为表1中加入签名列值为Y的参数以及商户密钥。 具体MD5签名源串及格式如下： userid={0}orderid={1}bankid={2}keyvalue={3} 其中，keyvalue 为商户密钥, 在获取。①根据HTTP协议要求，提交参数的值中若存在特殊字符（如：空格、@等）时，为使小二支付接口能接收到正确的参数，这些特殊字符需要做URL Encoding。需特别注意的是，此时待签名数据应该是原生值而不是encoding之后的值。 2、下行异步通知过程接口定义（小二支付接口发起请求） 1、接入URL：过程1中请求参数callbackurl值 2、接入方式：GET方式 3、请求协议参数： 表2 下行过程请求协议参数说明 参数名 参数 加入签名 说明 商户订单号 orderid Y 上行过程中商户系统传入的orderid。 订单结果 succ Y Y:支付成功；N：支付失败(为大写) 订单金额 ovalue Y 订单实际支付金额，单位元 小二支付