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

银行卡在线支付 B2C系统商户接口规范 版本 (V4.1) 网银在线（北京）科技有限公司 修改记录 版本号 修改人 修改章节 修改内容 修改日期 4.1 目录 1. 4 1.1. 文档目标 4 1.2. 阅读对象 4 1.3. 术语预定 4 2. 接口开发 4 2.1. 支付流程演示 4 2.2. 数据交互流程 5 2.3. 参数说明 5 2.3.1 编码格式 6 2.3.2 商户提交到网银在线 6 2.3.3 网银在线返回到商户 7 通过浏览器返回 7 服务器异步通知功能 8 2.4. 开发注意事项 8 2.4.1 必须设置MD5密钥 8 2.4.2 通知支付结果 9 2.4.3 订单不要重复处理 10 2.5. 采用MD5进行安全加密 10 3. 参考资料 10 3.1. 乱码问题 10 3.2. 常见问题 10 3.3. 网关错误列表 11 4. 附录 14 4.1. 网银在线资源 14 4.2. 技术支持 14  文档说明 文档目标 本文档是网银在线银行卡在线支付网关接口附录文档，它详细解释了在技术接入与使用过程中需要注意的地方，帮助商户快速理解和实现在线支付功能。 阅读后如有疑问，请联系网银在线相关技术支持。 阅读对象 商户系统设计人员、编程人员及测试人员。该人员需要具备一定的网站开发能力，了解JAVA、ASP、PHP、ASP.NET等开发语言中的一种，并对信息安全有一定的认识。 术语预定 名词 解释 商户 指已注册成为用户、并使用产品实现其收付费功能需求、为其用户提供各类产品或者相关服务的企业或个人。 指在商户网站等系统购物的企业或个人。 购物 指在商户网站购买相关产品或服务。 网银在线管理后台，订单是支付成功状态，商户自己网站后台是未支付状态。两个后台订单状态不一致的现象称为掉单。 服务器异步通知功能 网银在线服务器异步方式发送支付结果给商户网站。能够解决掉单。对应AutoReceive程序示例。 接口开发 支付流程演示 支付流程演示链接 /aminute/ 支付流程如图： 数据交互流程 构造请求数据：消费者在商户网站选购商品或选择服务后，在商户网站提交订单； 商户提交到网银在线：商户网站系统收集支付相关信息，如订单号、支付金额等提交至网银在线支付网关（接口文档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相关说明 备注1 remark 150 值自定义 备注1 备注2 remark2 150 结果通知页面，如果有值则按照所写地址进行通知如果无值，就不进行通知，不通知会导致掉单。 http://domain/chinabank/AutoReceive.asp]。 是 收货人姓名 v_rcvname 80 值自定义。 张三 收货人地址 v_rcvaddr 200 值自定义。 是 收货人电话 v_rcvtel 50 值自定义。 588156661 收货人邮编 v_rcvpost 10 值自定义。 100