文档 / 游戏流程

游戏 API 流程

从玩家验证和游戏启动,到投注、赢款、游戏回合、操作取消及财务对账的完整流程。

游戏 API 集成
会话
玩家与游戏启动
余额
投注与赢款
回合
游戏会话流程
取消
操作恢复
游戏生命周期

从启动到回合结束

01
创建游戏会话

玩家、游戏、货币、语言、国家、模式及返回 URL。

02
启动游戏

临时访问密钥、启动 URL 及游戏可用性检查。

03
处理金融操作

余额查询、投注、赢款、组合操作及平台响应。

04
结束并对账回合

最终结果、取消、财务账本及提供商报表。

概览

游戏 API 关联玩家、回合及资金变动

游戏启动和资金变动是同一流程的不同部分。会话标识玩家及启动条件,回合关联提供商操作,平台 API 则确认每笔扣款、入账及取消。

游戏会话数据

玩家、品牌、游戏、货币、国家、语言、模式、司法辖区及访问过期时间。

余额控制

平台检查可用资金,并确保每笔投注、出款或取消仅执行一次。

游戏财务账本

保留操作和回合标识符、操作类型、金额以及操作前后余额,用于控制和对账。

游戏启动

典型游戏启动流程

平台先验证玩家及游戏可用性,然后创建限时会话,并从提供商获取启动 URL。

01

验证玩家及游戏可用性

平台检查账户状态、货币、国家、限制、限额、真钱或试玩模式及游戏可用性。

02

创建内部会话

创建包含玩家、游戏、品牌、货币、语言、IP 及过期信息的会话标识符。

03

获取游戏启动 URL

向提供商发送会话密钥、通知和返回 URL、设备类型、司法辖区及界面参数。

04

在浏览器中打开游戏

玩家打开返回的 URL,后续金融操作则由服务器之间直接处理。

余额操作

核心余额操作

不同提供商的方法名称可能不同,但逻辑一致:余额查询、投注扣款、赢款入账及取消此前确认的操作。

余额查询

返回当前会话货币下玩家的可用余额,不修改财务账本。

投注扣款

验证玩家、会话、货币及可用资金后,仅扣除一次已确认投注金额。

赢款入账

使用唯一操作和回合标识符将赢款入账,包括零结果。

单次请求处理投注与结果

当提供商支持该模式时,在同一请求中处理投注和游戏结果。

操作取消

为此前确认的投注或出款创建单独更正操作,不删除原始记录。

奖金与免费旋转

传递奖金活动和游戏回合数据,同时区分真钱资金和奖金资金。

货币与金额精度

每笔操作都会验证货币、金额单位、小数位及舍入规则。

平台响应

返回操作状态、内部标识符、当前余额及统一错误码。

回合生命周期

游戏回合生命周期

一个回合可能包含多笔投注和结果,其状态由游戏规则决定,而不仅取决于网络请求顺序。

回合已创建

平台首次收到回合标识符并创建内部记录。

回合进行中

回合中可能包含额外投注、游戏操作及中间赢款。

投注已接受

扣款由平台确认,并关联提供商的唯一操作标识符。

已收到结果

已收到赢款或零结果,但根据游戏规则,回合仍可能保持开放。

回合已结束

提供商已确认回合结束,所有预期金融操作均已处理。

操作已取消

一个或多个操作已完成更正,同时保留完整原始历史。

一个回合可包含多笔操作

回合标识符不能作为唯一幂等键。每笔投注、出款及取消都应有自己的唯一标识符。

可靠性与对账

防重复与财务对账

游戏 API 必须安全处理重复请求、响应延迟、乱序操作以及提供商故障恢复。

安全的重复处理

每类金融操作均使用唯一的提供商操作标识符。
重复请求返回原始结果和当前余额,不再次移动资金。
若使用相同标识符但金额、货币或玩家不同,则作为数据冲突拒绝。
取消操作引用特定原始操作,同时也获得自身唯一标识符。

回合账本与对账

保存会话、回合、提供商操作及平台操作标识符。
记录操作类型、金额、货币、操作前后余额及处理时间。
不要修改已入账记录,应创建单独更正操作。
对账提供商报表、游戏回合、余额变动、GGR 及已发现差异。
测试

测试环境中需要测试的内容

检查应覆盖游戏启动、玩家限制、余额不足、重复操作、响应延迟、取消及已结束回合的对账。

启动与游戏会话

真钱与试玩模式、无效货币、禁止国家、访问过期及游戏不可用。

余额与投注拒绝

资金不足、玩家被阻止、货币不匹配及超出限额。

延迟与未知结果

提供商在实际已经扣款后未收到响应,并使用相同标识符重新发送操作。

重复投注与赢款

相同标识符在处理完成前或完成后再次到达,包括参数冲突的情况。

操作取消

投注取消、赢款取消、重复取消以及引用未知原始操作。

回合对账

投注、赢款和取消金额、最终状态、余额变动及提供商报表必须一致。

上线前检查清单

在验证游戏会话、余额操作、防重复、取消及报表后,才能上线游戏启动流程。

测试和生产环境使用不同的访问凭据、API 端点及启动设置。
游戏会话密钥具有有效期,并与玩家、游戏、货币及品牌绑定。
每笔余额操作均由唯一提供商标识符保护。
重复投注、赢款及取消不会再次改变余额。
已入账记录不会被删除,而是通过单独调整操作进行更正。
已配置事件日志、告警、提供商报表及回合对账流程。

需要配置游戏 API 流程?

请提供提供商文档、余额操作列表、游戏回合模型、货币及报表要求。APIACE 将帮助梳理游戏启动、投注、赢款、取消及财务对账。