01PG 接口是什么
PG(PG Soft)是电子游艺里辨识度最高的品牌之一,产品以竖屏老虎机为主,画面和动效做得重,这也是它对网络和机型比较挑的原因。
接口层面 PG 相对清爽:主流是免转钱包加 token 换取游戏地址,字段不多,但每一处都跟体验挂钩。游戏编码选错了,玩家点进去是个空大厅;token 有效期设置太短,玩到一半被踢出来。
02三种接入方式
免转钱包 + token
用 token 换游戏地址,余额在站内实时扣加。接入最快的主流方式。
H5 直连
直接跳厂商 H5,不涉及钱包对接,适合先试水或做活动页。
游戏列表接口
拉取可用游戏、分类、图标,用于自建大厅与推荐位。
03对接需要准备的字段
下面是最小字段集。字段命名各家不同,但语义基本固定——先把这张表填完,再去对厂商文档,能省掉一半来回。
| 字段 | 说明 |
|---|---|
token | 一次性或短时效凭证,换取游戏地址用,有效期不宜过长 |
game_code | 游戏编码,每家产品线编码规则不同 |
language | 语言,简繁英要分别确认支持 |
currency | 币种,影响显示金额与充值面额 |
platform | 终端类型:web / h5 / app |
bet_id | 下注单号,用于对账与异常追溯 |
对接流程
- 开户与权限:拿到商户号、密钥与测试环境,确认开放了哪些产品线。
- 钱包打通:先做单笔扣加,跑通幂等与超时补偿。
- 游戏入口:换取游戏地址或 token,验证前台跳转与返回。
- 注单回传:接回调,同时准备定时拉单做补偿。
- 对账与压测:按天比对全量注单,晚高峰压一轮钱包接口。
04这一类接口最常见的坑
- 竖屏没做适配:PC 端正常,手机上被裁切,直接损失大部分流量。
- 图标资源用原图:几十张高清图一起加载,首屏等到怀疑人生,必须压缩加懒加载。
- token 复用:同一 token 多次换地址,轻则报错重则风控。
- 游戏编码硬编码在前端:厂商调整编码后要重新发版,应该走配置接口。
这些坑的共同点是:接口能通、数据不对。上线前用真实注单跑一遍全量对账,比在测试环境调通十个接口更有价值。
05常见问题
PG 接口对服务器有什么要求?
它本身不在你服务器上跑,你的服务器只承担 token 换取、钱包扣加和游戏列表缓存。压力主要来自游戏列表和图片,做好 CDN 与缓存基本够用。
手机上老是加载不出来怎么办?
先看是不是首屏图片没压缩、是不是没做懒加载;再看线路,电子游艺对延迟敏感,国内访问建议配就近节点。
游戏编码会变吗?
厂商调整产品线时会变,所以不要硬编码。用游戏列表接口拉,前端按分类渲染,改动只需要更新缓存。
注单数据能实时拿到吗?
免转模式下注单一般准实时回传,但结算结果可能有延迟。对账按时间段拉明细,不要假设即时。
06其他厂商接口
PG 接口可以单独接入,也可以与其他厂商一起走统一网关——字段、签名、回调全部封一层,前台只认一套协议。