财付通分销平台 协议说明书 深圳市腾讯计算机系统有限公司 文档历史 修订日期 修订内容 修订版本 修订人 2010-03-11 创建 0.1 Tencent 目录 1. 引言 3 1.1. 编写目的 3 1.2. 背景 3 1.3. 定义 3 1.4. 参考资料 3 2. 协议概述 4 2.1. 协议列表 4 2.2. 协议的交互逻辑 4 3. 销售协议 4 3.1. 协议说明 4 3.1.1. 标准前端接口一 4 3.2. 调用说明 5 3.3. 返回结果说明 8 4. 注意事项及限制 8 5. 接入常见问题 8 6. 常见的错误码 9 引言 编写目的 本文档说明了财付通分销平台的接口协议等,供使用该接口的经销商和本项目的后续开发维护人员使用. 背景 由于目前一些合作网站在销售腾讯的会员,红钻,黄钻,Q币等产品,为了提高用户感和实时性,需要实现自动充值、开通服务等功能.为了满足这些经销商的需求,同时保证交易的安全性,提出了财付通分销平台的概念. 定义 财付通分销平台:在财付通直通车系统上扩展出来的,满足有自己销售平台,需要实时实现Q币 充值、服务开通的要求的经销商的快速通道. 商户号:经销商注册的分销平台帐号,目前支持QQ号码,同时必须是财付通注册用户. 参考资料 协议概述 协议列表 协议名称 说明 销售协议 销售Q币和开通服务的协议 协议的交互逻辑 销售协议 协议说明 协议采用HTTP协议,经销商将请求报文post到腾讯的财付通分销平台站点的80端口: fenxiao.tencent.com 80 标准前端接口一 该接口适应于所有分销平台接入产品 调用url为: http://fenxiao.tenpay.com/app/api/distributorbuy?ServiceCode=***&QQuin=***&ZtcQQuin=*** &BuyCount=***&comm1=***&comm2=***&sign=*** 调用说明 参数说明: 输入参数 数据类型 说明 是否必填 ServiceCode varchar(20) 产品类型,如Q币YQQuin varchar(10) 用户帐号(用户QQ号) Y ZtcQQuin varchar(10) 财付通帐号 Y BuyCount Int 充值数量 Y comm1 varchar(255)交易备注一,缺省为1 Y comm2 varchar(255) 交易备注二,缺省为1 Y sign char (32) 数字签名,字母是小写 Y 调用说明: 所有字段中不能包含 "&" 和"=". ServiceCode:表示产品类型 QQACCT_SAVE Q币-QQPOINT Q点LTMCLUB 会员 XXJZGW 黄钻 XXQGAME 蓝钻 XXQQF 红钻 PETVIP 粉钻 XXQQT QQ堂紫钻 XXZXYY 绿钻 QQR2BY QQ音速 DNFHZ DNF黑钻 QQFCZZ QQ飞车紫钻 QTD512M 512M网络硬盘 -XXYXLB QQ游戏欢乐大礼包 QQKDC QQ飞车点券 -DNFDQ DNF点券 -CFDQ CF点券 CFCLUB CF会员 -QXZB 七雄争霸元宝 DMLQ 大明龙权点券 -XWDQ QQ炫舞点券 QQXWZZ QQ炫舞紫钻 QQuin:用户帐号,及收货号码,目前都是表示QQ号码 ZtcQQuin:财付通帐号,及支付号码,目前都是表示QQ号码 BuyCount:充值数量,它的意义和取值范围与ServiceCode产品类型有关 5.1若产品=Q币,则BuyCount表示个数,取值范围[1, 1000]; 5.2若产品=Q点,则BuyCount表示点数,必须是10的整数倍,取值范围是[10, 10000]; 5.3若产品=包月服务,则BuyCount表示月数,取值范围[1, 24]; 5.4若产品=QQ飞车点券,则BuyCount表示点数,必须是100的整数倍,取值范围是[100, 100000]; 5.5若产品=DNF点券,则BuyCount表示点数,必须是100的整数倍,取值范围是[100, 100000]; 5.6若产品=CF点券,则BuyCount表示点数,必须是100的整数倍,取值范围是[1000, 100000] 5.7若产品=七雄争霸元宝,则BuyCount表示点数,必须是100的整数倍,取值范围是[10, 100000] 5.8若产品=大明龙权点券,则BuyCount表示点数,必须是100的整数倍,取值范围是[100, 100000] 5.7若产品=QQ炫舞点券,则BuyCount表示点数,必须是100的整数倍,取值范围是[500, 100000] comm1:备注一 6.1若产品=QQ飞车点券,则comm1表示玩家建立角色的大区,目前1为电信区,2为网通区,3为电信二区; 6.2若产品=CF点券,则comm1表示玩家建立角色的大区 CF点券玩家大区选择的参数获取方法如下: a.在页面head中植入: b.在页面body中植入: b.在页面body中植入: b.在页面body中植入: