网银在线支付快捷支付商户接口规范

文档说明功能描述本文档的目的是提供网银在线快捷支付接口规范,便于商户技术人员接入网银在线快捷支付接口,并掌握网银在线快捷支付的相关功能.

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

技术服务如果您在开发过程中遇到任何技术问题,可以咨询我们的技术支持人员:联系邮箱:010-62428538、62428630功能演示数据交互交易流程(1)商户根据网银在线支付平台提供的接口规则,生成加密报文信息,将请求发送至网银在线快捷支付地址(2)网银在线支付系统对请求数据进行处理,进行安全校验等验证,一系列验证通过后便会解密报文中的加密信息,处理这次发送过来的数据请求.

(4)返回处理的结果数据对于处理完成的交易会以两种方式把数据反馈给商户:1):前台通知:交易结束后,网银在线实时发送给商户2):后台通知:如果商户请求的数据中通知地址不为空,则服务器异步发起通知,按照商户在请求时上送的通知地址发送通知(5)商户对获取的返回结果数据进行处理.
报文格式含义在网银在线快捷支付的所有交易中,请求和响应报文格式均为XML格式.
名词定义名词描述签约使用快捷支付进行付款前,用户及银行卡信息须提交给银行进行验证,以保证信息的准确性.

支付签约完成后,即可进行快捷支付;每次支付前都必须进行签约.
Api访问地址https://quick.
chinabank.
com.
cn/express.
htm响应机制商户向API地址发送post请求,请求参数名称charset和req,charset是告诉快捷业务使用那种编码解码数据(具体查看字符编码表7.
1),req是交易数据(具体数据格式看下文).

商户发送交易数据至快捷业务,快捷业务处理请求,返回响应数据,resp=响应数据有时可能由于商户网络原因没有接到同步响应结果,网银快捷支付、退款接口支持异步通知机制,异步通知机制推送3次响应数据,每次间隔为1分钟.

下文讲解如何发送和解析网银在线快捷支付数据.
明文数据格式如:3.
4请求/响应公共参数列表.
注:各支付接口只有data不同;数据格式为XML形式.

请求/响应公共参数列表字段名变量名类型说明可空VERSION版本号String/101.
1.
0NMERCHANT商户号String/10由网银在线提供NTERMINAL终端号String/10由网银在线提供NDATA持卡人数据和交易数据String按二级参数和三级参数组成XML格式数据,然后使用3DES加密.
NSIGN数据签名String/32MD5签名,签名数据为所有参数加签名密钥N请求相应XML样例格式如下:请求/响应公共报文:1.
1.
02231031800000001N64mYYKJlowxXcDqdJsLqFz1EP1fxld0jgGVmKkabOFWxOlMNUXwApcJkn3j6NXMB7fOa1Q8TsVsWac5HuPDpbA0H23xFPJT3hEghwZoM9JIxoPVDbUeruH9bWu0s9V5wEbI77O42jv3dIs6yXc84SBRjzJoEawq7xQp7tli0P5tHkzfShJ+Y75zMj4mml4yNMTRJaFAYcGRpQ3LW7dZl36m9X2a/C8bAGZs/L3pi33tEc9/cFgpIt9cR8pLSAhxIvcUOv6ViCG1ShpeXZzovmxA/hloRGGXWXjbU+fbyjJ9aWlKkmUFg5b9pZ9xzOExUnRKrfHtzZg0xNEloUBhwamZp3eA1E5PRMLjn8LrEL5JjkGyCyoi9g4B3W73b37FU7NoYOKONaPNwyaxdcFZtKvgr1e65um6CYZ5jET5P7hDDKV3gXpJM9IHnY9A9rUBo0Kx+Q1Agn6dwx1UeI2wzX/D7mB+sUU/2LA/QTZzQUpnZYAoIUQ7LH/D7mB+sUU/gSyKNt+Ut/Fjp+aKsLzTlMndmxARgsrUf8PuYH6xRT/8E5iifJLJXwrawkW/KcRM9zgxMZgCdSV/w+5gfrFFP4Sj8WNP1q74Ejw0/MtF5MOELSmkHwKkxkyPimY9R8qSncMdVHiNsM154HXhN6O3fg==9b54c90ecfb26f948606a58cde4198ec元素是交易过程中的主要数据需要用3DES加密,加密密钥需要在网银在线后台设置;元素是为了验证请求/响应的合法性,是、、元素一起用MD5加密之后的值,MD5加密密钥需要在网银在线后台设置;发送请求时整个XML需要用BASE64编码之后发送其中请求DATA元素格式如下HXBD6226300310013502测试三I32092319830723573113800138000V137147841997912345CNY响应DATA元素格式如下:V137147841997912345CNY0000成功接入范例概述网银在线提供快捷支付:快捷支付每次交易都要进行签约,每次签约时都需要输入验证码验证;接入代码示例1.
XML中的元素用3DES加密.
2.
、、、(3DES加密之后)一起MD5加密形成签名,签名用于校验请求的合法行.

3.
整个XML最后用BASE64编码.
4.
发送POST请求到网线在线快捷支付地址,参数为req(加密之后的XML)、charset为xml字符编码方式.

5.
得到网银在线返回信息后,用同样的方法解析.
注:元素中的具体内容,需要根据具体的业务逻辑决定.
签约确认快捷支付含义在进行支付前,收集持卡人的签约信息,提交至网银在线快捷支付地址,网银在线根据商户提供的持卡人的签约信息,完成签约的过程,每次交易之前都要进行签约.