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

JDB 接口对接
街机与捕鱼这条线

JDB 的强项在街机与捕鱼,这类游戏的注单结构和普通老虎机不一样:一局里有多轮开火、多个结算点。

电子游艺捕鱼街机注单回传

01JDB 接口是什么

JDB 在电子与街机品类的辨识度主要来自捕鱼类产品:多人同场、实时开火、按炮值结算。这决定了它的注单不是一局一条,而是按子弹或按结算周期汇总。

如果你的对账逻辑是照老虎机写的——一局一条记录、赢或输一个数——接捕鱼就会出错。要么按厂商给的汇总口径入库,要么自己按局号做聚合,两条路都要提前定。

02三种接入方式

电子游艺

常规老虎机类,注单结构简单,一局一条。

捕鱼类

多人同场,按炮值与命中结算,注单需要按局聚合。

街机类

节奏快、频次高,对钱包接口的响应时间更敏感。

03对接需要准备的字段

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

字段说明
user_id玩家标识
game_type游戏类型:电子 / 捕鱼 / 街机
room_id房间号,捕鱼类必填
bet_amount投注额,捕鱼类通常是炮值累计
payout派彩额
round_id局号,聚合对账的主键

对接流程

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

04这一类接口最常见的坑

  • 用老虎机的口径接捕鱼:注单条数对不上,月底差一大截。
  • 高频开火把钱包打挂:一秒多次扣款,接口没做批量或缓冲就等着报错。
  • 房间配置写死:不同炮值对应不同房间,配置化才能按会员等级分配。
  • 没做单局上限:捕鱼类容易出大额,风控阈值要单独设。

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

05常见问题

捕鱼类的注单为什么对不上?

因为它的结算粒度不是“一局一次输赢”,而是按开火与命中累计。要按厂商给的 round 维度聚合,否则条数和金额都会错。

高频扣款扛不住怎么办?

两种做法:一是钱包侧做合并扣款,二是接口做异步缓冲。前者口径清楚,后者实现快但对账要额外处理。

可以只接电子不接捕鱼吗?

一般可以按模块授权。如果你担心对账复杂,先接电子跑通,再单独排捕鱼的开发。

JDB 在手机上表现如何?

捕鱼类对触控和帧率敏感,建议在低端机上实测一遍,别只看旗舰机效果。

06其他厂商接口

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

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

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