直通车2-0接口协议.docVIP

财付通直通车 协议说明书 深圳市腾讯计算机系统有限公司文档历史 修订日期 修订内容 修订版本 修订人 2008-05-08 创建 0.1 Tencent 2008-06-26 添加注意事项 0.2 Tencent 2008-07-18 添加常见错误信息及相关错误码 0.3 Tencent 2010-03-10 去掉已下线产品：交友、网盘 0.4 Tencent  目录 1. 引言 3 编写目的 3 背景 3 定义 3 参考资料 3 协议概述 4 协议列表 4 协议的交互逻辑 4 销售协议 4 协议说明 4 调用说明 4 返回结果说明 6 注意事项及限制 6 接入常见问题 6 常用的错误码 6  销售协议 协议说明 协议采用HTTP协议，经销商将请求报文post到腾讯的财付通直通车站点的80端口： 80 调用url为： /cgi-bin/pay/bank_ztc_entry.cgi?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 N comm2 varchar(255) 暂时保留，缺省为1 N sign char (32) 数字签名，字母是小写 Y 调用说明： 所有字段中不能包含 “” 和 “=”. ServiceCode：表示产品类型 QQACCT_SAVE Q币 -QQPOINT Q点 --去掉 LTMCLUB 会员 XXJZGW 黄钻 XXQGAME 蓝钻 XXQQF 红钻 PETVIP 粉钻 XXQQT QQ堂紫钻 XXZXYY 绿钻 QQR2BY QQ音速 DNFHZ 黑钻 QQFCZZ QQ飞车紫钻 -------------------------------------------------------------------上面数量1-24个月 -XXYXLB QQ游戏欢乐大礼包 ------------- 1 - 24 个 -DNFDQ DNF点券 QQKDC QQ飞车点券（comm1表示玩家建立角色的大区，目前1为电信区，2为网通区，3为电信二区） ------------------上面2个数量为100-10000个点券 QQuin：用户帐号，及收货号码，目前都是表示QQ号码 ZtcQQuin：财付通帐号，及支付号码，目前都是表示QQ号码 BuyCount：充值数量，它的意义和取值范围与ServiceCode产品类型有关 若产品=Q币，则BuyCount表示个数，取值范围[1, 1000] 若产品=Q点，则BuyCount表示点数，必须是10的整数倍，取值范围是[10, 10000] 若产品=包月服务，则BuyCount表示月数，取值范围[1, 24] sign为按顺序对交易信息的MD5加密签名的32位字符串： sign=md5(ServiceCode=***QQuin=***ZtcQQuin=***BuyCount=***comm1=***comm2=***||enc_key) ，其中enc_key为注册财付通直通车时生成的key 签名举例：一笔交易，99999需要给用户123456充值1Q币，需要从socket读取返回结果，双方约定key为!@#$%^123ABCfg，则签名算法为： sign = Md5(“ServiceCode=QQACCT_SAVEQQuin=123456ZtcQQuin=99999BuyCount=1 comm1=1comm2=1||!@#$%^123ABCfg” ) 最终的请求串为(假设最终的Md5加密结果是1e1cf8d9d57d48b96ad10bc2beead6ac) /cgi-bin/pay/bank_ztc_entry.cgi?ServiceCode=QQACCT_SA