Skip to content

接入流程 ​

由管理员开通对应的 CP 账号。CP 用用户名和密码登录 CP 后台,按下面顺序做完:创建游戏 → 绑定渠道 → 技术接入(接入清单全过)→ 提交验收 → 管理员验收通过后上线。

总体流程 ​

管理员CPKeepSDK开通1开通账号用户名 / 密码2登录 CP 后台接入3创建游戏4app_id / 密钥只展示一次5绑定渠道、填游戏地址6测接入清单7提交验收验收 / 上线8待验收9通过10同步线上地址玩家和订单才出网

管理员驳回后,CP 改完清单再提交。已通过后若打回,线上地址不会改,等改完重新验收。

创建游戏 ​

登录 CP 后台 新建游戏。类型只有 页游 web / 端游 pc / H5 h5。名称、类型、app_id 创建后不可改。创建成功后会拿到:

项说明
app_id游戏标识,如页游 lmyxweb、端游 lmyxpc
login_key登录、查角色、聊天、打点、开服等
pay_key下单、发货、礼包

login_key、pay_key 只展示一次,请立刻保存,遗失只能重置。

绑定渠道 ​

在 CP 后台 我的游戏 中,选当前游戏操作里的 渠道。只能绑与当前游戏类型对应的渠道;端游还可以绑插件渠道。

我的游戏 · 渠道绑定

点右上角 新建绑定。

新建绑定

选择要加的渠道。每个渠道的参数要到对应渠道后台去取,填进表单后保存即可。

填写渠道参数

保存后页面会列出 渠道回调 URL(登录、支付通知、查角色,以及该渠道有的封禁 / 礼包 / 拉区服)。把这些 URL 交给渠道,不要把游戏自己的 login_url 填给渠道。停用绑定后,这条渠道不再出网。

绑了哪些渠道,会决定接入清单里要测哪些项。先绑渠道,再按清单接接口。

技术接入 ​

在游戏的 接口 里填写 KeepSDK 打你的地址,并按文档实现。默认必接登录、发货、查角色;绑定渠道若还要用礼包、封禁、拉区服,清单会把对应地址列为必测。

地址说明
login_urlKeepSDK 把玩家交给你
deliver_url付款完成后 POST 发货
role_url查角色时 POST 问你
gift_url发礼包
server_url拉区服列表
ban_url封号 / 禁言 / 踢人

游戏服还要按清单去调网关:聊天审核、打点、平台VIP信息、平台VIP收益等,见侧栏「调用网关」。区服只接 server_url。

接入清单 ​

在 我的游戏 里找到当前游戏,点操作列的 接入,下拉里选 接入清单。按清单把每一项都测到「通过」,再点同一下拉里的 提交验收。清单未全部通过时不能提交。

接入清单

清单分两块:

块怎么过
回调地址在「接口」里保存地址并点测试。KeepSDK 打你的 URL,成功勾上
主动调用游戏服真实 POST /game/chat、/game/report 等正式接口,验签成功自动勾上

清单里出现的项以已绑定渠道为准。特权入口是客户端能力,后台不测、不挡提交。待验收或已通过时不能改地址,需要管理员驳回后再改。

管理员验收 ​

提交后状态变为 待验收。管理员在运营后台复核必接接口,通过或驳回。

  • 通过:联调地址同步为线上地址,KeepSDK 才会把玩家和订单打到游戏服
  • 驳回:回到可修改,清单不过或地址不对时改完再提交

上线 ​

验收通过即上线。渠道侧使用绑定页上的回调 URL;游戏侧继续用本文档的登录、支付、发货。下面是上线后玩家进服和充值的时序。

页游 ​

落地页就要引入 keepsdk-web.js,不要等点充值再加载。脚本说明见 支付。端游见 客户端 SDK、打包。

玩家渠道KeepSDK游戏服登录1打开游戏2登录3302 login_urlquery 已签名4验签、建会话、进服充值5KeepSDK.pay游戏服用 pay_key 签单6拉起支付7支付成功8POST deliver_url发货

H5 ​

登录参数与页游相同。页面本地 init → login(keepsdk-h5.js,不打网关),再把参数交给游戏服验签进服。

玩家渠道KeepSDK游戏服登录1打开游戏2登录3302 login_urlquery 已签名4init / login本地调 keepsdk-h5.js5登录参数6验签、建会话、进服充值7KeepSDK.pay游戏服用 pay_key 签单8拉起支付9支付成功10POST deliver_url发货

端游 ​

端游走 KeepSDK.dll:KeepSDK_Init → KeepSDK_Login → GetSession / KeepSDK_Pay。登录细节见 登录。

玩家渠道KeepSDK游戏服登录1大厅打开游戏2登录3KeepSDK_Login4GET login_url参数已签名5验签,按需回 ticket6GetSession客户端建会话、进服充值7KeepSDK_Pay游戏服签好 JSON8拉起支付9支付成功10POST deliver_url发货