银行卡网上支付 网上银行网上银行（北京）科技有限公司 修改记录 版本号 修改者 修改章节 修改内容 修改日期 4.2 阅读后如有疑问，请联系网上银行相关技术支持。 术语表 商户消费购物B2C系统——商户直销银行接口规范版本（V4.3） 1. 文档说明 41.1． 文件目标 41.2。 41.3. 读取对象术语保留 42。 界面开发 52.1。 付款流程演示 52.2。 72.3. 数据交互过程参数说明 82.3.1 编码格式 82.3.2 商户提交至网银 82.3.3 网银返回商户 92.3.3.1 通过浏览器返回 92.3.3.2 服务器异步通知功能 102.4. 开发注意事项 112.4.1 必须设置MD5密钥 112.4.2 通知支付结果 112.4.3 请勿重复处理订单 122.5. 使用MD5进行安全加密 123. B2C银行借记卡清单 124. B2C银行信用卡清单 135. B2B银行清单 146. 参考资料 146.1. 乱码问题146.2。 常见问题 156.3。 网关错误列表 157。附录 186.1。 网上银行资源 186.2。 技术支持 191. 文件说明 1.1。 文档目的 本文档是网上银行卡在线支付网关接口的附录文档。 详细讲解了技术接口的进入和使用过程中需要注意的事项，帮助商户快速了解并实现在线支付功能。

1.2. 阅读目标商家系统设计人员、程序员和测试人员。 此人需要具备一定的网站开发能力，懂JAVA、ASP、PHP、ASP.NET等其中一种开发语言，对信息安全有一定的了解。 1.3. 预约是指注册为网上银行用户，使用网上银行产品实现其收付款功能需求，并向其用户提供各类产品或相关服务的企业或个人。 是指通过商户网站等系统进行购物的企业或个人。 是指消费者在商户网站上购买相关产品或服务的网上银行在线管理后台。 订单处于支付成功状态，而商户自有网站后台处于未支付状态。 两个后台订单状态不一致的现象称为掉单。 间接直连支付流程如图所示： 数据交互流程 服务器异步通知功能 网银在线服务器将支付结果异步发送至商户网站。 能够解决订单。 相应的程序示例。 消费者在商户网站选择银行，跳转到网上银行页面，选择银行，然后跳转到所选银行的页面进行支付。 消费者在商户网站选择银行，直接跳转至所选银行页面进行支付。 银行ID网上银行用数字代表银行，如“103”代表农业银行，“104”代表中国银行。 商家只能使用，不能更改。 2. 界面开发 2.1． 付款流程演示2.2。 构建请求数据：消费者在商家网站购买商品或服务后，在商家网站提交订单。 消费者在商户网站上进行购买和支付，并从商户网站跳转到网上银行。 页面，选择银行，然后跳转到银行页面进行实际付款。

变量命名长度说明示例商户号订单号订单总金额2银行代码0收货人姓名v_**值自定义。 张三的收货人地址值是自定义的。 收货人电话号码可定制。 收货人的邮政编码值是自定义的。 价值定制。 价值定制。 价值定制。 John Doe 的 200 项价值定制。 50个值可定制。 价值定制。 0 值是定制的。 13个值定制。 12、商户提交至网银：商户网站系统收集支付相关信息，如订单号、支付金额等，提交至网银支付网关（发送文件）处理请求的交易：之后提交后，消费者的浏览器页面会跳转到银行页面进行处理。 支付; 浏览器返回：消费者完成支付后，网银在线支付网关通知商户支付结果，并跳转至商户指定的返回地址页面（接口文档中服务器异步通知：当消费者完成支付时） ，直接关闭在线浏览器 服务器会自动发送交易信息（接口文档）到商户后台；处理相应数据：商户收到支付结果信息后，可以根据具体业务要求进行后续处理。

2.3. 参数说明 2.3.1 编码格式 网银网上接口程序采用gbk 编码。 如果出现乱码，请参考参考资料3.12.3.2。 商户提交至网上银行（参见接口文档中的发送文件）。 支付平台网关接口地址： 提交参数规则： 表1 商户注册后，由网上银行自动分配。 。 订单号的标准格式为：()-商户号-家庭序列号。 订单号中的字符总数不能超过 64 个字符。 -25 同一天内订单号不能重复。 订单号不能包含中文字符。 不能为空，单位：元，保留小数点后两位。 CNY 是人民币 URL 地址。 消费者完成购买后页面返回的商户页面。 URL参数是以校验码开头的完整URL地址。 具体请参见md5的相关说明。 网上银行是在线定义的。 银行代码参考“第12页银行借记卡列表”和“第13页银行信用卡栏备注值”进行定制。 备注1 备注2 结果通知页面，如果有值，则按照写入的地址进行通知； 如果没有值，则不会发出任何通知。 未能通知可能会导致订单被删除。 [url:=].北京海淀1 收货人@test 收货人手机号 订购者姓名 订购** 地址 北京海淀2 订购者电话 订购者邮政编码 订购者@test 订购者手机号 验证串生成方式：消费者生成最终订单时在商户端，订单中的六个参数的值被无间隙地组合成一个字符串（订单不会改变）。

参数key为商户的MD5密钥。 MD5 字符串示例： 注意：生成的 32 位 MD5 值需要转换为大写。 使用MD5函数加密字符串得到的值就是我们需要的MD5校验码顺序，将其写入字段即可。 2.3.3 网银返回给商户 2.3.3.1 通过浏览器返回（参考接口文档中的文件） 变量名称 变量命名 返回值 描述 订单号 支付状态 支付结果信息 支付完成 支付银行订单总金额 消费者后如果您需要点击支付，甚至关闭浏览器，网银服务器会自动将支付结果发送到商户网站。 附图前四次发送为一分钟一次，第五次为付款后半小时，第六次为一小时，第七次为两小时，第八次为六小时，第九次是十五个小时。 如果您重复处理，会给您的网站造成不必要的损失。 支付后，消费者需要点击银行代码：工商银行1051建设银行104中国银行103农业银行301交通银行通过支付结果返回商户网站。 费费费费费费费 用途：支付完成后，网上支付平台会返回支付信息 费费返回参数 20（表示支付成功） 30（表示支付失败） 付款银行，如工商银行of MD5 验证该参数的MD5字符串的顺序， , t, pe, key MD5字符串如12所示。如果使用MD5函数加密上述字符串后得到的值等于该值，则意味着返回的信息中没有订单的实际支付金额。 实际支付备注字段1 备注字段2 2.3.3.2 服务器异步通知功能（参见接口文档） 费用支付完成后，从网银网上支付平台服务器向商户返回支付结果信息。

返回参数规则见表2。 请注意，商户接口程序在收到网银返回的支付结果信息时，必须验证订单的实际支付金额与商户自身系统中的原始订单金额是否一致。 接口程序只能输出字符，不能有任何其他输出（包括空格和空行）。 服务器异步通知的地址就是订单支付。 具体格式参见2.3.2中提交参数规则表1。 2.4. 开发注意事项 2.4.1 必须设置MD5。 密钥MD5密钥值。 该密钥需要由商户设置和控制。 1.登录网银商户后台； 2、点击导航文字中的“网银支付”，然后点击下一级导航文字“md5密钥设置”； 3.设置md5密钥（例如可以是字母和数字。不能是中文。）。 注意：设置后，md5键不显示内容。 商户需要自己记住秘钥的内容。 2.4.2 付款结果通知。 返回取决于浏览器，需要点击才能返回。 1.返回的内容可以有。 2.消费者可以看到这个退货页面。 3、商户程序可以进行跳转和提示。 4. 可以使用http协议或者http协议。 该通知不依赖于浏览器，无需点击即可执行。

1.发送的内容中没有内容，所以不判断登录。 2、消费者看不到页面，商家程序不应该有多余的html标签。 3、不要跳转到商户程序。 没有防火墙阻止它。 4.不使用协议，仅使用http协议。 2.4.3 请勿重复处理订单。 商户程序收到网上银行的通知后，首先要判断订单是否已经处理完毕。 如果没有，请执行您网站的业务逻辑。 。 如果已经处理过，请勿再次处理该订单。 2.5. 使用 MD5 进行安全加密。 MD5为-5，用于保证信息传输的完整一致。 它是计算机中广泛使用的哈希算法之一。 MD5的典型应用是对一条信息（）生成消息摘要（-），以防止其被篡改。 3、B2C银行借记卡列表 3230 邮储银行 3080 招商银行 313 中信银行 314 309 兴业银行 305 民生银行 312 中国光大银行 307 平安银行 311 华夏银行 310 北京银行 3061 广发银行