网银在线支付b2c系统-商户直连银行接口文档v44.docVIP

银行卡在线支付 B2C系统-商户直连银行接口规范 版本 (V4.3) 网银在线（北京）科技有限公司 修改记录 版本号 修改人 修改章节 修改内容 修改日期 4.2 目录 录 3 1. 文档说明 4 1.1. 文档目标 4 1.2. 阅读对象 4 1.3. 术语预定 4 2. 接口开发 5 2.1. 支付流程演示 5 2.2. 数据交互流程 7 2.3. 参数说明 8 2.3.1 编码格式 8 2.3.2 商户提交到网银在线 8 2.3.3 网银在线返回到商户 9 通过浏览器返回 9 服务器异步通知功能 10 2.4. 开发注意事项 11 2.4.1 必须设置MD5密钥 11 2.4.2 通知支付结果 11 2.4.3 订单不要重复处理 12 2.5. 采用MD5进行安全加密 12 3. B2C银行借记卡列表 12 4. B2C银行信用卡列表 13 5. B2B银行列表 14 6. 参考资料 14 6.1. 乱码问题 14 6.2. 常见问题 15 6.3. 网关错误列表 15 7. 附录 18 6.1.网银在线资源 18 6.2.技术支持 19  文档说明 文档目标 本文档是网银在线银行卡在线支付网关接口附录文档，它详细解释了在技术接入与使用过程中需要注意的地方，帮助商户快速理解和实现在线支付功能。 阅读后如有疑问，请联系网银在线相关技术支持。 阅读对象 商户系统设计人员、编程人员及测试人员。该人员需要具备一定的网站开发能力，了解JAVA、ASP、PHP、ASP.NET等开发语言中的一种，并对信息安全有一定的认识。 术语预定 名词 解释 商户 指已注册成为用户、并使用产品实现其收付费功能需求、为其用户提供各类产品或者相关服务的企业或个人。 指在商户网站等系统购物的企业或个人。 购物 指在商户网站购买相关产品或服务。 网银在线管理后台，订单是支付成功状态，商户自己网站后台是未支付状态。两个后台订单状态不一致的现象称为掉单。 服务器异步通知功能 网银在线服务器异步方式发送支付结果给商户网站。能够解决掉单。对应AutoReceive程序示例。 非直连 消费者在商户网站上选择银行，跳转到银行页面进行支付。 直连 消费者在商户网站上选择银行，直接跳转到银行页面进行支付。 银行id 网银在线用数字来代表银行。比如“103”代表农业银行，“104”代表中国银行。商户只能使用，不能改动。 接口开发 支付流程演示 支付流程如图： 数据交互流程 构造请求数据：消费者在商户网站选购商品或选择服务后，在商户网站提交订单； 商户提交到网银在线：商户网站系统收集支付相关信息，如订单号、支付金额等提交至网银在线支付网关（接口文档send文件）； 处理请求交易：提交后，消费者浏览器页面将跳转到银行页面进行支付； 浏览器返回：消费者支付完成后，网银在线支付网关通知商户支付结果，并跳转至商户指定的返回地址页面（接口文档中receive文件）； 服务器异步通知：当消费者完成支付后直接关闭浏览器后，网银在线的服务器会自动向商户后台发送交易信息（接口文档中autoreceive文件）； 对相应的数据进行处理：商户接收到支付结果信息后，可根据具体业务要求进行后续处理。 参数说明 编码格式 网银在线接口程序是gbk编码。如果出现乱码问题，详见参考资料3.1 商户提交到网银在线 （参照接口文档中Send文件） 消费者在商户网站购物进行支付，从商户网站跳转到网银在线的页面，选择银行后再跳到银行页面进行实际付款。 支付平台网关接口地址：/PayGate 提交参数规则：表1 变量名称 变量命名 长度 说明 举例 可否为空 商户编号 v_mid 否 订单编号 v_oid 64 订单编号标准格式为：订单生成日期(yyyymmdd)-商户编号-商户流水号。订单编号所有字符总和不可超过64位。20000400-12345。订单号当日内不可重复 否 订单总金额 v_amount 8 不可为空，单位：元，小数点后保留两位。 0.01 币种 v_moneytype CNY为人民币 CNY URL地址 v_url 200 消费者完成购物后返回的商户页面，URL参数是以http://开头的完整URL地址 http://domain/chinabank/Receive.asp MD5校验码 v_md5info 32 详情见md5相关说明 银行编码 pmode_id 网银在线定义的银行编码 参照“第12页的银行借记卡列表”和“第13页的银行信用卡列表” 备注1 remark 150 值自定义 备注1 备注2 remark2 150