建行网上支付接口开发规范.docx
- 文档编号:29539395
- 上传时间:2023-07-24
- 格式:DOCX
- 页数:13
- 大小:34.93KB
建行网上支付接口开发规范.docx
《建行网上支付接口开发规范.docx》由会员分享,可在线阅读,更多相关《建行网上支付接口开发规范.docx(13页珍藏版)》请在冰豆网上搜索。
建行网上支付接口开发规范
1.网上支付使用条件ﻩ1
1.1客户进行网上支付的条件1
1.2商户在建行网银系统开户ﻩ1
2.网上支付流程ﻩ2
2.1网上支付业务流程图:
2
2.2ﻩ客户使用建行证书ﻩ3
2.3网银系统返回信息3
2.4商户的货款结算与对帐流程3
2.5ﻩ商户向客户退还货款的流程4
2.5.1当日退款ﻩ4
2.5.2ﻩ隔日退款4
3.商户→银行接口参数(个人客户)ﻩ5
4.商户→银行接口参数(企业客户)7
5.银行→商户接口参数9
附录1:
MAC算法说明ﻩ11
附录2:
数字签名算法说明13
1.网上支付使用条件
客户进行网上支付的条件
1)与建行签约的客户
Ø客户已在建设银行签约,申请网上支付服务
Ø客户签约的帐户(信用卡或储蓄卡帐户)可用于网上支付
Ø其购物的商户提供了建行支付功能
Ø网上支付的结算范围不能超过建行网上银行的辖区范围
2)未与建行签约的客户
Ø在建设银行有帐户(信用卡或储蓄卡帐户)
Ø其购物的商户提供了建行支付功能
Ø网上支付的结算范围不能超过建行网上银行的辖区范围
商户在建行网银系统开户
Ø商户与建设银行签定协议
Ø银行为其提供结算帐户与网上预申请密码
Ø在网上填写申请(需输入预申请密码才能见到开户申请表)
Ø网银中心授理并核发CA证书,建立商户信息维护表
Ø商户下载证书
Ø如果是需要实时反馈支付信息的商户,登录网银系统,申请密钥
Ø完成开户
2.网上支付流程
网上支付业务流程图:
ﻩﻩﻩﻩ
ﻩﻩﻩ
ﻩ
ﻩ
网上支付业务流程步骤说明:
1)客户登录商户网站,选择商户网站商品。
2)客户将选好的商品放入购物车,并下订单。
商户提供商户代码、订单号、合计金额等信息;
3)客户选择代理付款的银行-建行,确认后,商户代码、订单信息、合计金额通过浏览器URL传到建行网上银行站点;网上银行自动显示支付页面,客户首先选择是否使用建行证书,然后输入龙卡号和密码,选择“确定”。
支付信息经加密后传送到网银中心;
4)网银中心接收客户支付信息,转发到银行后台业务处理系统;
5)银行后台业务系统处理后,返回处理结果给网银;
6)网银通知客户支付(扣帐)是否成功。
如果扣帐成功,提示客户注意接收商户返回的送货信息;对于不需要立即响应的商户,跳过步骤7、8;
7)对于需要立即响应的商户,如果支付成功,网银将成功结果反馈给商户。
若支付失败,不返回给商户信息
8)对于需要立即响应的商户,收到银行扣帐成功的通知后,发给客户送货信息。
如客户收到银行支付(扣帐)成功通知(步骤6),但未收到商户送货信息,则需向商户查询。
日终时,商户与开设结算帐户的建设银行(网银成员行)进行流水核对,对已支付但未得到商户确认的交易进行退款处理。
客户使用建行证书
客户在商户网站选择建行支付后,被链接到建行网上银行网站。
该链接将商户名、柜台号、定单号、金额,验证信息传到网上银行系统(建行提供无密钥的MAC算法)。
客户进入建行网上银行系统时选择是否使用建行证书进行支付。
1)如果是建行签约客户,可以选择有证书支付
Ø选择使用证书支付后,输入用户号及登录密码,进入网上支付页面
Ø支付页面显示商户名、柜台号、定单号、金额等商户传来的信息(不能改动)。
客户选择付款帐户,输入交易密码,选择“确定”或“取消”
2)如果客户没有与建行签约,只能使用无证书支付
Ø选择无证书支付后,进入网上支付页面
Ø支付页面显示商户名、柜台号、定单号、金额等商户传来的信息(不能改动)。
客户输入龙卡卡号和密码,选择“确定”或“取消”。
网银系统返回信息
网银系统返回给商户成功或失败信息(按商户类型,分两种情况进行处理)
1)对于不需要实时反馈支付结果的商户,直接将支付结果通过浏览器显示给客户(业务流程步骤6)。
2)对于需要实时反馈支付结果的商户,将支付结果返回客户(业务流程步骤6),同时,如果支付成功,将结果和数字签名信息(注:
签名算法和签名内容由建行指定)反馈给商户(业务流程步骤7),签名校验成功后,进行后续处理;如果支付失败,不再通知商户。
商户的货款结算与对帐流程
1)每个商户在建行开设专用结算帐户。
客户在建行网上银行支付功能下付款,货款记入商户的专用结算帐户(含定单号信息)。
2)商户通过浏览器登录建行网上银行,可实时查询网上支付流水;对于需要实时反馈支付结果的商户,由于在交易过程中已获取了支付结果,因此也可在商户本地数据库中查到支付信息。
3)商户也可通过浏览器下载对帐文件(支付流水清单),该文件上的每笔货款已成功支付。
商户向客户退还货款的流程
退还货款是指银行支付(扣款)成功后,因客户向商户提出退货或商户无法配送商品,商户通过银行向客户退还货款。
银行退款处理流程根据商户提出退款请求的时间而定。
2.1.1当日退款
1)商户登录建行网上银行,选择网上退款功能。
2)商户输入当日的定单号(每个订单只能退款一次)
3)银行查询原始交易返回交易日期和付款金额
4)商户输入退款金额(全部或部份),交易密码,备注。
5)银行后台系统检验是否能退款,返回成功或失败信息。
2.1.2隔日退款
1)商户与当地建行联系,退款由人工完成。
3.商户→银行接口参数(个人客户)
个人客户在商户网站选择商品后,商户网站生成以下信息,传送到建行网站:
域名
名称
类型
备注
MERCHANTID
商户代码
CHAR(9)
由建行统一分配
POSID
商户柜台代码
CHAR(9)
由建行统一分配,缺省为000000000
BRANCHID
分行代码
CHAR(9)
由建行统一指定
ORDERID
定单号
CHAR(30)
由商户提供,最长30位,按实际长度给出
PAYMENT
付款金额
NUMBER(16,2)
由商户提供,按实际金额给出
CURCODE
币种
CHAR
(2)
缺省为01-人民币
REMARK1
备注1
CHAR(30)
网银不处理,直接传到城综网
REMARK2
备注2
CHAR(30)
网银不处理,直接传到城综网
TXCODE
交易码
CHAR(6)
由建行统一分配为520100
MAC
MAC校验域
CHAR(32)
采用标准MD5算法,由商户实现
注:
商户要保证定单号的唯一性。
为了加快站点间接口开发,站点间接口的参数传送采用普通的URL方式,商户将以上信息包含在FORM中,在SUBMIT后将生成URL,如下所示:
/ccbMain?
MERCHANTID=123456789&POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&TXCODE=520100&REMARK1=&REMARK2=&MAC=qwertyuioplkjhgfdsazxcvbnm901234
参与MAC运算的字符及其顺序如下:
MERCHANTID=123456789&POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&TXCODE=520100&REMARK1=&REMARK2=
注:
字符串中变量名必须是大写字母。
4.商户→银行接口参数(企业客户)
企业客户在商户网站选择商品后,商户网站生成以下信息,传送到建行网站:
域名
名称
类型
备注
MERCHANTID
商户代码(客户号)
CHAR(21)
由建行统一分配
POSID
商户柜台代码
CHAR(9)
由建行统一分配,缺省为000000000
BRANCHID
分行代码
CHAR(9)
由建行统一指定
ORDERID
定单号
CHAR(30)
由商户提供,最长30位,按实际长度给出
PAYMENT
付款金额
NUMBER(16,2)
由商户提供,按实际金额给出
CURCODE
币种
CHAR
(2)
缺省为01-人民币
REMARK1
备注1
CHAR(30)
网银不处理,直接传到城综网
REMARK2
备注2
CHAR(30)
网银不处理,直接传到城综网
TXCODE
交易码
CHAR(6)
由建行统一分配为690401
MAC
MAC校验域
CHAR(32)
采用标准MD5算法,由商户实现
注:
商户要保证定单号的唯一性。
站点间接口的参数传送采用表单的post方式提交,商户将以上信息包含在FORM中。
例如,
?
MERCHANTID=123456789&POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&TXCODE=690401&REMARK1=&REMARK2=&MAC=sds6dd8gddddwdsdddfuj
(测试为 )
参与MAC运算的字符及其顺序如下:
MERCHANTID=123456789&POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&TXCODE=690401&REMARK1=&REMARK2=
注:
字符串中变量名必须是大写字母。
5.银行→商户接口参数
建行网站生成以下信息,传送到商户网站:
域名
名称
类型
备注
POSID
商户柜台代码
CHAR(9)
从商户传送的信息中获得
BRANCHID
分行代码
CHAR(9)
从商户传送的信息中获得
ORDERID
定单号
CHAR(30)
从商户传送的信息中获得
PAYMENT
付款金额
NUMBER(16,2)
从商户传送的信息中获得
CURCODE
币种
CHAR
(2)
从商户传送的信息中获得
REMARK1
备注一
CHAR(30)
从商户传送的信息中获得
REMARK2
备注二
CHAR(30)
从商户传送的信息中获得
SUCCESS
成功标志
CHAR
(1)
成功时返回Y
SIGN
数字签名
CHAR(256)
站点间接口的参数传送仍然采用普通的URL方式,信息包含在CGI参数,具体如下所示:
=19991101&REMARK2=merchantname&SUCCESS=Y&SIGN=4b3ef029516193b7d969ac1840083635a3e0901b8cd526caa44c1a072f496d7f0d4bca3942c0d9030bede37c7809b835cec787eb39e18b7596a724fba9805b24714dfbb0f4a3fb430b32e075254a114d4c38a0ac52ef46a0ad33dec3fbfc15417402a1399e65e46996c0cf49fc7ffca9222f8cd693c8376b6f928828967bec42
注:
?
前的URL由商户在签约时提供
参与签名运算的字符及其顺序如下
POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&REMARK1=19991101&REMARK2=merchantname&SUCCESS=Y
注:
字符串中变量名必须是大写字母。
如果商户的程序将MERCHANTID,POSID,BRANCHID,ORDERID, PAYMENT,CURCODE,TXCODE和MAC作为隐藏域(hidden),然后使用SUBMIT按纽,注意在FORM的METHOD中使用“GET”的方式。
附录1:
MAC算法说明
建设银行网上银行项目组决定对商户向网上银行系统提交的交易内容进行MAC校验,校验算法采用标准MD5算法,不带密钥。
该算法的详细说明请参见RFC1321文档。
我们假设商户实行标准的MD5算法对向网上银行系统提交的交易内容进行MAC校验,产生128位(bit)的MAC结果。
输入为字符串,输出为16进制字符表示的字符串。
下面是对MAC结果的显示方式的描述:
1、对128位的交易结果按4位为一个单位进行划分,共获得32段
2、将每段看成一个16进制数,如0011为0X3,1101为0Xd。
3、将这个数映射到ASCII码表,形成相应的字符,如0X2为“2”,0Xd为“d”。
4、将这些字符连成一个字符串,长度为32。
下面是使用JAVA语言对表现方法的描述:
public static Stringbintoascii(byte[]bySourceByte)
ﻩﻩ{
ﻩintlen,i;
ﻩbytetb;
ﻩﻩcharhigh,tmp,low;
ﻩﻩﻩStringresult=newString();
len=bySourceByte.length;
ﻩﻩﻩfor(i=0;i<len;i++)
ﻩﻩﻩ{
ﻩﻩﻩtb=bySourceByte[i];
ﻩﻩﻩ
ﻩﻩtmp=(char)((tb>>>4)&0x000f);
ﻩﻩﻩﻩif(tmp>=10)
high=(char)('a'+tmp-10);
ﻩﻩﻩﻩelse
ﻩﻩﻩhigh=(char)('0'+tmp);
ﻩﻩﻩresult+=high;
ﻩﻩtmp=(char)(tb&0x000f);
ﻩﻩif(tmp>=10)
ﻩlow=(char)('a'+tmp-10);
ﻩﻩelse
ﻩﻩﻩlow=(char)('0'+tmp);
ﻩﻩﻩﻩ
ﻩresult+=low;
ﻩﻩ}
ﻩﻩreturnresult;
ﻩﻩ}
下面是一些字符串进行MAC并按上述方法进行转换后获得的结果:
ØMD5("")= d41d8cd98f00b204e9800998ecf8427e
ØMD5("a") =0cc175b9c0f1b6a831c399e269772661
ØMD5 ("abc")=900150983cd24fb0d6963f7d28e17f72
ØMD5("messagedigest")=ﻩf96b697d7cb7938d525a2f31aaf161d0
ØMD5("abcdefghijklmnopqrstuvwxyz")=ﻩc3fcd3d76192e4007dfb496cca67e13b
ØMD5("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789")= d174ab98d277d9f5a5611c2c9f419d9f
ØMD5("123456789123456789123456789123456789")=ﻩ57edf4a22be3c955ac49da2e2107b67a
在实施时若遇到具体问题,可由双方协商解决。
附录2:
数字签名算法说明
银行将客户支付信息实时通知给商户时,使用的数字签名算法是MD5withRSA算法。
商户验证签名的公钥在商户在网银系统开户,获取数字证书后,登录到网银系统中,通过下载公钥交易获取。
商户获取的公钥用X.509格式表示,并且将其按照每4位(bit)转换为一个16进制数的方式表示,产生16进制的字符串。
网上银行使用标准MD5withRSA算法对给商户的响应进行签名,产生1024位(bit)的签名结果,并且将其按照每4位(bit)转换为一个16进制数的方式表示,形成16进制的字符串,长度为256。
下面是对签名结果的表示方式的描述:
1、对1024位的交易结果按4位为一个单位进行划分,共获得256段
2、将每段看成一个16进制数,如0011为0X3,1101为0Xd。
3、将这个数映射到ASCII码表,形成相应的字符,如0X2为“2”,0Xd为“d”。
4、将这些字符连成一个字符串,长度为256。
例如:
待签名的字符串为:
POSID=000000000&BRANCHID=110000000&ORDERID=19991101234&PAYMENT=500.00&CURCODE=01&REMARK1=19991101&REMARK2=merchantname&SUCCESS=Y
签名结果为:
4b3ef029516193b7d969ac1840083635a3e0901b8cd526caa44c1a072f496d7f0d4bca3942c0d9030bede37c7809b835cec787eb39e18b7596a724fba9805b24714dfbb0f4a3fb430b32e075254a114d4c38a0ac52ef46a0ad33dec3fbfc15417402a1399e65e46996c0cf49fc7ffca9222f8cd693c8376b6f928828967bec42
当商户收到银行传来的CGI串后,从中获取签名(格式如上)和需签名的原文。
商户端程序(商户自行开发MD5withRSA签名校验程序)将签名和商户端的公钥转换成二进制格式,与签名的原文一起对签名的正确性进行校验,校验步骤如下:
1)使用公钥进行签名的逆运算
2)使用标准MD5算法运算原文
3)比较1)、2)结果。
ﻩﻩﻩﻩﻩﻩ
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 建行 网上支付 接口 开发 规范
![提示](https://static.bdocx.com/images/bang_tan.gif)