建行网上支付接口开发规范

商户接口说明商户接口规范.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