CTAPIV环迅支付接口.docx-资源下载-咨信网-让知识获取变得高效

CTAPIV环迅支付接口.docx

1、CROWN TECHNOLOGY CTAPI游戏接入接口使用说明文档 V1.7 CTAPI游戏接入接口 1 1. 概述 2 2. 协议约定及功能接口 2 2.1 通讯规范 2 2.1.1数据结构 3 2.1.2安全验证 3 2.1.3响应规范 3 2.1.4 错误码 3 2.2 接口列表及数据约定 4 2.2.1获取会员登录URL[核心接口] 4 2.2.2获取供应商会员信息 6 2.2.3会员存款[核心接口] 6 2.2.4会员取款[核心接口] 7 2.2.5会员存取款状态查询[核心接口] 8 2.2.6在线会员列表 9 2.2.7 注销在线会员 9

2、2.2.8 会员状态更新 10 2.2.9 按时间查询已结算和已撤销注单[此接口仅作查询之用] 11 2.2.10 按时间查询未结算注单[此接口仅作查询之用] 12 2.2.11 获取结算/撤销注单[与2.2.12配对使用][取注单请使用此接口][核心接口] 13 2.2.12 标记结算/撤销注单[与2.2.11配对使用][核心接口] 14 2.2.13 按时间查询已结算和已撤销注单数目 14 2.2.14 按时间查询未结算注单数目 15 2.2.15按注单号查询未结算/已结算/已撤销注单 16 3. 附录 16 3.1 桌号、类型对应表 16 3.2货币列表 16 3.

3、3语言列表 17 3.4 注单说明 17 3.5下注及输赢结果说明 17 1. 概述本文档主要叙述CT游戏中心服务器与游戏接入商服务器之间的数据通讯协议及规范，双方的软件在此基础上达到数据高性能、高安全性进行交换与共享的目的。 [核心接口]表明此接口极为重要，如有任何疑问，请及时与供应商方面联系。随本文档一起还有“demo_xx.txt”，“CasinoLimit_xxxxxx.xlsx”，“CtapiDemoJs”客户端Demo。系统时区：GMT+7 系统维护时间：每周二（12：00-13：00）（GMT+7） 2. 协议约定及功能接口 2.1

4、通讯规范 2.1.1数据结构 http:///ctapi?action=&agent=&username=¶m= 参数说明：参数类型描述 action String 命令标识符 agent String 代理账号，由供应商提供。区分大小写。 username String 会员账号，长度[1,16]; 只允许数字、字母与@标记符。只能使用小写。 param String 其它信息（可选），[ ]为可以项目 2.1.2安全验证 Ø 安全码供应商提供密文Secu

5、rityKey：由供商提供（在demo[xx..xx].txt中） Ø 来源检查由接入商提供，一个agent可以对应多个referer（暂时没用）。 Ø IP过滤由接入商提供系列IP，IP跟agent进行绑定。测试机不检测IP绑定，正式机强制性检测IP绑定。 2.1.3响应规范 2.1.4 错误码通常情况下，0 表示没有错误，负数为一般错误，正数为相应操作错误。下

6、表为一般错误表：错误码文本数据描述 -1 System maintenance 系统维护 -2 Invalid action 命令标识符错误 -3 Invalid arguments 请求参数错误 -4 IP address not allow IP限制 -5 Invalid username 用户名或代理错误 -6 System error 系统错误 2.2 接口列表及数据约定接入端在请求数据时，需根据接口的不同组织相应的参数为字符串，通过TCP连接发送至服务器端，服务器端通过约定以特定分隔符将字符串解析为对应参数，处理完成后，

7、将结果组织为字符串通过TCP连接发回接入端。在通讯过程中，为保证数据的正确性和提高程序性能，通讯过程中数据类型与字符串之间的转换按下表规范：数据类型描述示例 String Unicode字符串如：hello，abc123 Byte 可转为标准数字如：-123，9 范围：-128~127 Integer 可转为标准数字如：-123，9 范围：-2147483648~2147483647 Long 可转为标准数字如：-123，4，5099 范围：-9223372036854774808~9223372036854774807 Double

8、可转为标准浮点数如：-1.23，4，5.09 范围：4.9000000e-324~1.797693e+308 Boolean bool值 True，False Date 以yyyy-MM-dd HH:mm:ss 形式的字符串如：2011-01-31 19:25:34 为便于客户端与服务器端易于解析数据，以如下分隔符作为数据分隔使用的特殊字符（因此在正常数据内容中，不应包括如下特殊字符）：第一层数据分隔符：| 第二层数据分隔符：` 第三层数据分隔符：, 客户端在接收到来自服务器端的返回数据Data，并转化为字符串时，按接口约定，对该字符串以分隔符

10、592,593,591,`710,712,713,714,`-1` 1151,1183,1184,1185,`1923,|b69af9287876c8cfc42096be301b233c 例：cn|RMB|900.0||b69af9287876c8cfc42096be301b233c 参数说明参数类型描述 Lang String 语言(见语言列表) Currency String 货币(见货币列表) MaxWin Double 该会员的单日最大可赢取金额。（当天12点到第二天12点）注： a)会员最后一笔下注有可能超过最大限额 b)负数或0表示不限制用

11、户赢取金额 Limit String 此处为各游戏限红[详见CasinoLimit_xxxxxx.xlsx]：顺序为:百家乐|轮盘|赛宝|龙虎|番摊|保险百家乐|色碟最多四条限红，注： a)-1为游戏不可玩 b)当Limit为空时,供应商自动提供四条最小限红例：578,579,580,`589,590,588,587,`594,592,593,591,` 710,712,713,714,`-1`1151,1183,1184,1185,`1923, Token String Md5加密生成的验证码，产生规则：Md5(“SecurityKey+Currency+Age

12、nt+UserName+Lang+MaxWin”)，（见加密算法）。例：Md5(“sc4XgdJc85RMBLiga365usd000cn900.0”)=d4493b6a9cc9f682c52dc82bbcc14150 返回数据描述例：code>0Successhttp://localhost:8080/api/ctapi/api/home.jsp?username=LOCALAPIusd000&key=8506806436720062641 例： 1Locked

13、索引文本数据描述 0 Success 返回登录URL，会员使用此URL登录说明：此URL有效期1分钟，若1分钟内没有登录，这个URL就会失效 1 Locked 账户被锁定登录步骤: a)调用2.2.1接口 b)返回0，提取内容，即登录URL c)重定向到登录URL 2.2.2获取供应商会员信息操作描述获取会员在供应商的相关信息。会员在线信息，“Online”表示在线, “Offline”表示不在线。会员状态信息，“Normal

14、表示正常，此时会员可登录游戏大厅并可下注；“Supend”表示暂停，此时会员可登录游戏大厅但不可下注；”Closed”表示停用，此时会员不可登录游戏大厅。会员余额信息，表示用户可用于下注的金额或提取的余额。使用场景 1#检测会员是否已存在。使用时机，调用2.2.1（获取会员登录URL）接口失败时。 2#检测会员是否在线。使用时机，调用2.2.7（注销在线会员）接口前。 3#查询会员是否正常。使用时机，调用2.2.8（会员状态更新）接口后。 4#查询会员余额。使用时机，调用2.2.4（会员取款）接口前。命令标识符 2 参数及组合格式返回数据描述

15、status>Online[Offline] Normal[Suspend][Closed] Amount 例：0User Exist OnlineNormal96.85 例：1

16、ext>User not exist 索引文本数据描述 0 User exist 用户存在且在线，返回用户信息 1 User not exist 用户不存在 2.2.3会员存款[核心接口] 操作描述会员将接入商钱包的钱，部分或者全部提取到游戏供应商的账户上进行游戏。接入商需对并发进行控制。使用场景会员将钱存到CASINO，建议调用

18、Md5(“SecurityKey+Amount+Agent+UserName+ Serial”)，（见加密算法）。例：Md5(“sc4XgdJc8536.58Liga365usd00032535”)=9264477335c078ca871a28b2fc8c0448 返回数据描述成功：返回转账金额例：0Success36.58 例：2Duplicated serial 索引文本数据描述 0 Su

19、ccess 操作成功，返回用户信息 1 User not exist 用户不存在 2 Duplicated serial 流水号存在 3 Currency error 币种错误 4 Deposit error 其它错误 2.2.4会员取款[核心接口] 操作描述会员将游戏供应商的账户上金额转存到接入商，取款时需调用“检查用户状态”接口检查用户金额避免错误。使用场景会员将钱从CASINO取出，建议调用2.2.5（会员存取款状态查询）接口进行确认。命令标识符 4 参数及组合格式 Serial|Amount|Currency|Token 例

20、32536|36.58|RMB|c7e1ba9f2e033e400d329793c55bcd62 参数类型描述 Serial Long 会员转账流水号(唯一)，由接入商产生。 Amount Double a)精度小数点两位,格式:######.00; b)大于0; Currency String 货币(见货币列表)，注：币种为空时，不作检查。 Token String Md5加密生成的验证码，产生规则：Md5(“SecurityKey+Amount+Agent+UserName+ Serial”)，（见加密算法）。例：Md5(“sc4XgdJc8

21、536.58Liga365usd00032536”)=c7e1ba9f2e033e400d329793c55bcd62 返回数据描述成功：返回转账金额例：0Success36.58 例：2Duplicated serial 索引文本数据描述 0 Success 操作成功，返回用户金额 1 User not exist 用户不存在 2 Duplicated serial 流水号存在 3

22、 Currency error 币种错误 4 Withdrawal error 其它错误 2.2.5会员存取款状态查询[核心接口] 操作描述查询指定流水号存款或取款是否成功，若成功，则返回相关信息，否则返回流水号不存在。使用场景确认存取款是否成功。使用时机，调用完2.2.3（会员存款）接口或2.2.4（会员取款）接口后。命令标识符 5 参数及组合格式 Serial 注意：username此处空或任意值。例：32536 参数类型描述 Serial Long 会员转账流水号(唯一)，由接入商产生。返回数据描述

23、Serial Username Amount Date Time 例： 0Success 32536usd00036.58 2013-01-31 19:25:34 例： 1

24、Serial not exist 32536 例： -6System error/result> 索引文本数据描述 0 Serial exist 流水号存在，返回用户金额 1 Serial not exist 流水号不存在 2.2.6在线会员列表操作描述获取所有在线用户使用场景

25、命令标识符 6 参数及组合格式注意：username此处空或任意值。返回数据描述 Username …… Username 例： 0Success usd000 usd001 索引文本数据描述 0 Success 返回用户列表。

26、2.2.7 注销在线会员操作描述将正在游戏中的会员强制踢出系统。使用场景命令标识符 7 参数及组合格式 username 1|[ username 2]|[ username 3]|[ username 4] 注意：username此处空或任意值。param参数为空注销所有会员,。返回数据描述 UsernameSuccess[Fail] …… Username

27、me>Success[Fail] 例： 0Success usd000Success cc001Fail 索引文本数据描述 0 Success 注销在线会员成功，顺序对应相应用户名 a)

28、Success成功 b)Fail失败（参数为空，或者不在线时） 2.2.8 会员状态更新操作描述更新会员账号的状态。不同状态说明，详见2.2.2（获取供应商会员信息）接口。使用场景命令标识符 8 参数及组合格式 Username 1`Status 1|[Username 2`Status 2] 注意：username此处无用，不作处理。例：usd000`1|usd001`2 参数类型描述 Type Byte 1：激活用户 2：暂停用户 3：关闭用户返回数据描述 User

29、nameSuccess[Fail] …… UsernameSuccess[Fail] 例： 0Success usd0001Success

30、tatus> cc0012Fail 索引文本数据描述 0 Success 更新状态成功，顺序对应相应用户名 a)Success成功 b)Fail失败（参数不正确、用户名不存在均会失败） 2.2.9 按时间查询已结算和已撤销注单[此接口仅作查询之用] 操作描述此功能用来获取一段时间内的结算和撤销注单，所有注单按时间排序，最大100笔，时间差不能超过24小时且抓取注单间

31、隔不能小于15秒，否则系统不予处理。（此功能很少用）警告：此接口仅作查询之用，取注单请使用2.2.11号接口使用场景极少使用命令标识符 9 参数及组合格式 StartTime|EndTime 例：2011-01-31 19:25:34|2011-01-31 19:27:34 注意：username为空，查询所有会员注单信息；不为空，查询单个会员下注信息。参数类型描述 StartTime Date 注单的开始时间，结算时间或撤消时间（包括此时间点） EndTime Date 注单的结束时间，结算时间或撤消时间（不包括此时间点）返回数据描述

32、例： 0 Success

33、>/TableID>

34、esult> 格式： 354030 --- long (注单号，指客户下注某笔记录在所有记录中的id号，如之前的记录是空此时客户test_1下了一个注单那么交易id=1，然后test_2 接着下了一笔那么test_2的id是2) 2011-07-25 14:19:09 --- String (yyyy-MM-dd HH:mm:ss)(下注时间) 2011-07-25 1

35、4:20:35---String(yyyy-MM-dd HH:mm:ss)(结算或撤消时间，特别说明：此字段对已结算或已撤消的注单有意义；对于未结算注单，是没有意义的，此时值为1970-01-01 00:00:00) smt99test23 --- String (客户账号名) CASH --- String (客户类型，现金或信用额) THB --- String (币别类型) 1000

36、0.0 --- double (下注之前的余额) 2000.0 --- double (下注之后的余额) 1 ---- int (是否计算,0:表示没计算，1:表示已经计算2，:表示结果撤销即此局作废) 1 --- int(表示是哪种游戏见附件) 1 ---- int(表示是哪桌的游戏见附件) 1247 ---long(牌类游

37、戏中,每洗一次牌就是一靴,代表靴号) 11 ----long(牌类游戏中指的是每一靴牌中的第几局;非牌类游戏指第几局) 8000.0 ---double(指下注金额) 0#8000#0#0#0#0#0# ---String(指详细下注的信息,此注单下了哪些注见附件) 1#0#0#2#^45#26#0#20#18#1# --String(此局结果见附件) 0

38、0#0.0#0.0^8000.0#0.0#0.0^0.0#0.0#0.0^0.0#0.0#0.0^0.0#0.0#0.0^0.0#0.0#0.0^0.0#0.0#0.0^ --String (计算结果明细,具体格式见计算的文档) 0.0 -- Double(此局的输赢金额注不是实际输赢还要计算,见计算说明) 60.50.82.208 -- String(客户下注时所在IP) 57 ---long (外部参数，无意义)

39、lebet>7800.0--double(实际有效下注,即可以计算结果的下注，此你下注了8000但是有效的只有7800) 计算说明：会员净输赢 = WinOrLoss – BetPoints 例如： BetPoints = 100.0, WinOrLoss = 0.0, 表示会员输100.0； BetPoints = 100.0, WinOrLoss = 100.0，表示会员没输没赢； BetPoints = 100.0, WinOrLoss = 200.0, 表示会员赢100.0；索引文本数据描述 0 Success

40、返回注单信息 1 Fetch time is too short 抓取注单间隔太短 2 Time interval is too long 时间差太长 2.2.10 按时间查询未结算注单[此接口仅作查询之用] 操作描述此功能用来获取一段时间内的未结算的注单，所有注单按时间排序，最大100笔。时间差不能超过30天且抓取注单间隔不能小于15秒，否则系统不予处理。（此功能很少用）警告：此接口仅作查询之用使用场景极少使用命令标识符 10 参数及组合格式 StartTime|EndTime 例：2011-01-31 19:25:34|2011-0

41、1-31 19:27:34 注意：username为空，查询所有会员注单信息；不为空，查询单个会员下注信息。参数类型描述 StartTime Date 注单的开始时间，下注时间（包括此时间点） EndTime Date 注单的结束时间，下注时间（不包括此时间点）返回数据描述索引文本数据描述 0 Success 返回注单信息，格式如2.2.9 1 Fetch time is too short 抓取注单间隔太短 2 Time interval is too long 时间差太长 2.2.11 获取结算/撤销注单[与2.2.1

42、2配对使用][取注单请使用此接口][核心接口] 操作描述此功能用来获取结算和撤销注单，所有注单按时间排序，最大100笔。抓取注单间隔不能小于15秒，否则系统不予处理。同时，由于供应商存在改注单及撤销情况，接入商需要对注单ID进行比对，及时对已存在注单进行更新。注：重点对撤销及改注单情况进行说明：如果接入商接收相同的注单且该注单在之前已经标记成功，那么需要单独进行处理。 a、2表示此局已经撤销，结果无效，如果接入商开始已经接收该笔注单，需要对该笔数据重新计算

43、 b、1，那么表示该注单已经重新计算过。接入商需要对该笔数据进行纠正。提醒：当调用完此接口，处理完相关业务后，务必及时调用2.2.12号接口对已成功取得的注单进行标记，否则下次调用该接口时，仍会返回之前的结果。使用场景固定周期抓取注单。调用此接口，可避免漏单，调用完此接口切记要调用2.2.12（标记结算/撤销注单）接口。命令标识符 11 参数及组合格式返回数据描述索引文本数据描述 0 Success 返回注单信息，格式如2.2.9 1 Fetch time is too sho

44、rt 抓取注单间隔太短操作步骤: a)调用2.2.11接口 b)客户端业务处理 c)提取出所有transaction_id d)调用2.2.12接口，提交这些transaction_id 2.2.12 标记结算/撤销注单[与2.2.11配对使用][核心接口] 操作描述此功能用来标记接入商已收到的注单。接入商在收到注单，并成功处理后，请务必调用该接口对注单进行标记，避免相同注单。最大处理100条。使用场景调用完2.2.11（获取结算/撤销注单）接口后。命令标识符 12 参数及组合格式 Ticket 1|[Ticket 2]|[Ticket 3]

45、注意：username此处无用，不作处理。例：19851|19856|20081 参数类型描述 Ticket Long 注单号，即transaction_id。返回数据描述例： 0Success3 3---Integer(指本次成功标记的数目。0表示提交的Ticket不存在，或之前已标记) 索引文本数据描述 0 Success 标记成功。 1 Fail

46、标记失败。 2.2.13 按时间查询已结算和已撤销注单数目操作描述此功能用来获取一段时间内的结算和撤销注单数目使用场景命令标识符 13 参数及组合格式 StartTime|EndTime 例：2011-01-31 19:25:34|2011-01-31 19:27:34 注意：username为空，查询所有会员注单数目信息；不为空，查询单个会员注单数目信息参数类型描述 StartTime Date 注单的开始时间，结算时间或撤消时间（包括此时间点） EndTime Date 注单的结束时间，结算时间或撤消时间（不包括此时间点）

47、返回数据描述例：0Success0000 格式： 5---Integer(注单总数目)

48、0---Integer(未结算注单数目) 4---Integer(已结算注单数目) 1---Integer(已撤消注单数目) 等式关系：total_count = uncalcuated_count + calcuated_count + canceled_count 此处：ncalcuated_count=0 索引文本数据描述 0 Success 返回注

49、单数目信息 2.2.14 按时间查询未结算注单数目操作描述此功能用来获取一段时间内的未结算的注单数目使用场景命令标识符 14 参数及组合格式 StartTime|EndTime 例：2011-01-31 19:25:34|2011-01-31 19:27:34 注意：username为空，查询所有会员注单数目信息；不为空，查询单个会员注单数目信息。参数类型描述 StartTime Date 注单的开始时间，下注时间（包括此时间点） EndTime Date 注单的结束时间，下注时间（不包括此时间点）返回数据描述等式关系：t

50、otal_count = uncalcuated_count + calcuated_count + canceled_count 此处：alcuated_count =0，canceled_count = 0 索引文本数据描述 0 Success 返回注单数目信息，格式如2.2.13 2.2.15按注单号查询未结算/已结算/已撤销注单操作描述此功能用来查询指定单号的注单信息。使用场景命令标识符 15 参数及组合格式 Ticket 1|[Ticket 2]|[Ticket 3] 注意：username此处无用，不作处理。例：19851

邮箱/手机：
温馨提示：	快捷下载时，用户名和密码都是您填写的邮箱或者手机号，方便查询和重复下载（系统自动生成）。如填写123，账号就是123，密码也是123。
特别说明：	请自助下载，系统不会自动发送文件的哦；如果您已付费，想二次下载，请登录后访问：我的下载记录
支付方式：
验证码：	换一换

账号：
密码：
验证码：	换一换
当日自动登录忘记密码？