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

NG 接口对接
NG API 一次接完

NG 在业内通常不指某一家单一游戏厂商,而是一套把真人、电子、棋牌、体育打包输出的系统。接 NG,接的其实是它背后的多条产品线。

免转钱包转账钱包H5 直连注单拉取回调签名

01NG 接口是什么

NG 是亚洲区出现频率很高的一个系统代号。你在群里看到的“NG 接口”“NG API”“NG 包网”,说的多半是同一件事:一家把多厂商游戏聚合起来、再以统一接口对外输出的系统商。它自己不一定是游戏原厂,更多是把上游产品打包成一个入口。

这一点决定了 NG 的对接方式和单一厂商不一样。单一厂商你只需要对他的钱包和注单;NG 这种聚合层,你要同时对多个产品线的钱包、多个币种的小数位、多套注单字段。字段不统一,是 NG 类接口最常见的坑。

02三种接入方式

免转钱包(Seamless)

玩家余额留在你的站内,NG 只做游戏渲染与结果回传。接入快、体验顺,但你的钱包接口必须扛得住游戏过程中的高频扣加。

转账钱包(Transfer)

玩家进入游戏时把额度转到 NG 侧钱包,退出时转回。对站内钱包压力小,但要做额度回收任务,避免玩家退出后余额留在厂商侧。

H5 直连 / 大厅

直接跳厂商大厅或单游戏 H5,适合先小范围验证某条产品线,再决定要不要做钱包级对接。

03对接需要准备的字段

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

字段说明
member_id / username你的玩家唯一标识,一旦上线不要再改编码规则
currency币种代码,NG 系通常要求与你的站内币种严格一致
amount / credit金额,注意小数位,多数厂商接受两位小数
order_id你方订单号,用于幂等与对账,必须全局唯一
game_code / lobby要进入的游戏或大厅编码,由厂商文档给出
callback_url结果回调地址,必须公网可达且能扛住并发
sign签名串,算法一般是 md5 或多字段拼接,顺序不能错

对接流程

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

04这一类接口最常见的坑

  • 小数位不一致:你按分传,厂商按元收,一次就差一百倍,这类事故在 NG 类聚合接口里最常见。
  • 回调丢失没人补:只靠回调不做定时拉单,网络一抖玩家的注单就悬着,最后变成客服工单。
  • 重复派发:没有幂等键,重试一次就双倍上分,必须用 order_id 做唯一约束。
  • 时区错位:注单时间是 UTC 还是 GMT+8,直接影响你按天统计的报表对不对得上。

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

05常见问题

NG 到底是单一厂商还是聚合系统?

业内通常按聚合系统理解:它把多条产品线打包成一个接入入口。具体包含哪些子产品线、每个子产品的规则,要以厂商下发的接口文档为准,不同批次开通的权限也不完全一样。

NG 接口要做免转还是转账?

看你站内钱包的承受能力。免转体验更好、玩家不感知钱包切换,但对钱包并发和稳定性要求高;转账实现简单,但必须配套额度回收。多数站的做法是主力产品线走免转,长尾产品走转账。

接 NG 大概要多久?

单条产品线跑通(开户、进游戏、注单回传)通常几天;把回调补偿、对账、异常重试都做扎实,一般按两到三周排期比较现实。

注单对不上怎么办?

先分清是回调丢还是字段错。做法是每天按时间段拉一次注单明细,与本地下注记录做全量比对,差异单独进人工池,不要直接冲账。

06其他厂商接口

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

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

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