网银在线支付B2C系统商户接口文档v4.1(4)
发布时间:2021-06-06
发布时间:2021-06-06
支付流程演示链接 /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的发送规则:
下一篇:初三化学上学期知识点