网上支付的基本流程模板.doc

网 上 支 付 接 口（1.0期）商户接口说明版本1.05北京珠峰伟业软件科技发展 10月18日文档修改统计版本日期说明编写者审核者1.00修改1.0期文档1.01-10-10增加接收返回结果1.02-10-18增加用户接收密码1.03-10-30错误代码1.04-11-05处理部分商户不支持汉字Mac加密算法问题1.05-12-03增加支持英文平台1.06-12-13测试账号说明1.07-12-26增加vbscriptmd5加密算法1.07-01-06增加php程序例子说明本文档中所包含信息属于机密信息，如无书面许可，任何人全部无权复制或利用。Copy right by (Beijing) Co., Ltd.在例子中全部店铺号和密码均为测试账号。只用于商户进行测试，商户在自己程序正式上线前，请使用自己店铺号及支付密码。假如因为使用测试账号所引发商务纠纷6688网站概不负责。目录1.网上支付使用条件11.1用户进行网上支付条件12.网上支付步骤22.1网上支付业务步骤图：22.2商户货款结算和对帐步骤33.用户网关接口参数（汉字）44.MAC算法说明(对于商户端支持MD5组件注册方法，请看以下说明):65.具体使用方法见附件：76.MAC算法说明(对于商户端不支持MD5组件注册方法，请看以下说明):87.MAC算法原理:108.支付网关商户接口参数129.英文支付网关131. 网上支付使用条件1.1 用户进行网上支付条件1) 和6688签约用户 用户已在6688签约，申请网上支付服务 用户签约帐户（信用卡或储蓄卡帐户）可用于网上支付2. 网上支付步骤2.1 网上支付业务步骤图：865银行后台网关guan关商户 72 943 1用户 网上支付业务步骤步骤说明：1) 用户登录商户网站，选择商品2) 商户网站经过6688资格验证，查询商户方支持网上支付方法3) 商户网站给用户提供可选择银行支付方法，由用户自行选择4) 用户选择商品及要进行支付银行后，产生预定单信息5) 信息经过加密传到支付网关平台。商户提供商户代码、订单号、累计金额及订单备注等信息，此四个信息必需提供；除此之外,商户方还必需将商户代码、订单号、累计金额及订单备注四个信息利用MAC组件进行加密产生MD5校验码，最好以post方法传输到支付网关平台用以确保定单信息正确性.其中，订单备注信息可为多种其它订单信息拼成一个字串，比如：订货人id,收货人地址等，商家网站将此信息传输给6688网站,6688网站将保留这些订单信息,方便于以后信息查对。6) 支付网关平台接收用户支付信息，转发到银行后台业务处理系统；7) 银行后台会将支付成功是否信息传送给支付网关平台8) 支付网关平台会依据商户提交过来URL调用商户接收支付结果页面9) 商户将用户支付结果显示给用户2.2 商户货款结算和对帐步骤1) 用户在商户网站选择商品并下单，经过6688支付网关付款给银行后,商户统计相关用户信息。货款记入6688在银行专用结算帐户（含定单号信 息）中，由6688和商户按协议约定进行款项结算。2) 6688负责到银行处查询该用户该笔订单付款信息，假如付款完成，由6688通知商户进行配货，网上交易完成。商户经过6688提供订单查询系统查询本商户订单具体处理情况，并立即处理，并发货。3. 用户网关接口参数（汉字）用户在商户网站选择商品后，商户网站生成以下信息，传送到网站：域名名称类型、长度备注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收货人emailCHAR(32)可为空tuserurl接收支付结果url CHAR(32)可为空todrid订单号CHAR(6)商家网站方形成订单号,传输给6688网站,方便于以后订单查询和查对,必填项目tSupperComRegflag商户端是否能够支持Md5加密组件注册标志int商户网站是否能够注册Md5加密组件，处理部分商户因为是租用ISP服务器空间，不能够注册组件一个参数。默认为空或0，表示商户支持MD5组件注册，不然为1，表示不支持必填项目MacMAC校验域CHAR(32)必填项目采取标准MD5算法，由商户实现,具体算法以下： 注：1备注栏目中有必填项目字样是商家必需提供。 2商户要确保定单号唯一性。站点间接口参数传送采取post方法，商户将以上信息包含在FORM中，在SUBMIT后将生成URL，以下所表示： tuserurl参数是6688网站提供给商家银行支付结果信息地址，商户在取得支付结果后期望用户进入商户网站某个页面URL，商户接收程序能够依据支付是否成功而指定不一样URL，或带不一样参数，商户能够依据参数不一样决定显示什么信息，假如成功支付情况，还能够依据参数不一样决定向用户提供什么服务。支付网关将传回4个参数：billNo、amount、succ、mac。参数具体意义详见5。支付网关商户接口参数。4. MAC算法说明(对于商户端支持MD5组件注册方法，请看以下说明):参与MAC运算字符及其次序以下：mac=dd.string(tmbrid=+cstr(tmbrid)+&tsummoney=+cstr(tsummoney)+&tcontent1=+cstr(tcontent1)+&todrid=+cstr(todrid)+ &tpwd=+ tpwd)商户在使用支付网关时候，除了4个必需提供商品信息外和一个支付密码外，还必需传过一个校验码，网关使用商户传输过来校验码和网关本身产生一个校验码进行比较来判定商户正当身份。注：校验码产生时，四个产品信息和一个支付密码，必需根据如上提供次序；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 定单信息字串:多种其它定单信息拼成字串，比如：收货人，商品名称，商品个数,订货时间等。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)+ &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-23CSEDGHDSDE /支付密码，由6688网站提供，包含在商户网站程序代码中strtmp=tmbrid=+tmbrid+&tsummoney=1+&todrid=+todrid+&tpwd=+tpwd macstr=calcMD5(strtmp)2.商户在使用支付网关时候，除了三个必需提供商品信息外和一个支付密码外，还必需传过一个校验码，网关使用商户传输过来校验码和网关本身产生一个校验码进行比较来判定商户正当身份。注：校验码产生时，三个产品信息和一个支付密码，必需根据如上提供次序；MAC校验码产生示例3 使用MD5组件string方法产生mac校验码，即对tmbrid，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 /支付密码，由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网站提供，包含在商户网站程序代码中strtmp=tmbrid=+tmbrid+&tsummoney=+cstr(tsummoney)+&todrid=+todrid+&tpwd=+tpwd macstr=calcMD5(strtmp)2.商户在使用支付网关时候，除了三个必需提供商品信息外和一个支付密码外，还必需传过一个校验码，网关使用商户传输过来校验码和网关本身产生一个校验码进行比较来判定商户正当身份。注：校验码产生时，三个产品信息和一个支付密码，必需根据如上提供次序；MAC校验码产生示例3.使用MD5组件string方法产生mac校验码，即对tmbrid，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 /支付密码，由6688网站提供，包含在商户网站程序代码中strtmp=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、 将这个数映射到ASCII码表，形成对应字符，如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;tmp=(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 md5 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(32)采取标准MD5算法，具体算法以下说明 注：1. mac=dd.string(billNo=+ billNovalue+&amount=+ amountvalue+&succ=+ succvalue +&pwd=+ pwdvalue)2. 假如商户-支付网关时候就没有传参数：tuserurl，支付网关就不会将支付结果传给商户。3. pwdvalue：假如为我们支付网关店铺，我们会在开店以后，发一封email，在email中，我们会告诵您支付密码，该密码为此项值。发送和接收具体例子程序，详见：INFOPAGE.ASP（用户订单信息）SEND.ASP（将用户订单信息发送给支付网关例子程序，对于商户端支持MD5组件注册方法）P.ASP（将用户订单信息发送给支付网关例子程序，对于商户端不支持MD5组件注册方法-JSCRIPT）PVB.ASP（将用户订单信息发送给支付网关例子程序，对于商户端不支持MD5组件注册方法-VBSCRIPT）GETRESULT.ASP（从支付网关接收支付结果例子程序）PPHP.PHP（PHP程序连接支付网关例子）步骤例子： 步骤例子： 步骤例子： 9. 英文支付网关对于需要使用英文支付网关用户，我们提供了对应接口。我们是在汉字支付网关基础上进行了对应修改。传入参数均和汉字一样（详见3-8）。只是对form提交页面进行了修改:将提交页面由，修改为：.例子详见：INFOPAGEE.ASP（用户订单信息）SENDE.ASP（将用户订单信息发送给支付网关例子程序，对于商户端支持MD5组件注册方法）步骤例子：