骏网直充产品接口开发参考文档V0

川NNE「骏网骏网直充产品接口开发参考文档V

3.0北京骏网联合科技有限公司ScrvcrInfoGameServerInfoServer_IDO/Server_IDScrvcr_Namc〉九城服务器/Servcr_Namc/GamcScrvcrInfoGameAreaInfoArea_IDI/Area_IDServer_IDO/Server_IDArea一区（电信）/Arca/GamcArcaInfoGameAreaInfoArea_ID2/Area_IDvServer」DOv/Server_IDArea二区（电信）/Arca/GameAreaInfoGameCardTypeCard_Type_ID1l/Card_Type_IDCard_Type九城卡15元包月/Card_TypeCard_Value15/Card_Value/GameCardTypeGameCardTypeCard_Type_ID12/Card_Type_IDCard_Type九城上15元记点v/Card_TypeCard_Value15/Card_Value/GameCardTypeGameCardTypeCard_Typc_ID21/Card_Typc_IDCard_Type九城卡30元包月v/Card_TypeCard_Value30/Card_Value/GameCardTypeGameCardTypeCard_Typc_ID22/Card_Typc_IDvCard_Type九城卡30元记点v/Card_TypeCard_Value30/Card_Value/GameCardTypeGamcCardTypcCard_Type_ID31/Card_Type_IDvCard_Type15元魔兽即时卡/Card_TypeCard_Value15/Card_Value/GameCardTypeGamcCardTypcCard_Type_ID32/Card_Type_IDvCard_Type30元魔兽即时卡v/Card_TypeCard_Value30/Card_Value/GameCardType/ServerInfo

2、无区服的产品XML配置如下xmlvcrsion=

1.0cncoding=GB2312ServerInfoGaineServerInfoServer_lD0/Server_lDServer_Name所有服务｛^/Server_Naine/GamcServerInfoGameAreaIntbArca_IDO/Arca_ID〈Server」D0/Server_IDArea〉所有区域/Area〉/GameAreaInfoGameCardTypeCard_Typc_ID15/Card_Type_lDCard_Type12币/Card_TypeCard_Valuc15/Card_ValucGameCardTypeGameCardTypcCard_Type_ID30/Card_Type_IDCard_Type24币/Card_TypeCard_Value30/Card_Vahie/GameCardTypeGamcCardTypeCard_Typc_ID50/Card_Typc_IDCard_Type40币/Card_TypeCard_Value50/Card_Value/GameCardTypeGameCardTypeCard_Typc_ID100/Card_Typc_lDCard_Type80币/Card_TypeCard_Valucl00/Card_Valuc/GameCardType/ServerInfo如果有任何问题，随时和骏网技术联系联系人王红伟••MSN E-mail:文档历史目录L引言错误!未定义书签编写目的背景….•…定义…••…参考资料

2.参数概述.…错误!未定义书签L引言.编写目的本系统采用公开标准Web方式实现骏网平台和合作厂商产品充值服务器的通讯，由合作厂商产品冲值服务器为骏网提供充值接口，骏网通过访问该接口实现为用户充值的目的接口内部实现由产品运营商（或开发商）完成指导运营商技术人员实现与电子商务接口的顺利对接12背景为了提高运营商开发的速度和实时性，简单举例说明媚种语言的接收参数方法13定义骏网平台直充参考文档，需要实现每种语言的举例，说明一些细节的格式等通用的功能14参考资料.参数概述.普通事例

1、数据传送骏网平台通过运营商提供的接口山，post数据给运营商Url=Method=POSTEncoding=GB2312/Encoding=UTF-8双方可以协定Parameters=ServerID=0AreaID=0Username=testCardType=10JNetBiinD=C6llSign=4dIf312ffe48794ae9e38c72bc5da745接受数据iServerlD=s[ServerID];iArcalD=sCArcalD1];sUsername=sfUsername];iCardType=s[CardType]:iBiinD=s[JNeBiinDJ;iSign=sfSign];

2、系统安全a.IP限制通过骏网到产品充值服务器的访问IP为骏网服务器组的固定IP产品充值服务器限制只允许骏网的IP访问该接口，其他尝试访问该接口的IP均为非法IP获取访问的IP RequestIP=ing.Trim;b.数据加密主要应用标准32位MD5数据加密算法，开发双方约定一个共同的MD5加密KEY进行MD5不可逆加密，产品充值服务器程序在收到骏网请求的时候，需比较该加密字符串，如果不符合双方加密约定，则该访问为非法

3、返回信息的格式充值Retuin=xxxSeiverID=xxxAreaID=xxxUsername=xxxCardType=xxxJNetBillID=xxxMchBillID=xxxSign=xxxMessage=xxx查询Return=xxxJNetBilllD=xxxMchBilllD=xxxSign=xxxxxx.各种语言实例Aspxi、接受参数stringRequestURL=;stringRequestIP=;stringServerID=;〃此参数为xml文件里面的Server_ID的值，由用户自己选择stringArealD=;〃用户所选择Server」D下对应的Area」D由用户自己选择stringUsemame=;〃用户所在产品服务器上的账号stringCardTypc=；〃用户所选择的包含在xml里面的卡类型ID对应字段为Card_Type_IDstringJNetBilllD=;〃用户直冲产品时，在JCard平台生成的账单号淇值唯一stringSign=;//加密Key在开发时由双方协商确定ServeriD=s[ServerIDJ;ArealD=s[AreaID]；Username=sfUsemame];CardType=s[CardType]；JNetBilllD=s[JNetBillIDH];Sign=sPSign];RequestIP=ing.Trim;ifrVariabIes[nRequest_Method]!=GET{RequestURL=.ToStringO+ScrvcrID=+ScrvcrID+ArcaID=+ArealD+Usemame=+Username+CardType=u+CardType+JNelBillID=+JNetBilllD+Sign=+Sign;}elseRequestURL=.ToStringO;

2、MD5加密.asswordForStoringInConfigFilcstrMD5Aspi、接受参数dimscrvcr!DArcalDUserNamcCardTypcJNetBilllDSignRequestIPServerlD=requestServerIDAreaID=requestCArealDUserName=rcquestHuserNameCardType=requestCardTypeJNetBillID=requestJNetBillID”Sign=requcstSignRcquestIP=rVariablesREMOTE_ADDRJava

1、接受参数StringiServerlD=rameterServerID;〃服务器IDStringiAreaID=rameterAreaID，分区IDStringsUsername=ramelerUsername;〃用户帐号名StringiCardType=rameterfCardType;〃产品对应编码StringiJNetBillID=rameterJNctBillID;〃骏网单据号SiringiSign=ramelerSign;〃签名SiringsCliendP=moteAddr;〃充值人客户端IPJsp

1、接受参数%@pagelanguage=javacontentType=text/html;charset=gb2312%%@pagcimport=PayMd5ConfigKcy%〃PayMd5是引用的md5包的名称//ConfigKcy是引用密钥包的名称%Stringkey=yValuekeyValue;//商家密钥StringiServerlD=rameierServerID;〃服务器IDStringiAreaID=rameterAreaID;〃分区IDStringsUsemame=rameterUsername;〃用户帐号名StringiCardType=rameterfCardType;〃产品对应编码StringiJNctBillID=ramcterJNctBillID;//骏网单据号StringiSign=rameterfSign;〃签名〃判断参数是否为空//获得MD5签名hmac=5sUscrnamc+iCardTypc+iJNctBillID+kcy;〃判断签名是否一致〃判断其他参数是否合法村在%Php|、接受参数接口测试步骤测试用的Key=alb2c

3.测试充值接口，组织一个测试吊在浏览器地址栏输入注意Sign=ind5Uscrnamc+CardTypc+JNctBi111D+KcySign=md5testName15C521aIb2c3充值接口返I可串的格式在成功的单据Rcturn=000ScrvcrID=0ArcalD=0Uscrnamc=tcstNaincCardTypc=15JNctBillID=C521MchBillID=000002Sign=2a3b9c76cacc29dc4ed26823a4529f6dsMcssagc=充值成功！失败的单据Return=555ServerID=0AreaID=0Usemame=testNameCardType=15JNetBillID=C521MchBillID=Sign=a852417be4bbld648f2ecddaa0laa0lIsMessage=S4^Md5错误.测试查询接口，组织一个测试串在浏览器地址栏输入注意Sign=md5JNetBillID+KeySign=ind5C521alb2c3杳询接口返回串的格式在查询成功Return=000JNetBillID=C521MchBillID=000002Sign=45b823f6c9de41258bdl54380ae42951查询失败Rcium=OO9JNeBillID=C521MchBillID=Sign=3cOeO6fUb5O3b6l10d8ebecba7634eae.XML实例ServerInfoGarneServerinfoServer_iDO/Server_IDServer_Name九城服务器/Server_Name/GamcScrvcrInfoGaineAreaInfoArea」DI/Area_IDServer_IDO/ServerJDArea区（电信）/Area/GanicArcaInfoGameAreaInfoArea_ID2/Area_IDvServer」DOv/Server」DArca二区（电信）/Arca/GamcArcaInfoGameCardTypeCard_Type_ID1l/Card_Type_IDCard_Typc九城卡15元包月/Card_TypcCard_Value15/Card_Value/GameCardTypeGameServerInfo每个服务器的信息Server_ID服务器的ID对应充值接口的参数ServerlDSener_Name服务器的名称GameArealnfo每个区域的信息Area_ID区域的ID对应充值接口的参数ArealDSener_ID区域所属的服务器IDArea区域的名称GameCardType对应产品的信息Card_Type_ID产品的类型（产品的对应编码）对应充值接口的参数CardTypeCard_Type产品的名称Card_Value产品的面值（RMB）

41.XMLI、有区服的XML配置修订日期修订内容修订版本修订人2008-5-12创建

1.0王红伟。