转帐钱包文档

🔥 核心功能

提供用户登入、上分、下分、查询订单与余额等转帐钱包模式核心功能。

请求基本资讯

请求位置: {host}/channelHandle
HTTP 方法: GET

🔐 认证与加密

所有接口都需要进行认证与加密，详细的加密方式请参考：认证授权指南

💰 钱包模式说明

🔥 转帐钱包 / 单一钱包

代理后台可设定该代理的钱包模式，会影响登入接口 money 参数是否生效、以及运营商是否需要额外实作单一钱包接口：

转帐钱包：登入时依 money 参数将金额上分至 QK 棋牌内部钱包，之后游戏中的现金增减由 QK 直接处理，运营商不需要实作单一钱包文档中的接口。若玩家已在游戏中，也可另外呼叫转帐钱包上分接口(s:2) / 转帐钱包下分接口(s:3)随时上下分，不需要透过重新登入。
单一钱包：QK 棋牌与运营商共用同一份余额，登入接口的 money 参数不会生效（无需上分），每次下注/派彩会即时呼叫运营商依单一钱包文档实作的接口查询/异动余额。

无论哪一种钱包模式，代理余额都会同步增减：玩家现金上分（钱带入玩家户头）时扣除代理余额，玩家现金下分（下注/派彩）时加回代理余额。可透过查询代理余额接口(s:14)查询目前余额，代理余额不足时上分会失败。

📋 接口列表

游戏登入接口(s:0)

param 参数结构

参数名	类型	必填	描述
s	Integer	✅	操作子类型 (固定为 0)
account	String	✅	玩家账号 (64 位字符)
money	Number	✅	上分金额，若不携带分数请传 0。单一钱包模式无需使用上分，此参数无效（详见上方钱包模式说明）
orderid	String	✅	流水号，格式：代理编号 + yyyyMMddHHmmssSSS + account，长度不能超过 100 字符
ip	String	✅	客户端请求IP (玩家IP)，平台会以此更新玩家最后登入 IP
lineCode	String	❌	代理下的站点识别码，用于防止站点间导分。值自定义，长度 10 字符以内的英文或数字。请勿一个玩家一个 lineCode，平台仅在该玩家首次建号时写入，之后登入不会再更新
KindID	Integer	❌	游戏类型ID (参考游戏列表)，需注意命名，此参数开头字母为大写
currency	String	✅	币别 (参考支持币种清单)

响应参数说明

参数名	类型	描述
s	Integer	服务标识 (100=登入接口)
m	String	接口路径
d	Object	数据对象
d.code	Integer	响应码
d.url	String	游戏URL (登入成功时返回)

响应示例

成功

json

{
  "s": 100,
  "m": "/channelHandle", 
  "d": {
    "code": 0,
    "url": "https://ltg.com/index.html"
  }
}

失败

json

{
  "s": 100,
  "m": "/channelHandle", 
  "d": {
    "code": 15,
    "msg": "渠道验证错误"
  }
}

查询可下分接口(s:1)

param 参数结构

参数名	类型	必填	描述
s	Integer	✅	操作子类型 (固定为 1)
account	String	✅	会员账号
currency	String	✅	币别 (参考支持币种清单)

此接口用来查询玩家的币别钱包可下分余额。如果要查询玩家总额，可不使用此接口，直接使用查询玩家总分接口(s:7)。

响应参数说明

参数名	类型	描述
s	Integer	服务标识 (101=查询可下分接口)
m	String	接口路径
d	Object	数据对象
d.code	Integer	响应码
d.account	String	玩家账号
d.money	Float	可下分余额
d.currency	String	币别

响应示例

成功

json

{
  "s": 101,
  "m": "/channelHandle",
  "d": {
    "code": 0,
    "account": "10001_test01",
    "money": 100.01,
    "currency": "CNY"
  }
}

失败

json

{
  "s": 101,
  "m": "/channelHandle",
  "d": {
    "code": 15,
    "msg": "渠道验证错误"
  }
}

转帐钱包上分接口(s:2)

param 参数结构

参数名	类型	必填	描述
s	Integer	✅	操作子类型 (固定为 2)
account	String	✅	玩家账号 (需为已透过登入接口建号过的玩家)
money	Number	✅	上分金额
orderid	String	✅	流水号，格式：代理编号 + yyyyMMddHHmmssSSS + account，长度不能超过 100 字符
currency	String	✅	币别 (参考支持币种清单)

此接口用以为玩家帐号上分，仅限转帐钱包模式代理使用（详见上方钱包模式说明），单一钱包模式代理呼叫此接口会返回参数错误(45)。若未收到接口响应，请勿以相同 orderid 重复调用，请改用查询订单接口(s:4)确认此次上分是否成功。

响应参数说明

参数名	类型	描述
s	Integer	服务标识 (102=转帐钱包上分接口)
m	String	接口路径
d	Object	数据对象
d.code	Integer	响应码
d.money	Float	上分后可下分金额
d.currency	String	上分币种

响应示例

成功

json

{
  "s": 102,
  "m": "/channelHandle",
  "d": {
    "code": 0,
    "money": 100.00,
    "currency": "CNY"
  }
}

失败

json

{
  "s": 102,
  "m": "/channelHandle",
  "d": {
    "code": 15,
    "msg": "渠道验证错误"
  }
}

转帐钱包下分接口(s:3)

param 参数结构

参数名	类型	必填	描述
s	Integer	✅	操作子类型 (固定为 3)
account	String	✅	玩家账号 (需为已透过登入接口建号过的玩家)
money	Number	✅	下分金额，不要超过可下分数，见查询可下分接口(s:1)
orderid	String	✅	流水号，格式：代理编号 + yyyyMMddHHmmssSSS + account，长度不能超过 100 字符
currency	String	✅	币别 (参考支持币种清单)

此接口用以为玩家帐号下分，仅限转帐钱包模式代理使用（详见上方钱包模式说明），单一钱包模式代理呼叫此接口会返回参数错误(45)。若未收到接口响应，请勿以相同 orderid 重复调用，请改用查询订单接口(s:4)确认此次下分是否成功。

响应参数说明

参数名	类型	描述
s	Integer	服务标识 (103=转帐钱包下分接口)
m	String	接口路径
d	Object	数据对象
d.code	Integer	响应码
d.money	Float	下分后可下分金额
d.currency	String	下分币种

响应示例

成功

json

{
  "s": 103,
  "m": "/channelHandle",
  "d": {
    "code": 0,
    "money": 100.00,
    "currency": "CNY"
  }
}

失败

json

{
  "s": 103,
  "m": "/channelHandle",
  "d": {
    "code": 15,
    "msg": "渠道验证错误"
  }
}

查询订单接口(s:4)

param 参数结构

参数名	类型	必填	描述
s	Integer	✅	操作子类型 (固定为 4)
orderid	String	✅	流水号（即转帐钱包上分(s:2) / 转帐钱包下分(s:3)当时带的 orderid）

此接口用来查询玩家上下分的订单信息，通过 status 状态来判断上下分是否成功。若流水号不存在，或不属于呼叫方代理底下的玩家，一律回传 status:-1（不存在）。

响应参数说明

参数名	类型	描述
s	Integer	服务标识 (104=查询订单接口)
m	String	接口路径
d	Object	数据对象
d.code	Integer	响应码
d.status	Integer	状态码：`-1`不存在 / `0`成功 / `2`失败 / `3`处理中
d.money	Float	交易金额
d.currency	String	币别

响应示例

成功

json

{
  "s": 104,
  "m": "/channelHandle",
  "d": {
    "code": 0,
    "status": 0,
    "money": 100.00,
    "currency": "CNY"
  }
}

失败

json

{
  "s": 104,
  "m": "/channelHandle",
  "d": {
    "code": 15,
    "msg": "渠道验证错误"
  }
}

查询玩家在线状态接口(s:5)

param 参数结构

参数名	类型	必填	描述
s	Integer	✅	操作子类型 (固定为 5)
account	String	✅	玩家账号

响应参数说明

参数名	类型	描述
s	Integer	服务标识 (105=查询玩家在线状态接口)
m	String	接口路径
d	Object	数据对象
d.code	Integer	响应码
d.status	Integer	玩家状态：`-1`不存在 / `0`不在线 / `1`在线 / `2`封停

响应示例

成功

json

{
  "s": 105,
  "m": "/channelHandle",
  "d": {
    "code": 0,
    "status": 1
  }
}

失败

json

{
  "s": 105,
  "m": "/channelHandle",
  "d": {
    "code": 15,
    "msg": "渠道验证错误"
  }
}

查询玩家总分接口(s:7)

param 参数结构

参数名	类型	必填	描述
s	Integer	✅	操作子类型 (固定为 7)
account	String	✅	会员账号
currency	String	✅	币别 (参考支持币种清单)

此接口用来查询玩家的游戏内总分、玩家可下分余额、玩家在线状态。

响应参数说明

参数名	类型	描述
s	Integer	服务标识 (107=查询玩家总分接口)
m	String	接口路径
d	Object	数据对象
d.account	String	玩家账号
d.totalMoney	Float	总余额
d.freeMoney	Float	可下分余额
d.status	Integer	玩家状态：`-1`不存在 / `0`不在线 / `1`在线 / `2`封停
d.gameStatus	Integer	游戏状态：`0`不在游戏中 / `1`在游戏中
d.code	Integer	响应码

响应示例

成功

json

{
  "s": 107,
  "m": "/channelHandle",
  "d": {
    "account": "111111",
    "totalMoney": 100,
    "freeMoney": 80,
    "status": 0,
    "gameStatus": 0,
    "code": 0
  }
}

失败

json

{
  "s": 107,
  "m": "/channelHandle",
  "d": {
    "code": 15,
    "msg": "渠道验证错误"
  }
}

踢玩家下线接口(s:8)

param 参数结构

参数名	类型	必填	描述
s	Integer	✅	操作子类型 (固定为 8)
account	String	✅	会员账号

此接口用以将在线的玩家强制离线。

响应参数说明

参数名	类型	描述
s	Integer	服务标识 (108=踢玩家下线接口)
m	String	接口路径
d	Object	数据对象
d.code	Integer	响应码

响应示例

成功

json

{
  "s": 108,
  "m": "/channelHandle",
  "d": {
    "code": 0
  }
}

失败

json

{
  "s": 108,
  "m": "/channelHandle",
  "d": {
    "code": 15,
    "msg": "渠道验证错误"
  }
}

查询代理余额接口(s:14)｜非必要

param 参数结构

参数名	类型	必填	描述
s	Integer	✅	操作子类型 (固定为 14)

此接口用以查询代理余额，非必要接口，运营商可自行评估是否需要串接。

响应参数说明

参数名	类型	描述
s	Integer	服务标识 (114=查询代理余额接口)
m	String	接口路径
d	Object	数据对象
d.code	Integer	响应码
d.money	Float	代理余额

响应示例

成功

json

{
  "m": "/channelHandle",
  "s": 114,
  "d": {
    "code": 0,
    "money": 1000000.01
  }
}

失败

json

{
  "s": 114,
  "m": "/channelHandle",
  "d": {
    "code": 15,
    "msg": "渠道验证错误"
  }
}

📌 代码说明

📘 响应码说明

编码	描述
0	成功
1	TOKEN丢失
2	渠道不存在
3	验证时间超时
5	渠道白名单错误
6	验证字段丢失
7	TOKEN失效
8	不存在的请求
11	玩家账号不存在
15	渠道验证错误
16	资料不存在
20	账号禁用
22	DES解密失败
24	渠道拉取数据超过时间范围
27	数据库异常
28	IP禁用
36	KindID有误
41	拉取对局汇总统计时间范围有误
42	代理被禁用
43	拉单过于频繁
45	参数错误
46	时间范围错误
48	游戏维护中
49	语言有误
50	币别有误
52	该账号已列为黑名单
91	代理不存在
92	订单执行中
96	操作DB时发生错误
97	传入参数不合法
98	Call API时发生错误
99	未知的错误

转帐钱包文档 ​

请求基本资讯 ​

🔐 认证与加密 ​

💰 钱包模式说明 ​

📋 接口列表 ​

游戏登入接口(s:0) ​

param 参数结构 ​

响应参数说明 ​

查询可下分接口(s:1) ​

param 参数结构 ​

响应参数说明 ​

转帐钱包上分接口(s:2) ​

param 参数结构 ​

响应参数说明 ​

转帐钱包下分接口(s:3) ​

param 参数结构 ​

响应参数说明 ​

查询订单接口(s:4) ​

param 参数结构 ​

响应参数说明 ​

查询玩家在线状态接口(s:5) ​

param 参数结构 ​

响应参数说明 ​

查询玩家总分接口(s:7) ​

param 参数结构 ​

响应参数说明 ​

踢玩家下线接口(s:8) ​

param 参数结构 ​

响应参数说明 ​

查询代理余额接口(s:14)｜非必要 ​

param 参数结构 ​

响应参数说明 ​

📌 代码说明 ​

📘 响应码说明 ​

转帐钱包文档

请求基本资讯

🔐 认证与加密

💰 钱包模式说明

📋 接口列表

游戏登入接口(s:0)

param 参数结构

响应参数说明

查询可下分接口(s:1)

param 参数结构

响应参数说明

转帐钱包上分接口(s:2)

param 参数结构

响应参数说明

转帐钱包下分接口(s:3)

param 参数结构

响应参数说明

查询订单接口(s:4)

param 参数结构

响应参数说明

查询玩家在线状态接口(s:5)

param 参数结构

响应参数说明

查询玩家总分接口(s:7)

param 参数结构

响应参数说明

踢玩家下线接口(s:8)

param 参数结构

响应参数说明

查询代理余额接口(s:14)｜非必要

param 参数结构

响应参数说明

📌 代码说明

📘 响应码说明