网银在线支付B2C系统商户接口文档

B2C系统商户接口规范

版本号4.0

网银在线（北京）科技有限公司

目   录

1.    文档介绍    1

1.1.    读者对象    1

1.2.    版权声明    1

2.    支付接口    2

2.1.    商户 >>> 网银在线支付    2

2.2.    网银在线支付 >>> 商户（页面返回）    5

2.3.    网银在线支付 >>> 商户（服务器返回）    6

2.4.    网关错误编码表    6

1.文档介绍

1.1.读者对象

商户系统设计人员、编程人员及测试人员

1.2.版权声明

此文档版权归网银在线（北京）科技有限公司所有。作为本系统的最终用户，可以拥有该份文档的使用权，但未征得网银在线（北京）科技有限公司的书面批准，不得向第三方借阅、出让、出版该文档。

2.支付接口

2.1.商户 >>> 网银在线支付

示例程序：ChinaBank.html

用途：收集信息并发送到数据发送页即Send页

订单号：                 //选填项，订单号 

收货人姓名：             //选填项，总长不超过80字符 

收货人地址：             //选填项，总长不超过200个字符 

收货人电话：             //选填项，总长不超过50个字符 

收货人邮编：             //选填项，总长不超过10个字符 

收货人邮件：             //选填项，总长不超过100个字符 

收货人手机号：         //选填项，总长不超过13个字符 

备注1：                 //选填项，总长不超过150个字符 

订货人姓名：             //选填项，总长不超过80字符 

订货人地址：             //选填项，总长不超过200个字符 

订货人电话：             //选填项，总长不超过50个字符 

订货人邮编：             //选填项，总长不超过10个字符 

订货人邮件：             //选填项，总长不超过100个字符 

订货人手机号：         //选填项，总长不超过13个字符 

备注2：                 //选填项，总长不超过150个字符 

订单总金额（元）：     *必填项，譬如：0.01

示例程序：Send.asp、Send.aspx、Send.php、Send.jsp

用途：接收ChinaBank.html发送过来的数据加密后发往网银在线电子支付平台的接口网关

1、支付平台网关接口地址

    2、FORM表单参数

表单参数如表1，具体定义如表2。说明：蓝色部分为必填项，黄色部分与网上支付货款无关，建议不用

                    商户编号

订单编号

                    订单总金额

                币种

支付动作完成后返回到该url，支付结果以POST方式发送

                 订单MD5校验码

               备注字段1

               备注字段2

                    收货人姓名

               收货人地址

                  收货人电话

                    收货人邮编

         收货人邮件

          收货人手机号

                  订货人姓名

             订货人地址

               订货人电话

                订货人邮编

       订货人邮件

       订货人手机号

表1    

支付表单中的变量定义：

      —    必填项

      —    与网上支付货款无关项，建议不用

    MD5校验串生成方法：当消费者在商户端生成最终订单的时候，将订单中的v_amount v_moneytype v_oid v_mid v_url key六个参数的value值拼成一个无间隔的字符串(顺序不要改变)。参数key是商户的MD5密钥（该密匙可在登陆商户管理界面后自行更改。）

MD5字符串示例：

0.01CNY19990720-1001-0000012341001http://domain/chinabank/Receive.aspkey

注意：得出的32位MD5值需转化为大写。（具体函数使用方法请参见接口示例）

用MD5函数加密该字符串所得值即为我们所需的订单MD5校验码，将其写入v_md5info字段即可。

2.2.网银在线支付 >>> 商户（页面返回）

用途：支付完成后，网银支付平台通过客户浏览器页面链接返回支付结果信息给商户

示例程序：Receive.asp、Receive.aspx、Receive.php、Receive.jsp

返回的信息如下：

该消息格式详细解释如下：v_url是该笔订单提交时参数v_url 的值，即网银返回到商户的接口地址。

2.3.网银在线支付 >>> 商户（服务器返回）

用途：支付完成后，从网银在线支付平台服务器返回给商户支付结果信息

示例程序：AutoReceive.asp、AutoReceive.php、AutoReceive.jsp

信息格式同2.2

接口说明：

每一笔支付订单支付完成后，网银在线服务器会发送支付结果信息到商户接口程序，接口程序进行数字签名验证，验证通过则在页面输出“ok” 校验失败则输出“error”字符串。网银在线服务器在收到“ok”字符串后就不再发送该订单的支付结果信息，否则会自动按照3至4分钟的间隔频率重复发送该支付结果信息。

注意事项：

1.商户接口程序接收网银在线返回的支付结果信息时必须验证订单的实际支付金额是不是和商户自己的系统中原始订单金额一致。

2.2.3接口方式为可选项，商户只需要开发2.1和2. 2两个接口程序就可以完成全部的支付过程。

3.使用2.3接口方式时，服务器返回的信息不带任何Session和Cookie

4.2.3接口程序只能输出字符串“ok”或者“error”，不能有其他任何输出（包括空格、空行），不能跳转到其他页面输出其他内容（因为此页面是后台执行的，客户是看不到的，所以跳转并没有意义）。

5.2.3接口程序开发完成后，商户需要通知网银客服来设置该程序的URL地址。

6.2.3接口程序实时返回银行状态，例如消费者在工商银行支付时输错密码，工商银行会返回支付失败的信息，这时2.3接口程序会返回支付失败的信息，然后该消费者输入了正确的密码，工商银行又会返回支付成功的信息，2.3接口程序又会返回一个支付成功的信息。

7． 2.3接口程序的调用通常先于2.2页面返回。

2.4.网关错误编码表

用途：在接入网关时，可以提示消费者或开发人员接口出现的问题，以便开发人员及时发现问题的出处。