《建行网上支付接口开发规范标准》由会员分享，可在线阅读，更多相关《建行网上支付接口开发规范标准（12页珍藏版）》请在金锄头文库上搜索。
1、目录1.网上支付使用条件11.1客户进行网上支付的条件11.2商户在建行网银系统开户12.网上支付流程22.1网上支付业务流程图：22.2客户使用建行证书32.3网银系统返回信息32.4商户的货款结算与对帐流程32.5商户向客户退还货款的流程42.5.1当日退款42.5.2隔日退款43.商户银行接口参数（个人客户）54.商户银行接口参数（企业客户）75.银行商户接口参数9附录1：MAC算法说明11附录2：数字签名算法说明131. 网上支付使用条件1.1 客户进行网上支付的条件1) 与建行签约的客户 客户已在建设银行签约，申请网上支付服务 客户签约的（信用卡或储蓄卡）可用于网上支付 其购物的商户
2、提供了建行支付功能 网上支付的结算围不能超过建行网上银行的辖区围2) 未与建行签约的客户 在建设银行有（信用卡或储蓄卡） 其购物的商户提供了建行支付功能 网上支付的结算围不能超过建行网上银行的辖区围1.2 商户在建行网银系统开户 商户与建设银行签定协议 银行为其提供结算与网上预申请密码 在网上填写申请（需输入预申请密码才能见到开户申请表） 网银中心授理并核发CA证书，建立商户信息维护表 商户下载证书 如果是需要实时反馈支付信息的商户，登录网银系统，申请密钥 完成开户2. 网上支付流程2.1 网上支付业务流程图：银行后台网银商户 781 2客户 3546网上支付业务流程步骤说明：1) 客户登录商
3、户，选择商户商品。2) 客户将选好的商品放入购物车，并下订单。商户提供商户代码、订单号、合计金额等信息；3) 客户选择代理付款的银行建行，确认后，商户代码、订单信息、合计金额通过浏览器URL传到建行网上银行站点；网上银行自动显示支付页面，客户首先选择是否使用建行证书，然后输入龙卡号和密码，选择“确定”。支付信息经加密后传送到网银中心；4) 网银中心接收客户支付信息，转发到银行后台业务处理系统；5) 银行后台业务系统处理后，返回处理结果给网银；6) 网银通知客户支付（扣帐）是否成功。如果扣帐成功，提示客户注意接收商户返回的送货信息；对于不需要立即响应的商户，跳过步骤7、8；7) 对于需要立即响应
4、的商户，如果支付成功，网银将成功结果反馈给商户。若支付失败，不返回给商户信息8) 对于需要立即响应的商户，收到银行扣帐成功的通知后，发给客户送货信息。如客户收到银行支付（扣帐）成功通知（步骤6），但未收到商户送货信息，则需向商户查询。日终时，商户与开设结算的建设银行（网银成员行）进行流水核对，对已支付但未得到商户确认的交易进行退款处理。2.2 客户使用建行证书客户在商户选择建行支付后，被到建行网上银行。该将商户名、柜台号、定单号、金额，验证信息传到网上银行系统（建行提供无密钥的MAC算法)。客户进入建行网上银行系统时选择是否使用建行证书进行支付。1) 如果是建行签约客户，可以选择有证书支付 选
5、择使用证书支付后，输入用户号及登录密码，进入网上支付页面 支付页面显示商户名、柜台号、定单号、金额等商户传来的信息（不能改动）。客户选择付款，输入交易密码，选择“确定”或“取消”2) 如果客户没有与建行签约，只能使用无证书支付 选择无证书支付后，进入网上支付页面 支付页面显示商户名、柜台号、定单号、金额等商户传来的信息（不能改动）。客户输入龙卡卡号和密码，选择“确定”或“取消”。2.3 网银系统返回信息网银系统返回给商户成功或失败信息（按商户类型，分两种情况进行处理）1) 对于不需要实时反馈支付结果的商户，直接将支付结果通过浏览器显示给客户（业务流程步骤6）。2) 对于需要实时反馈支付结果的商
6、户，将支付结果返回客户（业务流程步骤6），同时，如果支付成功，将结果和数字签名信息（注：签名算法和签名容由建行指定）反馈给商户（业务流程步骤7），签名校验成功后，进行后续处理；如果支付失败，不再通知商户。2.4 商户的货款结算与对帐流程1) 每个商户在建行开设专用结算。客户在建行网上银行支付功能下付款，货款记入商户的专用结算（含定单号信 息）。2) 商户通过浏览器登录建行网上银行，可实时查询网上支付流水；对于需要实时反馈支付结果的商户，由于在交易过程中已获取了支付结果，因此也可在商户本地数据库中查到支付信息。3) 商户也可通过浏览器下载对帐文件（支付流水清单），该文件上的每笔货款已成功支付。2
7、.5 商户向客户退还货款的流程退还货款是指银行支付（扣款）成功后，因客户向商户提出退货或商户无法配送商品，商户通过银行向客户退还货款。银行退款处理流程根据商户提出退款请求的时间而定。2.5.1 当日退款1) 商户登录建行网上银行，选择网上退款功能。2) 商户输入当日的定单号（每个订单只能退款一次）3) 银行查询原始交易返回交易日期和付款金额4) 商户输入退款金额（全部或部份），交易密码，备注。5) 银行后台系统检验是否能退款，返回成功或失败信息。2.5.2 隔日退款1) 商户与当地建行联系，退款由人工完成。3. 商户银行接口参数（个人客户）个人客户在商户选择商品后，商户生成以下信息，传送到建行
8、：域名名称类型备注MERCHANTID商户代码CHAR(9)由建行统一分配POSID商户柜台代码CHAR(9)由建行统一分配，缺省为000000000BRANCHID分行代码CHAR(9)由建行统一指定ORDERID定单号CHAR(30)由商户提供，最长30位,按实际长度给出PAYMENT付款金额NUMBER(16,2)由商户提供，按实际金额给出CURCODE币种CHAR(2)缺省为01人民币REMARK1备注1CHAR(30)网银不处理，直接传到城综网REMARK2备注2CHAR(30)网银不处理，直接传到城综网TXCODE交易码CHAR(6)由建行统一分配为520100MACMAC校验域C
9、HAR(32)采用标准MD5算法，由商户实现注：商户要保证定单号的唯一性。为了加快站点间接口开发，站点间接口的参数传送采用普通的URL方式，商户将以上信息包含在FORM中，在SUBMIT后将生成URL，如下所示：https:/ 商户银行接口参数（企业客户）企业客户在商户选择商品后，商户生成以下信息，传送到建行：域名名称类型备注MERCHANTID商户代码(客户号)CHAR(21)由建行统一分配POSID商户柜台代码CHAR(9)由建行统一分配，缺省为000000000BRANCHID分行代码CHAR(9)由建行统一指定ORDERID定单号CHAR(30)由商户提供，最长30位,按实际长度给出P
10、AYMENT付款金额NUMBER(16,2)由商户提供，按实际金额给出CURCODE币种CHAR(2)缺省为01人民币REMARK1备注1CHAR(30)网银不处理，直接传到城综网REMARK2备注2CHAR(30)网银不处理，直接传到城综网TXCODE交易码CHAR(6)由建行统一分配为690401MACMAC校验域CHAR(32)采用标准MD5算法，由商户实现注：商户要保证定单号的唯一性。站点间接口的参数传送采用表单的post方式提交，商户将以上信息包含在FORM中。例如，https:/ MERCHANTID=123456789&POSID=000000000&BRANCHID=11000
11、0000&ORDERID=&PAYMENT=500.00&CURCODE=01&TXCODE=690401&REMARK1=&REMARK2=&MAC=sds6dd8gddddwdsdddfuj(测试 为https:/202.106.69.56/app/ccbMain )参与MAC运算的字符及其顺序如下：MERCHANTID=123456789&POSID=000000000&BRANCHID=110000000&ORDERID=&PAYMENT=500.00&CURCODE=01&TXCODE=690401&REMARK1=&REMARK2=注：字符串中变量名必须是大写字母。5. 银行商户接
12、口参数建行生成以下信息，传送到商户：域名名称类型备注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)成功时返回YSIGN数字签名CHAR(256)站点间接口的参数传送仍然采用普通的URL方式，信息包
13、含在CGI参数，具体如下所示：HTTP:/MERCHANT.WEB.SITE/MERCHANT_CGI?POSID=000000000&BRANCHID=110000000&ORDERID=&PAYMENT=500.00&CURCODE=01&REMARK119991101&REMARK2=merchantname&SUCCESS=Y&SIGN=4b3ef029516193b7d969ac1840083635a3e0901b8cd526caa44c1a072f496d7f0d4bca3942c0d9030bede37c7809b835cec787eb39e18b7596a724fba9805b24714dfbb0f4a3fb430b32e075254a114d4c38a0ac52ef46a0ad33dec3fbfc15417402a1399e65e46996c0cf49fc7ffca9222f
