文档介绍：财付通分销平台
协议说明书
深圳市腾讯计算机系统有限公司
文档历史
修订日期
修订内容
修订版本
修订人
2010-03-11
创建
Tencent
目录
1. 引言 3
. 编写目的 3
. 背景 3
. 定义 3
. 参考资料 3
2. 协议概述 4
. 协议列表 4
. 协议的交互逻辑 4
3. 销售协议 4
. 协议说明 4
. 标准前端接口一 4
. 调用说明 5
. 返回结果说明 8
4. 注意事项及限制 8
5. 接入常见问题 8
6. 常见的错误码 9
引言
编写目的
本文档说明了财付通分销平台的接口协议等,供使用该接口的经销商和本项目的后续开发维护人员使用。
背景
由于目前一些合作网站在销售腾讯的会员,红钻,黄钻,Q币等产品,为了提高用户感和实时性,需要实现自动充值、开通服务等功能。为了满足这些经销商的需求,同时保证交易的安全性,提出了财付通分销平台的概念。
定义
财付通分销平台:在财付通直通车系统上扩展出来的,满足有自己销售平台,需要实时实现Q币
充值、服务开通的要求的经销商的快速通道。
商户号:经销商注册的分销平台帐号,目前支持QQ号码,同时必须是财付通注册用户.
参考资料
协议概述
协议列表
协议名称
说明
销售协议
销售Q币和开通服务的协议
协议的交互逻辑
TENCENT
经销商
销售请求
销售结果
销售协议
协议说明
协议采用HTTP协议,经销商将请求报文post到腾讯的财付通分销平台站点的80端口:
fenxiao. 80
标准前端接口一
该接口适应于所有分销平台接入产品
调用url为:
http://fenxiao./app/api/distributorbuy?ServiceCode=***&QQuin=***&ZtcQQuin=*** &BuyCount=***&comm1=***&comm2=***&sign=***
调用说明
参数说明:
输入参数
数据类型
说明
是否必填
ServiceCode
varchar(20)
产品类型,如Q币
Y
QQuin
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:表示产品类型
T_SAVE Q币
-QQPOINT Q点
LTMCLUB 会员
XXJZGW 黄钻
XXQGAME 蓝钻
XXQQF 红钻
PETVIP 粉钻
XXQQT QQ堂紫钻
XXZXYY 绿钻
QQR2BY QQ音速
DNFHZ DNF黑钻
QQFCZZ QQ飞车紫钻
QTD512M 512M网络硬盘
-XXYXLB QQ游戏欢乐大礼包
QQKDC