商户接口说明商户接口规范.doc第i页打印日期:08/14/19目录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:数字签名算法说明..........................................................................................................13商户接口说明商户接口规范.doc第1页打印日期:08/14/1911..网网上上支支付付使使用用条条件件1.1客户进行网上支付的条件1)与建行签约的客户客户已在建设银行签约,申请网上支付服务客户签约的帐户(信用卡或储蓄卡帐户)可用于网上支付其购物的商户提供了建行支付功能网上支付的结算范围不能超过建行网上银行的辖区范围2)未与建行签约的客户在建设银行有帐户(信用卡或储蓄卡帐户)其购物的商户提供了建行支付功能网上支付的结算范围不能超过建行网上银行的辖区范围1.2商户在建行网银系统开户商户与建设银行签定协议银行为其提供结算帐户与网上预申请密码在网上填写申请(需输入预申请密码才能见到开户申请表)网银中心授理并核发CA证书,建立商户信息维护表商户下载证书如果是需要实时反馈支付信息的商户,登录网银系统,申请密钥完成开户商户接口说明商户接口规范.doc第2页打印日期:08/14/1922..网网上上支支付付流流程程2.1网上支付业务流程图:网上支付业务流程步骤说明:1)客户登录商户网站,选择商户网站商品。2)客户将选好的商品放入购物车,并下订单。商户提供商户代码、订单号、合计金额等信息;3)客户选择代理付款的银行-建行,确认后,商户代码、订单信息、合计金额通过浏览器URL传到建行网上银行站点;网上银行自动显示支付页面,客户首先选择是否使用建行证书,然后输入龙卡号和密码,选择“确定”。支付信息经加密后传送到网银中心;4)网银中心接收客户支付信息,转发到银行后台业务处理系统;5)银行后台业务系统处理后,返回处理结果给网银;6)网银通知客户支付(扣帐)是否成功。如果扣帐成功,提示客户注意接收商户返回的送货信息;对于不需要立即响应的商户,跳过步骤7、8;7)对于需要立即响应的商户,如果支付成功,网银将成功结果反馈给商户。若支付失败,不返回给商户信息8)对于需要立即响应的商户,收到银行扣帐成功的通知后,发给客户送货信息。商户网银客户银行后台13245678商户接口说明商户接口规范.doc第3页打印日期:08/14/19如客户收到银行支付(扣帐)成功通知(步骤6),但未收到商户送货信息,则需向商户查询。日终时,商户与开设结算帐户的建设银行(网银成员行)进行流水核对,对已支付但未得到商户确认的交易进行退款处理。2.2客户使用建行证书客户在商户网站选择建行支付后,被链接到建行网上银行网站。该链接将商户名、柜台号、定单号、金额,验证信息传到网上银行系统(建行提供无密钥的MAC算法)。客户进入建行网上银行系统时选择是否使用建行证书进行支付。1)如果是建行签约客户,可以选择有证书支付选择使用证书支付后,输入用户号及登录密码,进入网上支付页面支付页面显示商户名、柜台号、定单号、金额等商户传来的信息(不能改动)。客户选择付款帐户,输入交易密码,选择“确定”或“取消”2)如果客户没有与建行签约,只能使用无证书支付选择无证书支付后,进入网上支付页面支付页面显示商户名、柜台号、定单号、金额等商户传来的信息(不能改动)。客户输入龙卡卡号和密码,选择“确定”或“取消”。2.3网银系统返回信息网银系统返回给商户成功或失败信息(按商户类型,分两种情况进行处理)1)对于不需要实时反馈支付结果的商户,直接将支付结果通过浏览器显示给客户(业务流程步骤6)。2)对于需要实时反馈支付结果的商户,将支付结果返回客户(业务流程步骤6),同时,如果支付成功,将结果和数字签名信息(注:签名算法和签名内容由建行指定)反馈给商户(业务流程步骤7),签名校验成功后,进行后续处理;如果支付失败,不再通知商户。2.4商户的货款结算与对帐流程1)每个商户在建行开设专用结算帐户。客户在建行网上银行支付功能下付款,商户接口说明商户接口规范.doc第4页打印日期:08/14/19货款记入商户的专用结算帐户(含定单号信息)。2)商户通过浏览器登录建行网上银行,可实时查询网上支付流水;对于需要实时反馈支付结果的商户,由于在交易过程中已获取了支付结果,因此也可在商户本地数据库中查到支付信息。3)商户也可通过浏览器下载对帐文件(支付流水清单),该文件上的每笔货款已成功支付。2.5商户向客户退还货款的流程退还货款是指银行支付(扣款)成功后,因客户向商户提出退货或商户无法配送商品,商户通过银行向客户退还货款。银行退款处理流程根据商户提出退款请求的时间而定。2.5.1当日退款1)商户登录建行网上银行,选择网上退款功能。2)商户输入当日的定单号(每个订单只能退款一次)3)银行查询原始交易返回交易日期和付款金额4)商户输入退款金额(全部或部份),交易密码,备注。5)银行后台系统检验是否能退款,返回成功或失败信息。2.5.2隔日退款1)商户与当地建行联系,退款由人工完成。商户接口说明商户接口规范.doc第5页打印日期:08/14/1933..商商户户银银行行接接口口参参数数((个个人人客客户户))个人客户在商户网站选择商品后,商户网站生成以下信息,传送到建行网站:域名名称类型备注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校验域CHAR(32)采用标准MD5算法,由商户实现注:商户要保证定单号的唯一性。为了加快站点间接口开发,站点间接口的参数传送采用普通的URL方式,商户将以上信息包含在FORM中,在SUBMIT后将生成URL,如下所示:=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=商户接口说明商户接口规范.doc第6页打印日期:08/14/19注:字符串中变量名必须是大写字母。商户接口说明商户接口规范.doc第7页打印日期:08/14/1944..商商户户银银行行接接口口参参数数((企企业业客客户户))企业客户在商户网站选择商品后,商户网站生成以下信息,传送到建行网站:域名名称类型备注MERCHANTID商户代码(客户号)CHAR(21)由建行统一分配POSID商户柜台代码CHAR(9)由建行统一分配,缺省为000000000BRANCHID分行代码C