什么是赌场游戏聚合器？
赌场游戏聚合器（也常被叫作“赌场聚合器”或“游戏 API 接口平台”）把几十上百家游戏工作室的接入、版本更新和结算统一起来，运营商只对接一次，就能拿到老虎机、真人视讯、捕鱼、Crash 类小游戏和体育投注。你的平台负责玩家账户和资金，聚合器负责游戏本身。想先了解整体架构，可以看我们的赌场游戏聚合器 API 总览。
SoftAggregator 就是这样一个聚合器：一个 API 接口、一个单一钱包（seamless wallet）协议，公开目录有 40,000+ 款游戏、200+ 家工作室。下面的内容不讲概念，只讲一个中文运营商在签约前最常问、也最容易踩坑的地方。
人民币支持：原生币种，按币种返回目录
简短回答：CNY 是原生币种。原生币种包括 CNY，以及 USD、EUR、JPY、KRW、THB、VND、IDR、PHP、MYR、SGD 等；老虎机、真人视讯和体育三条产品线都可以用人民币开玩家账户，游戏内的余额和限红直接按人民币显示，你不需要在自己这边做汇率换算。
每家工作室会为每种货币单独配置限红和余额显示，所以我们让系统替你整理目录：门户（Integration → Player currency）和 getCurrencies 接口列出你账户已开通的币种，getGameList 按币种返回对应的游戏。你拿到的 CNY 目录，就是玩家能直接打开的 CNY 游戏。
如果你需要的币种不在原生列表里，账户可以按 USD（或 EUR）运行，由你在充值提现时自行换算；有具体币种需求，欢迎直接联系我们。游戏目录和币种在持续更新，最新清单以 API（getCurrencies / getGameList）返回为准。
一张表看清中文市场的接入条件
内容来自我们自己的系统和公开的 API 文档，截至 2026 年 9 月 24 日。
| 项目 | SoftAggregator（截至 2026-09-24） | 接入时你要确认的 |
|---|---|---|
| 玩家币种 | CNY 原生支持；其他币种可按 USD 或 EUR 运行 | 钱包的记账币种和传给我们的 currency 一致 |
| 游戏目录 | getGameList 按币种返回 CNY 目录 | 按 game_type 搭建中文大厅 |
| 钱包模式 | 单一钱包：balance / debit / credit 回调 | 回调地址能在高峰期稳定响应 |
| 回调方法 | 仅 GET，query 参数，md5(timestamp + salt_key) 签名 | 验签、30 秒时间窗、call_id 幂等 |
| 金额单位 | 整数，单位为“分”（2.50 → 250） | 数据库字段用整数，不要用浮点 |
| 玩家所在地 | 按 getGame 的 country 自动匹配各工作室的可用范围 | 真实资金启动时始终传 country |
| 语言 | getGame 的 lang 参数 | 为大厅准备中文游戏名和分类 |
| 对账 | getPlayerHistory（单个玩家，≤500 条，UTC）+ 月度报表 | 按 call_id 自建流水表 |
中文玩家在意什么：真人百家乐、老虎机、体育和手机
中文玩家的习惯和欧洲、拉美差别很大。真人视讯里，百家乐通常是流水最大的品类，龙虎、骰宝、轮盘跟在后面；玩家看重开牌速度、路单是否清楚、桌台限红是否覆盖从小额到高额的区间。我们的真人视讯 API覆盖轮盘、21 点、百家乐、龙虎和游戏秀类桌台，各工作室提供多档限红的桌台，限红按玩家币种显示。
老虎机方面，中文玩家偏好节奏快、带“购买免费游戏”（feature buy）和倍数玩法的产品，也有相当一部分玩家喜欢捕鱼类游戏。getGameList 返回的 game_type 字段是我们统一过的分类（slots、live、crash、table、fishing、sportsbook 等），你可以直接用它搭大厅，不用处理各家工作室五花八门的原始分类。
体育方面，足球是绝对的主力，五大联赛和亚洲赛事都有稳定的需求；电竞（英雄联盟、DOTA 2、CS 等）在年轻玩家里增长很快。我们的体育投注 API支持足球、篮球、网球、电竞等赛前和滚球盘口，走的是同一个单一钱包。
最后是手机。中文玩家绝大多数在手机上下注，很多是通过内嵌浏览器打开。getGame 支持 device=mobile，有些游戏平台如果不声明设备会直接拒绝启动，所以我们建议在手机端的每一次启动都明确传 device。
一个聚合器至少要给你这六样东西
不管你最终选谁，下面六点缺一不可。我们把自己在每一点上的实际情况写在后面，方便你拿去和别家对比。
- 一个 API 接口：所有方法（取游戏列表、建玩家、启动游戏、查历史）都发到同一个地址
https://api.softaggregator.com/api/v1，POST + JSON。 - 单一钱包：玩家的钱留在你的平台，我们每次查余额、扣注、派彩都回调你。你不需要给我们预存玩家资金。
- 本地货币：CNY 作为玩家币种，余额和限红在游戏里按人民币显示。
- 中文大厅：启动参数 lang 控制游戏语言；大厅本身由你来做，我们提供统一的分类、工作室名称和 logo（logo 由我们自己的 CDN 提供）。
- 响应迅速的支持：通过 Telegram（@mentionso）和邮件（[email protected]）直接对接技术团队，接入期间的问题由懂接口的人跟进。
- 回调规则写清楚：GET 回调、签名算法、错误码、幂等字段都在文档里，不靠口头约定。
中文运营商选择 SoftAggregator 的理由
一句话：对接一次，目录一直在长。接口只有一个，回调只有三个；之后我们新增的工作室和新游戏会直接出现在 getGameList 里，你的技术团队不用再写一行对接代码。
- 人民币原生显示：余额和限红都是人民币，玩家不用心算汇率，客服也少了一类咨询。
- 一个钱包走全部产品：玩家在老虎机赢的钱可以直接去真人百家乐或足球下注，余额只有一份，流失更少。
- 统一的游戏数据：game_type、工作室名称和 logo 格式一致，中文大厅从设计到上线的时间大幅缩短。
- 多站点一个账户：同一账户下为每个品牌单独配置密钥、回调地址和默认币种，额度、目录和报表共用。
- 试玩模式：getGameDemo 不需要真实资金，适合做注册前的游戏展示，提升注册转化。
大厅怎么排也有讲究：首页放真人百家乐和热门老虎机，体育页放当天的五大联赛和电竞赛事，捕鱼单独一栏。这些分栏直接用 game_type 就能分好。
单一钱包回调：中文技术团队最常问的细节
我们的回调只有三种 action：balance（查余额）、debit（扣注）、credit（派彩）。所有回调都是 GET 请求，你的接口必须返回 HTTP 200，业务错误写在 JSON 里：0 表示成功，1 表示余额不足（同时返回当前余额），2 表示处理失败、签名错误或玩家不存在。
GET {你的回调地址}?username=player123¤cy=CNY&action=debit
&amount=1000&type=bet&round_id=...&game_id=...
&call_id=...×tamp=...&rb=0&key=...
← {"error":0,"balance":88800}上面这一笔表示扣 10.00 元：金额一律是整数，单位是“分”。实际对接时有三条规则最容易出错：
- 只按 action 分支，不按 type 拒单。type 只是说明字段，随着新工作室接入会出现新值，遇到不认识的 type 当普通下注或派彩处理。
- credit 可以没有对应的 debit。免费旋转、奖励回合和彩池派奖只有派彩没有下注，如果你要求先有扣注才能派彩，玩家就拿不到这部分奖金。
- 用 call_id 去重。同一个 call_id 重复到达时返回第一次的结果，不要重复加减余额。rb=1 表示回滚，按普通 debit/credit 处理即可。
生产环境建议同时做来源 IP 限制，并在每个回调里核对 30 秒时间窗。
玩家所在地：为什么每次都传 country
每家游戏工作室都按国家和地区设定了可用范围。我们按你在 getGame 里传的 country 自动匹配，从不根据 IP 猜测玩家所在地，所以你的大厅可以按玩家所在地展示正确的游戏，不会出现点进去才提示的情况。
按 country 处理后，范围以外的游戏会返回“Game not available in your country”，其他游戏照常启动。有的账户服务的市场需要 country 为必填，建议从第一天起每次真实资金启动都传。玩家在香港、澳门、台湾或海外华人社区的，如实传 HK、MO、TW 或所在国家代码即可。
对账：三样东西对照着用
很多中文运营商习惯每天做一次注单核对。在我们这里，对账靠下面三样东西相互印证：
- 你自己的回调日志：每一笔 debit/credit 都带唯一的 call_id 和 round_id，按它们落库就是最完整的一份流水。
- getPlayerHistory：按单个玩家查询，每次最多 500 条，支持按时间（UTC）、游戏和 round_id 过滤，一局的多笔资金变动会合并成一条。
- 门户报表：按月汇总的 GGR 报表和账户流水，适合财务核对账单。
还要注意时区：getPlayerHistory 的 date_from / date_to 都是 UTC，北京时间比 UTC 快 8 小时，按“自然日”对账时别忘了换算。
接入流程：从注册到第一笔 CNY 对局
- 在首页表单提交申请（表单是英文的），在“Player currency”里填 CNY，需要的话再加 USD，一次最多可以声明 8 种。
- 审批通过后登录运营商后台，拿到 api_login、api_password 和 salt_key，填好你的回调地址。有多个站点的，每个站点单独一套密钥和回调地址。
- 调用 getCurrencies 确认账户已开通的币种，再调用 getGameList 拉取 CNY 目录，用 game_type 搭建中文大厅。
- 实现 balance / debit / credit 三个回调，按上面三条规则处理，先用 getGameDemo 试玩模式跑通启动流程（试玩不需要 country）。
- 真实资金小额测试：createPlayer 时传 currency=CNY，getGame 时传 lang、device 和 country，核对游戏内余额与你的钱包一致。
- 上线后关注我们的 Telegram 频道 @casinogamessoftware，新工作室、接口变更和维护公告都会在那里发布。
完整的字段说明、示例请求和错误码见 API 文档；单一钱包的设计思路见 seamless wallet 说明。
常见问题
你们的赌场聚合器支持人民币（CNY）吗？
支持。CNY 是我们的原生币种，老虎机、真人视讯和体育三条产品线都可以直接用人民币开玩家账户，游戏里的余额和限红按人民币显示。CNY 游戏目录由 getGameList 按币种直接返回，拿来就能搭大厅。
玩家币种选人民币还是美元？
看你的钱包怎么记账。钱包按人民币记账就传 CNY；按美元记账就传 USD，充值提现时由你自己换算。一个玩家的币种在第一次创建时确定，之后不能改，要换币种就用新的 user_username。
单一钱包回调是 GET 还是 POST？
统一用 GET，参数放在 query string 里。你的接口必须始终返回 HTTP 200，错误写在 JSON 的 error 字段里。
回调签名怎么验？
key = md5(timestamp + salt_key)。先检查 timestamp 与你服务器时间相差不超过 30 秒，再比对 key；验签失败返回 {"error":2,"balance":0}。生产环境建议同时限制来源 IP，并用 call_id 做幂等。
中国大陆以外的华人玩家怎么处理？
启动时如实传玩家所在地的 country（例如 HK、MO、TW、MY、SG）。各家工作室按国家和地区设定可用范围，我们按 country 自动处理，你不用自己维护名单。
游戏大厅能显示中文吗？
启动时传 lang 参数，游戏按这个语言加载。每款游戏自带的翻译由工作室决定：大量热门老虎机和真人桌台提供简体中文界面。
怎么做对账？
三样东西对照：你自己按 call_id 记录的回调流水、getPlayerHistory（按玩家查询，每次最多 500 条，时间为 UTC），以及门户里按月汇总的报表。
多久能开始测试？
审批通过就能在后台拿到测试密钥。你的团队实现三个回调、调通 getGameList 和 getGame，就可以开始跑真实流程；一个 API 同时覆盖老虎机、真人和体育，不用逐家对接。
接入要准备什么？
一个能处理 balance / debit / credit 的回调地址、一个测试环境、确定的玩家币种。开户审批通过后在后台拿到 api_login、api_password 和 salt_key，按 docs.html 调用即可。
资料来源与更新日期
本页数据来自 SoftAggregator 系统和公开的 API 文档。
- SoftAggregator API 文档：softaggregator.com/docs.html（币种、回调、错误码、country、getPlayerHistory）
- 原生币种列表：SoftAggregator 系统，2026-09-24
最后核对：2026 年 9 月 24 日。数字会变，如发现过时内容，请发邮件到 [email protected]，我们会更正。