电子商务网上支付接口文档deqq.docx

《电子商务网上支付接口文档deqq.docx》由会员分享，可在线阅读，更多相关《电子商务网上支付接口文档deqq.docx（18页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、网 上 支 付 接 口（1.0期）商户接口说明版本1.05北京珠峰伟业软件科技发展有限公司2002年 10月18日文档修改记录版本日期说明编写者审核者1.00修改1.0期文档1.012002-10-10增加接收返回结果1.022002-10-18增加客户接收密码1.032002-10-30错误代码1.042002-11-05解决部分商户不支持中文Mac加密算法问题1.052002-12-03增加支持英文平台1.062002-12-13测试账号说明1.072002-12-26增加vbscript的md5加密算法1.072002-01-06增加php程序的例子说明本文档中所包含的信息属于机密信息，

2、如无书面许可，任何人都无权复制或利用。Copy right 2002 by (Beijing) Co., Ltd.在例子中的所有的店铺号和密码均为测试账号。只用于商户进行测试，商户在自己程序正式上线前，请使用自己的店铺号及支付密码。如果因为使用测试账号所引起的商务纠纷6688网站概不负责。目录1.网上支付使用条件11.1客户进行网上支付的条件12.网上支付流程22.1网上支付业务流程图：22.2商户的货款结算与对帐流程33.客户网关接口参数（中文）44.MAC算法说明(对于商户端支持MD5组件注册方式，请看以下说明):65.具体用法见附件：76.MAC算法说明(对于商户端不支持MD5组件注册方

3、式，请看以下说明):87.MAC算法原理:108.支付网关商户接口参数129.英文支付网关131. 网上支付使用条件1.1 客户进行网上支付的条件1) 与6688签约的客户 客户已在6688签约，申请网上支付服务 客户签约的帐户（信用卡或储蓄卡帐户）可用于网上支付2. 网上支付流程2.1 网上支付业务流程图：865银行后台网关guan关商户 72 943 1客户 网上支付业务流程步骤说明：1) 客户登录商户网站，选择商品2) 商户网站通过6688资格验证，查询商户方支持的网上支付方式3) 商户网站给客户提供可选择的银行支付方式，由客户自行选择4) 客户选择商品及要进行支付的银行后，产生预定单信

4、息5) 信息经过加密传到支付网关平台。商户提供商户代码、订单号、合计金额及订单备注等信息，此四个信息必须提供；除此之外,商户方还必须将商户代码、订单号、合计金额及订单备注四个信息利用MAC组件进行加密产生MD5校验码，最好以post方法传递到支付网关平台用以保证定单信息的正确性.其中，订单备注信息可为各种其他订单信息拼成的一个字串，例如：订货人id,收货人地址等，商家网站将此信息传递给6688网站,6688网站将保存这些订单信息,以便于今后的信息核对。6) 支付网关平台接收客户支付信息，转发到银行后台业务处理系统；7) 银行后台会将支付成功与否的信息传送给支付网关平台8) 支付网关平台会根据商

5、户提交过来的URL调用商户接收支付结果的页面9) 商户将用户的支付结果显示给用户2.2 商户的货款结算与对帐流程1) 客户在商户网站选择商品并下单，通过6688支付网关付款给银行后,商户记录相关客户信息。货款记入6688在银行的专用结算帐户（含定单号信 息）中，由6688与商户按合同约定进行款项结算。2) 6688负责到银行处查询该客户该笔订单付款信息，如果付款完成，由6688通知商户进行配货，网上交易完成。商户通过6688提供的订单查询系统查询本商户的订单详细处理情况，并及时处理，并发货。3. 客户网关接口参数（中文）客户在商户网站选择商品后，商户网站生成以下信息，传送到网站：域名名称类型、

6、长度备注tmbrid商家在6688的会员号CHAR(8)由6688提供,必填项目toname定货人姓名CHAR(50)客户方订购人员姓名, 可为空tsummoney订单总额NUMBER(8,2)总金额, 由商户提供，按实际金额给出，必填项目tContent1定单内容CHAR(500)商家可以将支付的订单商品信息拼成一个字串,传到6688网关,便于今后的信息核对和查询,必填项目trphone收货人电话CHAR(20)可为空trzipcode收货人邮政编码CHAR(20)可为空trname收货人姓名CHAR（50）可为空traddress收货人地址CHAR(16)可为空tremail收货人emai

7、lCHAR(32)可为空tuserurl接收支付结果的url CHAR(32)可为空todrid订单号CHAR(6)商家网站方形成的订单号,传递给6688网站,以便于今后的订单查询和核对,必填项目tSupperComRegflag商户端是否能够支持Md5加密组件注册标志int商户网站是否能够注册Md5加密组件，解决一些商户由于是租用ISP的服务器空间，不能够注册组件的一个参数。默认为空或者0，表示商户支持MD5组件注册，否则为1，表示不支持必填项目MacMAC校验域CHAR(32)必填项目采用标准MD5算法，由商户实现,具体算法如下： 注：1备注栏目中有必填项目字样的是商家必须提供的。 2商户

8、要保证定单号的唯一性。站点间接口的参数传送采用post方式，商户将以上信息包含在FORM中，在SUBMIT后将生成URL，如下所示：form method=post name=frm_odrinfo action= tuserurl参数是6688网站提供给商家银行支付结果信息的地址，商户在取得支付结果后希望用户进入商户网站的某个页面的URL，商户的接收程序可以根据支付是否成功而指定不同的URL，或者带不同的参数，商户可以根据参数的不同决定显示什么信息，如果成功支付的情况，还可以根据参数的不同决定向用户提供什么服务。支付网关将传回4个参数：billNo、amount、succ、mac。参数的具体

9、意义详见5。支付网关商户接口参数。4. MAC算法说明(对于商户端支持MD5组件注册方式，请看以下说明):参与MAC运算的字符及其顺序如下：mac=dd.string(tmbrid=+cstr(tmbrid)+&tsummoney=+cstr(tsummoney)+&tcontent1=+cstr(tcontent1)+&todrid=+cstr(todrid)+ &tpwd=+ tpwd)商户在使用支付网关的时候，除了4个必须提供的商品信息外以及一个支付密码外，还必须传过一个校验码，网关使用商户传递过来的校验码与网关自身产生的一个校验码进行比较来判断商户的合法身份。注：校验码产生时，四个产品

10、信息和一个支付密码，必须按照如上提供的顺序；MAC校验码产生示例1 使用MD5组件以产生校验码，组件由提供 (见附件yuan.dll)，yuan.dll主要在windows平台使用， 在其它平台使用方法见md5子目录，注册方法：在dos模式下键入：Regsvr32 盘符:yuan.dll便可完成注册过程。2 使用MD5组件的string方法产生mac校验码，即对tmbrid，tsummoney，tcontent1，todrid，tpwd五个表单域信息进行加密tmbrid 商户在6688网站的商户会员ID，由6688网站提供tsummoney 订单总金额tcontent1 定单信息字串:各种其他

11、定单信息拼成的字串，例如：收货人，商品名称，商品个数,订货时间等。todrid 订单在商户方的订单号tpwd 由6688网站提供，如果为我们的支付网关的店铺，我们会在开店之后，发一封email，在email中，我们会告诵您的支付密码，该密码为此项的值。3. MAC具体使用代码Set dd = Server.CreateObject(yuan.md5)response.write dd.string(tmbrid=+cstr(tmbrid)+&tsummoney=+cstr(tsummoney)+&tcontent1=+cstr(tcontent1)+&todrid=+cstr(todrid)+

12、 &tpwd=+ tpwd) set dd=nothing5. 具体用法见附件：infopage.aspSend.asp6. MAC算法说明(对于商户端不支持MD5组件注册方式，请看以下说明):提示：对于不支持MD5组件注册商户，建议商户使用客户端的MD5加密方式。我们目前支持vbscript 和Jscript两种方式。61 Jscript语言：1.参与MAC运算的字符及其顺序如下，以下参数不支持中文：tmbrid=10000111 /商家在6688的商家号todrid=1 /商家定单号 tsummoney= 80.5 /订单总金额 tpwd = ABCDDDD-FEXD-2DC3-A3R3-

13、23CSEDGHDSDE /支付密码，由6688网站提供，包含在商户网站的程序代码中strtmp=tmbrid=+tmbrid+&tsummoney=1+&todrid=+todrid+&tpwd=+tpwd macstr=calcMD5(strtmp)2.商户在使用支付网关的时候，除了三个必须提供的商品信息外以及一个支付密码外，还必须传过一个校验码，网关使用商户传递过来的校验码与网关自身产生的一个校验码进行比较来判断商户的合法身份。注：校验码产生时，三个产品信息和一个支付密码，必须按照如上提供的顺序；MAC校验码产生示例3 使用MD5组件的string方法产生mac校验码，即对tmbrid，

14、tsummoney，todrid，tpwd四个表单域信息进行加密tmbrid 商户在6688网站的商户会员ID，由6688网站提供tsummoney 订单总金额todrid 订单在商户方的订单号tpwd 由6688网站提供，如果为我们的支付网关的店铺，我们会在开店之后，发一封email，在email中，我们会告诵您的支付密码，该密码为此项的值。4. MAC具体使用代码tmbrid=10000111 /商家在6688的商家号todrid=1 /商家定单号 tsummoney= 80.5 /订单总金额 tpwd = ABCDDDD-FEXD-2DC3-A3R3-23CSEDGHDSDE /支付密码

15、，由6688网站提供，包含在商户网站的程序代码中strtmp=tmbrid=+tmbrid+&tsummoney=1+&todrid=+todrid+&tpwd=+tpwd macstr=calcMD5(strtmp)5.具体用法见附件：p.asp62 vbscript语言：1.参与MAC运算的字符及其顺序如下，以下参数不支持中文：tmbrid=10000111 商家在6688的商家号todrid=1 商家定单号 tsummoney= 80.5 订单总金额 tpwd = ABCDDDD-FEXD-2DC3-A3R3-23CSEDGHDSDE 支付密码，由6688网站提供，包含在商户网站的程序代

16、码中strtmp=tmbrid=+tmbrid+&tsummoney=+cstr(tsummoney)+&todrid=+todrid+&tpwd=+tpwd macstr=calcMD5(strtmp)2.商户在使用支付网关的时候，除了三个必须提供的商品信息外以及一个支付密码外，还必须传过一个校验码，网关使用商户传递过来的校验码与网关自身产生的一个校验码进行比较来判断商户的合法身份。注：校验码产生时，三个产品信息和一个支付密码，必须按照如上提供的顺序；MAC校验码产生示例3.使用MD5组件的string方法产生mac校验码，即对tmbrid，tsummoney，todrid，tpwd四个表单

17、域信息进行加密tmbrid 商户在6688网站的商户会员ID，由6688网站提供tsummoney 订单总金额todrid 订单在商户方的订单号tpwd 由6688网站提供，如果为我们的支付网关的店铺，我们会在开店之后，发一封email，在email中，我们会告诵您的支付密码，该密码为此项的值。4. MAC具体使用代码tmbrid=10000111 商家在6688的商家号todrid=1 商家定单号 tsummoney= 80.5 订单总金额 tpwd = ABCDDDD-FEXD-2DC3-A3R3-23CSEDGHDSDE /支付密码，由6688网站提供，包含在商户网站的程序代码中strt

18、mp=tmbrid=+tmbrid+&tsummoney=+cstr(tsummoney)+&todrid=+todrid+&tpwd=+tpwd macstr=calcMD5(strtmp)5.具体用法见附件：pvb.asp7. MAC算法原理:我们假设商户实行标准的MD5算法对向网上银行系统提交的交易内容进行MAC校验，产生128位（bit）的MAC结果。输入为字符串，输出为16进制字符表示的字符串。下面是对MAC结果的显示方式的描述：1、 对128位的交易结果按4位为一个单位进行划分，共获得32段2、 将每段看成一个16进制数，如0011为0X3，1101为0Xd。3、 将这个数映射到A

19、SCII码表，形成相应的字符，如0X2为“2”，0Xd为“d”。4、 将这些字符连成一个字符串，长度为32。下面是使用JAVA语言对表现方法的描述：public static String bintoascii(byte bySourceByte)int len,i;byte tb;char high,tmp,low;String result=new String();len=bySourceByte.length;for(i=0;i4)&0x000f);if(tmp=10)high=(char)(a+tmp-10);elsehigh=(char)(0+tmp);result+=high;t

20、mp=(char)(tb&0x000f);if(tmp=10)low=(char)(a+tmp-10);elselow=(char)(0+tmp);result+=low;return result; 在实施时若遇到具体问题，可由双方协商解决。4.附件frame.html是6688网站成功接收商家信息后供用户选择支付方式的界面。5.其中md5子目录是关于MAC加密算法的不同语言版本,商家可根据自己的平台加入选择不同的算法.Md5java md5 for java语言 的源程序算法md5cpp md5 for C+ 语言 的源程序算法md5c md5 for C 语言 的源程序算法Md5js m

21、d5 for javascript语言 的源程序算法和相关用法附件，包含md5.inc、和md5.js，建议不能安装组件的商户使用Md5perl md5 for perl语言 的源程序算法6错误代码：1）7003：两边的加密密码不匹配。校验失败2) 如果有其它错误，系统会及时提示8. 支付网关商户接口参数在支付结束后，支付网关将支付是否成功与否的结果按商户传来的URL将支付结果返回：域名名称类型、长度备注billNo订单号CHAR(6)商家网站方形成的订单号amount订单总额NUMBER(8,2)订单金额succ支付结果CHAR(1)“Y”:支付成功“N”:支付失败MacMAC校验域CHAR

22、(32)采用标准MD5算法，具体算法如下说明 注：1. mac=dd.string(billNo=+ billNovalue+&amount=+ amountvalue+&succ=+ succvalue +&pwd=+ pwdvalue)2. 如果商户-支付网关的时候就没有传参数：tuserurl，支付网关就不会将支付结果传给商户。3. pwdvalue：如果为我们的支付网关的店铺，我们会在开店之后，发一封email，在email中，我们会告诵您的支付密码，该密码为此项的值。发送和接受的详细例子程序，详见：INFOPAGE.ASP（用户的订单信息）SEND.ASP（将用户的订单信息发送给支付

23、网关的例子程序，对于商户端支持MD5组件注册的方式）P.ASP（将用户的订单信息发送给支付网关的例子程序，对于商户端不支持MD5组件注册的方式-JSCRIPT）PVB.ASP（将用户的订单信息发送给支付网关的例子程序，对于商户端不支持MD5组件注册的方式-VBSCRIPT）GETRESULT.ASP（从支付网关接收支付结果的例子程序）PPHP.PHP（PHP程序连接支付网关的例子）流程例子： HTTP:/WWW.6688.COM/PAYGATESAMPLE/INFOPAGE.ASP流程例子： HTTP:/WWW.6688.COM/PAYGATESAMPLE/P.ASP流程例子： HTTP:/WWW.6688.COM/PAYGATESAMPLE/PVB.ASP9. 英文支付网关对于需要使用英文支付网关的客户，我们提供了相应的接口。我们是在中文支付网关的基础上进行了相应的修改。传入的参数均和中文一样（详见3-8）。只是对form提交的页面进行了修改:将提交页面由例子详见：INFOPAGEE.ASP（用户的订单信息）SENDE.ASP（将用户的订单信息发送给支付网关的例子程序，对于商户端支持MD5组件注册的方式）流程例子： HTTP:/WWW.6688.COM/PAYGATESAMPLE/INFOPAGEE.ASP