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

银行卡在线支付

B2C系统商户接口规范

版本 (V4.1)

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

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

修改记录 版本号 4.1 修改人 修改章节 修改内容 修改日期

网银在线(北京)科技有限公司

2 / 16

目 录

1. 文档说明 ..................................................................................................................................................... 4 文档目标 ..................................................................................................................................................... 4 阅读对象 ..................................................................................................................................................... 4 术语预定 ..................................................................................................................................................... 4 接口开发 ..................................................................................................................................................... 4 支付流程演示 ............................................................................................................................................. 4 数据交互流程 ............................................................................................................................................. 6 参数说明 ..................................................................................................................................................... 7 编码格式 ..................................................................................................................................................... 7 商户提交到网银在线 ................................................................................................................................. 7 网银在线返回到商户 ................................................................................................................................. 8

1.1. 1.2. 1.3.

2.

2.1. 2.2. 2.3. 2.3.1 2.3.2 2.3.3

2.3.3.1 通过浏览器返回 ......................................................................................................................................... 8 2.3.3.2 服务器异步通知功能 ................................................................................................................................. 9 2.4. 2.4.1 2.4.2 2.4.3 2.5.

3.

开发注意事项 ........................................................................................................................................... 10 必须设置MD5密钥 ................................................................................................................................ 10 通知支付结果 ........................................................................................................................................... 10 订单不要重复处理 .................................................................................................................................... 11 采用MD5进行安全加密 ......................................................................................................................... 11 参考资料 .................................................................................................................................................... 11 乱码问题 .................................................................................................................................................... 11 常见问题 ................................................................................................................................................... 12 网关错误列表 ........................................................................................................................................... 12 附录 ........................................................................................................................................................... 16

3.1. 3.2. 3.3.

4.

4.1. 网银在线资源 ........................................................................................................................................... 16 4.2. 技术支持 ................................................................................................................................................... 16

1. 文档说明

1.1. 文档目标

本文档是网银在线银行卡在线支付网关接口附录文档，它详细解释了在技术接入与使用过程中需要注意的地方，帮助商户快速理解和实现在线支付功能。

阅读后如有疑问，请联系网银在线相关技术支持。

1.2. 阅读对象

商户系统设计人员、编程人员及测试人员。该人员需要具备一定的网站开发能力，了解JAVA、ASP、PHP、等开发语言中的一种，并对信息安全有一定的认识。

1.3. 术语预定

2. 接口开发

2.1. 支付流程演示

支付流程演示链接 /aminute/ 支付流程如图：

2.2. 数据交互流程

3:处理请求交易

1. 构造请求数据：消费者在商户网站选购商品或选择服务后，在商户网站提交订单；

2. 商户提交到网银在线：商户网站系统收集支付相关信息，如订单号、支付金额等提交至网银在线

支付网关（接口文档send文件）；

3. 处理请求交易：提交后，消费者浏览器页面将跳转到网银在线支付网关页面进行支付；

4. 浏览器返回：消费者支付完成后，网银在线支付网关通知商户支付结果，并跳转至商户指定的返

回地址页面（接口文档中receive文件）；

5. 服务器异步通知：当消费者完成支付后直接关闭浏览器后，网银在线的服务器会自动向商户后台

发送交易信息（接口文档中autoreceive文件）；

6. 对相应的数据进行处理：商户接收到支付结果信息后，可根据具体业务要求进行后续处理。

2.3. 参数说明

2.3.1 编码格式

网银在线接口程序是gbk编码。如果出现乱码问题，详见参考资料3.1

2.3.2 商户提交到网银在线

（参照接口文档中Send文件）

消费者在商户网站购物进行支付，从商户网站跳转到网银在线的页面，选择银行后再跳到银行页面进行实际付款。

支付平台网关接口地址：https:///PayGate

MD5校验串生成方法：

当消费者在商户端生成最终订单的时候，将订单中的v_amount v_moneytype v_oid v_mid v_url key六个参数的value值拼成一个无间隔的字符串(顺序不要改变)。参数key是商户的MD5密钥。 MD5字符串示例：

0.01CNY19990720-20000400-00000123420000400http://domain/chinabank/Receive.aspkey 注意：得出的32位MD5值需转化为大写。

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

2.3.3 网银在线返回到商户

2.3.3.1 通过浏览器返回

（参照接口文档中的receive文件）

消费者支付后，消费者需要点击，支付结果才能通过浏览器返回到商户的网站。 用途：支付完成后，网银支付平台通过消费者浏览器页面链接返回支付结果信息给商户

返回参数规则： 表2

2.3.3.2 服务器异步通知功能

（参照接口文档中AutoReceive）

消费者支付后，不需要进行点击，甚至关闭了浏览器，网银在线的服务器会自动给商户网站发送支付结果。

用途：

支付完成后，从网银在线支付平台服务器返回给商户支付结果信息。返回参数规则见表2。 接口说明：

每一笔支付订单支付完成后，网银在线服务器会发送支付结果信息到商户接口程序，该程序根据订单的校验信息正确如否返回“ok”或者“error”字符串。网银在线服务器在收到“ok”字符串后就不再发送该订单的支付结果信息，否则会自动按照“2.4.2中AutoReceive的发送规则”来发送该支付结果信息。 注意事项：

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

己的系统中原始订单金额一致。

2. 接口程序只能输出字符串“ok”或者“error”，不能有其他任何输出（包括空格、空行）。 3. 自动对账的地址为订单支付时商户所传remark2，具体格式参照2.3.2的提交参数规则表1中

remark2字段，如果remark2为空则不进行服务器对单，可能会造成掉单。

2.4. 开发注意事项

2.4.1 必须设置MD5密钥

MD5密钥值，此密钥需要商户自己进行设置、控制。

1、登陆网银在线商户后台 https:///login.do； 2、点导航文字中的“网银支付”，再点击下一级的导航文字“md5密钥设置”； 3、进行md5密钥设置（比如1234abcd，字母和数字都可以。不要有中文。）。 注意：设置后，md5密钥不显示内容。商户需自己记住秘钥内容 附图

2.4.2 通知支付结果

Receive返回规则

Receive返回依赖浏览器，需要点击才能返回。 1. 返回的内容可以有session。 2. 消费者可以看见这个返回页面。 3. 商户程序可以进行跳转和提示。 4. 可以使用https协议或http协议

AutoReceive的发送规则：

前四次会按照一分钟一次的频率进行发送，第五次是支付后半小时，第六次是一小时，第七次是两小时，第八次是六小时，第九次是十五小时。

AutoReceive的注意事项：

AutoReceive通知不依赖浏览器，不需要点击也会执行。 1. 发送的内容没有session和cookie，不要判断登录。 2. 消费者看不见页面，商户程序不要有多余的html标签。 3. 商户程序不要进行跳转。不要有防火墙进行拦截。 4. 不要使用https协议，只能用http协议

2.4.3 订单不要重复处理

商户程序接收到网银在线的通知后，一定要先判断这笔订单是否已经处理，如果未处理，才执行自己网站的业务逻辑。如果已经处理，就不要重复处理订单。

如果重复处理，会给自己的网站带来不必要的损失。

2.5. 采用MD5进行安全加密

MD5即Message-Digest Algorithm 5，用于确保信息传输完整一致。是计算机广泛使用的杂凑算法之一。MD5的典型应用是对一段信息（Message）产生信息摘要（Message-Digest），以防止被篡改。

3. 参考资料

3.1. 乱码问题

如果你们编码格式是utf-8，在send中，使用下面的代码

<form action="https:///PayGate?encoding=UTF-8" method="POST"

name="E_FORM">

乱码问题中java与c#语言格式比较常见，如果有其它语言格式乱码，请联系网银在线的技术支持

java： 先request.setCharacterEncoding("gbk")，再request.getparameter()

或者new String(v_pmode.getBytes("iso-8859-1"),"GBK") 返回中用了URLEncoder 商户用URLDecoder 试试

c#:

Console.WriteLine("Test OK!");

Request.ContentEncoding = System.Text.Encoding.GetEncoding("GBK");

StreamReader sr = new StreamReader(Request.InputStream, Encoding.GetEncoding(936)); String query = sr.ReadToEnd();

ValueCollection reqResult = HttpUtility.ParseQueryString(query, Encoding.GetEncoding(936));

v_pstring = reqResult["v_pstring"]; v_pmode = reqResult["v_pmode"];

3.2. 常见问题

Q1: 消费者支付以后，自己网站的订单不显示成功。 答：问题的原因是商户网站没有接收到返回,发生了掉单。

解决办法：商户网站必须要有服务器自动发送功能（2.3.3.2内容），才能解决。

Q2: 数据签名验证未通过

答：必须要设置自己的密钥，参照2.4.1进行设置。

如果已经设置，还是出错，用网银在线的商户号1001，密钥test来测试。 如果不报错，证明是商户的密钥设置的有问题。 如果还报错，请网站的技术联系我们的技术支持。

Q3:参数错误,该商户ID不存在

答：商户号是8位数字，要保证正确。商户号的后面不要有空格。

Q4:错误的数据格式,不能解析

答：网站的支付程序有错误的地方，请使用IE浏览器测试或者让网站的技术联系我们的技术支持。

3.3. 网关错误列表

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

200903 201001 201002 201005 201006 201007 201008 201009 201010 201011 201012 201101 201102 201103 201104 201105 201106 201107 201108 201109 201110 201111 201112 201113 201114 201300 300800 500700 500701 500702 500703 500704网银在线 (北京) 科技有限公司

数据签名验证未通过 工行验证返回签名未通过,可疑银行交易 安全验证,中行 MD5 验证出现错误 服务拒绝,CCB 签名验证错误 服务拒绝,CBP 签名验证错误 服务拒绝,CMB 签名验证错误 服务拒绝,CMBC 签名验证错误 服务拒绝,COMM 签名验证错误 服务拒绝,广发行签名验证错误 服务拒绝,广银联签名验证错误 服务拒绝,深发展签名验证错误 MASTER 验证 VISA 订单数据

验证错误 JCB 外卡验证错误 安全验证 VE ,验证失败 安全验证失败 服务暂停,该号列入风险控制,交易存在风险 商户外卡支付要求 3D 验证 存在未知风险,或风险未明确定义 验证异常，存在风险,请稍后重试 支付超出日限额,受风险控制 支付次数过多,已列入风险控制中,请改日继续支付 支付单笔超出限额 超出单一 IP 支付次数 商户已列入黑名单控制 安全验证,VE 验证失败 缺少必要的服务参数 参数错误,订单不能保存 请求非法,订单不存在 服务拒绝,该服务未提供 商户找不到,请确认已注册 非正常商户状态13 / 16

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

500705 500706 500708 500709 500710 500800 500902 500903 501101 501102 501103 501104 501105 501106 501107 501108 501109 501110 501111 501112 501113 501114 501115 501116 501117 501118 501119 501120 501121 501122 501123 501124网银在线 (北京) 科技有限公司

订单支付信息未找到 操作失败,状态更新失败 参数错误,该商户 ID 不存在 商户未开通外卡支付 该商户未启用支付直通服务,错误的服务编码 错误的数据格式,不能解析 参数错误,缺少订单号 参数错误,订单号过长 服务拒绝,重复的服务请求 重复的服务请求 参数错误,订单号不能空 参数错误,请填写金额 参数错误,支付结果处理失败 服务可疑,支付结果金额不一致 服务超时中止,订单不存在 提交的参数有误 缺少必要的参数或参数不能识别 币种参数有误,不支持该币种 缺少必要返回参数 idx ,服务不能识别 参数错误,非法金额参数 参数错误,金额超出范围 参数错误,金额不能为 0 返回地址过长 错误的返回地址格式 订单名称过长 订单域信息超出定义长度 订单自定义服务项过长 EMAIL 地址不能空 无效的 EMAIL 地址 无效的手机号码 提供的消息内容过长 该订单未支付14 / 16

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

501125 501126 501127 501128 501129 501130 501131 501132 501133 501604 511101 511601 511602 511603 601000 601001 601002 601003 601300 601301 601302 601303 601304 601305 601306 601307 601308 601500 601600 700000 700001 700002网银在线 (北京) 科技有限公司

该订单支付状态失败 无效订单状态,服务拒绝 该订单已经支付成功,请勿重复支付 该订单已被禁止支付 邮政编码格式错误 购买的商品列表过多,请分次购买 无效订单,或者订单参数不能识别 该支付不支持此支付金额,无效金额 不能识别的订单版本号 服务拒绝,服务未开通 安全验证,订单验证失败 服务拒绝,错误服务编号或者该服务未开通 服务拒绝,请求的服务已经中止 服务拒绝,服务未激活 中行网络故障,服务不能提供 请求银行数据签名失败，服务中止 银行网络故障,服务不能提供 请求交通银行数据签名失败，服务中止 通信

超时或服务拒绝 服务拒绝 该信用卡未在发卡行开通 3D 验证服务 发卡行无法对该卡认证 支付验证失败，支付取消 支付验证失败,请稍后重试 持卡人认证失败 持卡人未能成功认证或认证存在风险 与收单行通信失败,稍后重试 商户支付服务已经停止使用 请求数据时网络故障,稍后重试 您的操作超时,请重新选择支付服务 该订单多次提交,已禁止继续支付 支付结果处理失败,请与客服联系15 / 16

4. 附录

4.1.网银在线资源

网银在线官网地址：

B2C银行卡支付的接口文档：/gateway/chinabank.zip

4.2.技术支持

如果您有任何技术上的疑问，可按如下方式联系我们 邮箱： ts@

本文来源：https://www.bwwdw.com/article/0s51.html