VIX APIVIXAPI 申请测试账号
首页 / 厂商接口 / CQ9 接口
CQ9 API · INTEGRATION

CQ9 接口对接
电子与捕鱼一起接

CQ9 的产品结构和 JDB 有重叠,但接口细节不同。同时接两家时,最省事的做法是先封一层统一网关。

电子游艺捕鱼免转钱包统一网关

01CQ9 接口是什么

CQ9 在电子游艺与捕鱼都有产品,接口文档以字段清晰著称。它的游戏数量多,前台大厅如果不分组,玩家会在列表里迷路。

同时接 CQ9 与 JDB 这类厂商时,真正的成本不在对接本身,而在维护:每家一套签名、一套字段、一套错误码。封一层统一网关之后,前端只认一套协议,后面再加厂商就是加配置,不是改代码。

02三种接入方式

电子游艺

老虎机、消除类,按品类分组呈现。

捕鱼类

多人同场,按局聚合对账。

统一网关

把多家厂商的签名、字段、错误码封成一套,前端只认一套。

03对接需要准备的字段

下面是最小字段集。字段命名各家不同,但语义基本固定——先把这张表填完,再去对厂商文档,能省掉一半来回。

字段说明
account玩家账号
gamehall / gamecode大厅与游戏编码
lang语言
bet / win投注额与派彩额
serial_number流水号,对账主键

对接流程

  1. 开户与权限:拿到商户号、密钥与测试环境,确认开放了哪些产品线。
  2. 钱包打通:先做单笔扣加,跑通幂等与超时补偿。
  3. 游戏入口:换取游戏地址或 token,验证前台跳转与返回。
  4. 注单回传:接回调,同时准备定时拉单做补偿。
  5. 对账与压测:按天比对全量注单,晚高峰压一轮钱包接口。

04这一类接口最常见的坑

  • 错误码没映射:每家错误码不同,前端直接弹厂商原文,玩家看不懂。
  • 游戏图标不缓存:每次打开大厅都重新拉图,首屏慢一倍。
  • 没做可用性兜底:某家厂商维护时整块大厅空白。
  • 签名算法抄错顺序:字段排序错一个位置就一直验签失败。

这些坑的共同点是:接口能通、数据不对。上线前用真实注单跑一遍全量对账,比在测试环境调通十个接口更有价值。

05常见问题

CQ9 和 JDB 同时接会不会冲突?

不会,但建议封统一网关。两家签名和字段都不一样,前端直连的话每加一家都要改前端,长期维护成本高。

游戏数量多,大厅怎么排?

按品类分组(电子、捕鱼、热门、新上),加搜索和最近玩过。别用一个长列表铺到底。

厂商维护时怎么办?

接口要做可用性检测,某家不可用时前端把该分类置灰并提示,而不是让玩家点进去报错。

注单能实时拉吗?

可以按时间段拉,注意单次条数限制。对账建议按小时分段,别一次拉一整天。

06其他厂商接口

CQ9 接口可以单独接入,也可以与其他厂商一起走统一网关——字段、签名、回调全部封一层,前台只认一套协议。

先拿一个测试账号,验证完再决定

提供CQ9 接口的测试环境、接口文档与联调支持,7×24 技术值守。验收标准你来定:字段对不对、结算准不准、晚高峰扛不扛得住。