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 或多字段拼接,顺序不能错 |
对接流程
- 开户与权限:拿到商户号、密钥与测试环境,确认开放了哪些产品线。
- 钱包打通:先做单笔扣加,跑通幂等与超时补偿。
- 游戏入口:换取游戏地址或 token,验证前台跳转与返回。
- 注单回传:接回调,同时准备定时拉单做补偿。
- 对账与压测:按天比对全量注单,晚高峰压一轮钱包接口。
04这一类接口最常见的坑
- 小数位不一致:你按分传,厂商按元收,一次就差一百倍,这类事故在 NG 类聚合接口里最常见。
- 回调丢失没人补:只靠回调不做定时拉单,网络一抖玩家的注单就悬着,最后变成客服工单。
- 重复派发:没有幂等键,重试一次就双倍上分,必须用 order_id 做唯一约束。
- 时区错位:注单时间是 UTC 还是 GMT+8,直接影响你按天统计的报表对不对得上。
这些坑的共同点是:接口能通、数据不对。上线前用真实注单跑一遍全量对账,比在测试环境调通十个接口更有价值。
05常见问题
NG 到底是单一厂商还是聚合系统?
业内通常按聚合系统理解:它把多条产品线打包成一个接入入口。具体包含哪些子产品线、每个子产品的规则,要以厂商下发的接口文档为准,不同批次开通的权限也不完全一样。
NG 接口要做免转还是转账?
看你站内钱包的承受能力。免转体验更好、玩家不感知钱包切换,但对钱包并发和稳定性要求高;转账实现简单,但必须配套额度回收。多数站的做法是主力产品线走免转,长尾产品走转账。
接 NG 大概要多久?
单条产品线跑通(开户、进游戏、注单回传)通常几天;把回调补偿、对账、异常重试都做扎实,一般按两到三周排期比较现实。
注单对不上怎么办?
先分清是回调丢还是字段错。做法是每天按时间段拉一次注单明细,与本地下注记录做全量比对,差异单独进人工池,不要直接冲账。
06其他厂商接口
NG 接口可以单独接入,也可以与其他厂商一起走统一网关——字段、签名、回调全部封一层,前台只认一套协议。