API文档周一送到，您的开发人员说两周就能完成。六周后，游戏终于能加载了。随后发现有几笔回滚从未到达钱包。财务无法对上第一个月的账，监管机构还要一份没人安排过的测试报告。
大多数集成延误并不是API本身造成的，而是源于规划：缺人、缺测试用例、文书工作滞后。本文把iGaming API集成当作一个项目来对待。关于技术如何运作，请参阅 iGaming平台中的API集成是如何运作的.
需要哪些人参与
| 角色 | 负责内容 |
|---|---|
| 后端开发 | 钱包接口、身份验证、错误处理 |
| 前端开发 | 游戏启动、大厅、移动端表现 |
| 测试人员 | 测试用例、边界情况、回归测试 |
| 财务 | 将投注、派彩和回滚与供应商报表进行对账 |
| 合规 | 认证、市场限制、负责任博彩工具 |
| 供应商客户经理 | 凭证、环境、游戏列表、支持联系人 |
小型运营商往往一人兼任多个角色。只要确保开工前每一项都有明确的负责人即可。
第一阶段：范围与文书
确定纳入范围的供应商、游戏和市场。然后逐个市场检查内容是否在当地获得认证。在英国，新游戏和随机数生成器必须在发布前由获批的测试机构测试。巴西要求线上游戏由体育博彩与奖品秘书处认可的实验室认证，使用第三方技术的运营商还必须提交集成证书。尽早着手，可以避免最常见的后期延误。
第二阶段：先搭建钱包
几乎所有娱乐场游戏API都依赖几个钱包调用：查询余额、扣款（下注）、入账（派彩）和回滚（撤销投注或派彩）。公开的供应商文档在两点上是一致的：这些方法必须具备幂等性，即使用同一交易ID的重复请求不能让资金变动两次；入账请求也可能被反复重发，直到您的系统确认为止。
先搭建并测试这些调用，再做其他事情。游戏显示得再漂亮，如果钱包会重复派彩，还不如没有游戏。尽早决定使用哪种钱包模式。采用无缝钱包时，投注直接从玩家余额中扣除；采用转账钱包时，资金先转入供应商的系统。我们关于 赌场游戏API的运作方式 的文章对两者进行了比较。
第三阶段：游戏启动、大厅与游戏列表
接下来是游戏启动（创建会话并打开游戏）、游戏列表数据源和您的大厅。请在玩家实际使用的设备上测试，而不仅仅是桌面浏览器。检查在某个市场被屏蔽的游戏，是否真的对该市场的玩家隐藏。
第四阶段：测试
为失败情况编写测试用例，而不仅仅是正常流程：
- 使用同一交易ID的重复扣款和入账请求
- 超时后才到达的入账
- 回滚一笔从未记录的投注
- 游戏打开期间玩家自我排除或超出限额
- 游戏回合中途会话过期
- 小额投注的货币和舍入问题
然后让财务把一整天的测试交易与供应商报表对账。如果在测试环境中总数对不上，到了生产环境也对不上。
第五阶段：上线检查清单
- 认证和市场批准已书面确认
- 生产环境凭证已安全存储，并与测试环境的凭证区分更换
- 钱包调用已设置监控，并对错误和延迟发出告警
- 上线第一个月每天安排对账报表
- 客服团队已了解如何查询游戏回合或交易
- 游戏内的负责任博彩限额已测试
- 已与供应商商定出问题时的回退方案
需要多长时间
没有一个诚实的统一答案。时间取决于您是集成单个工作室还是游戏聚合商，以及您的钱包有多成熟。各市场的认证可能比写代码耗时更长。一次聚合商集成可以替代许多个独立项目，这也是大多数运营商用聚合商获取主要内容的原因。我们关于 Gamingsoft的API聚合服务 的指南解释了这种模式。
常见问题
集成延误最常见的原因是什么？
规划漏洞，而非代码问题。认证启动太晚，没人为失败情况编写测试用例，或财务直到上线后才参与。
可以同时在所有市场上线吗？
只有在每个市场的内容都已认证并获批时才可以。随着批准陆续下来，逐个市场上线是常见做法。
为什么幂等性很重要？
因为网络会重试。没有幂等性，一次重复的扣款或入账请求就可能扣两次钱或付两次钱。
把API集成当作一个有负责人、有阶段、有检查清单的项目，大部分意外都会消失。先搭建钱包，测试失败情况，尽早启动认证，在扩大规模前先完成对账。
Gamingsoft持续扩展游戏工作室合作网络，因此我们平台上的运营商始终能拿到新鲜、高质量的内容，而无需在自己这边做任何额外对接。我们引入的每一家新供应商都要经过严格的品质与合规审核。如果您希望在提供成熟开发商经典大作的同时，第一时间上架最新游戏，Gamingsoft就是您需要的聚合伙伴。欢迎联系我们，看看您的平台还能有哪些可能。
