直通车2.0接口协议

《直通车2.0接口协议》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、Tencent财付通直通车接口协议财付通直通车协议说明书深圳市腾讯计算机系统有限公司6Tencent财付通直通车接口协议文档历史修订日期修订内容修订版本修订人2008-05-08创建0.1Tencent2008-06-26添加注意事项0.2Tencent2008-07-18添加常见错误信息及相关错误码0.3Tencent2010-03-10去掉已下线产品：交友、网盘0.4Tencent6Tencent财付通直通车接口协议目录1.引言31.1.编写目的31.2.背景31.3.定义31.4.参考资料32.协议概述42.1.协议列表42.2

2、.协议的交互逻辑43.销售协议43.1.协议说明43.2.调用说明43.3.返回结果说明64.注意事项及限制65.接入常见问题66.常用的错误码66Tencent财付通直通车接口协议1.引言1.1.编写目的本文档说明了财付通直通车的接口协议等，供使用该接口的经销商和本项目的后续开发维护人员使用。1.2.背景由于目前一些合作网站在销售腾讯的会员,红钻,黄钻,Q币等产品，为了提高用户感和实时性，需要实现自动充值、开通服务等功能。为了满足这些经销商的需求，同时保证交易的安全性，提出了财付通直通车的概念。1.3.定义财付通直通车：在财付通系统

3、上扩展出来的，满足有自己销售平台，需要实时实现Q币充值、服务开通的要求的经销商的快速通道。商业号：腾讯分配给经销商的帐号.1.4.参考资料6Tencent财付通直通车接口协议1.协议概述1.1.协议列表协议名称说明销售协议销售Q币和开通服务的协议1.2.协议的交互逻辑TENCENT经销商销售请求销售结果2.销售协议2.1.协议说明协议采用HTTP协议，经销商将请求报文post到腾讯的财付通直通车站点的80端口：bank.qq.com80调用url为：http://bank.qq.com/cgi-bin/pay/bank_ztc_ent

4、ry.cgi?ServiceCode=***&QQuin=***&ZtcQQuin=***&BuyCount=***&comm1=***&comm2=***&sign=***2.2.调用说明参数说明：输入参数数据类型说明是否必填ServiceCodevarchar(20)产品类型，如Q币YQQuinvarchar(10)用户帐号(用户QQ号)YZtcQQuinvarchar(10)财付通帐号YBuyCountInt充值数量Y6Tencent财付通直通车接口协议comm1varchar(255)暂时保留，缺省为1Ncomm2varcha

5、r(255)暂时保留，缺省为1Nsignchar(32)数字签名，字母是小写Y调用说明：1.所有字段中不能包含“&”和“=”.2.ServiceCode：表示产品类型QQACCT_SAVEQ币-QQPOINTQ点--去掉LTMCLUB会员XXJZGW黄钻XXQGAME蓝钻XXQQF红钻PETVIP粉钻XXQQTQQ堂紫钻XXZXYY绿钻QQR2BYQQ音速DNFHZ黑钻QQFCZZQQ飞车紫钻-------------------------------------------------------------------上面数量1

6、-24个月-XXYXLBQQ游戏欢乐大礼包-------------1-24个-DNFDQDNF点券QQKDCQQ飞车点券（comm1表示玩家建立角色的大区，目前1为电信区，2为网通区，3为电信二区）------------------上面2个数量为100-10000个点券3.QQuin：用户帐号，及收货号码，目前都是表示QQ号码4.ZtcQQuin：财付通帐号，及支付号码，目前都是表示QQ号码5.BuyCount：充值数量，它的意义和取值范围与ServiceCode产品类型有关若产品=Q币，则BuyCount表示个数，取值范围[1,

7、1000]若产品=Q点，则BuyCount表示点数，必须是10的整数倍，取值范围是[10,10000]若产品=包月服务，则BuyCount表示月数，取值范围[1,24]6.sign为按顺序对交易信息的MD5加密签名的32位字符串：sign=md5(ServiceCode=***&QQuin=***&ZtcQQuin=***&BuyCount=***&comm1=***&comm2=***

8、

9、enc_key)，其中enc_key为注册财付通直通车时生成的key签名举例：20030325的一笔交易，99999需要给用户123456充值1Q

10、币，需要从socket读取返回结果，双方约定key为!@#$%^&123ABCfg，则签名算法为：sign=Md5(“ServiceCode=QQACCT_SAVE&QQuin=123456&ZtcQQuin=99999