# **CQ9商务平台游戏商对接规格文件明细(New)**
:::info
Wanna switch to English Version? ➜ [Click here to switch](https://hackmd.io/@ykLTI4oTTf-iX8GUVg979A/SJav_hMLX?type=view)
:::

* **CQ9商务平台游戏商对接规格文件明细**
* [一、游戏接入流程](#一、游戏接入流程==(需重製)==)
* [二、CQ9对接厂商需提供文件规格表](#二、CQ9对接厂商需提供文件规格表)
* [阶段一、游戏接入前审核](#阶段一、游戏接入前审核)
* [阶段二、机房部署位置确认](#阶段二、机房部署位置确认)
* [阶段三~四、系统对接、问题排除、API接口验证](#阶段三~四、系统对接、问题排除、API接口验证)
* [阶段五、游戏验证与上线前准备](#阶段五、游戏验证与上线前准备)
* [注1:游戏入口网Icon图档提供内容](#**==注1==**:游戏入口网Icon图档提供内容)
* [注2:游戏广告文宣提供内容(纯文字档，中/英文版皆須)](#**==注2==**:游戏广告文宣提供内容（纯文字档，中/英文版皆須)
* [三、CQ9游戏上线后营运管理](#三、CQ9游戏上线后营运管理)
* [四、注意事項](#四、注意事項)
* [更新狀況](#更新狀況)

## 一、游戏接入流程


## 二、CQ9对接厂商需提供文件规格表

以下所列示之文件需求，为在对接中进入每一阶段前所需具备的文件，皆缴交完成后CQ9商务客服即协助安排厂商正式进入该阶段。
==**各阶段需提交的文件档案或范本，请洽商务窗口取得。**==

### 阶段一、游戏接入前审核

|提交文件|内容标准|备注|
|:--------|:--------|:-------|
|厂商基本资料表|1. 厂商名称<br>2. 游戏类型<br>3. 游戏接入款数<br>4. 主机放置位置<br>5. 游戏语系<br>6. 游戏使用币别<br>7. 游戏使用时区<br>8. 游戏试玩网址<br>9. 游戏清单|<br>==请填表后传回==|
|游戏说明文件|1. 每款游戏皆须产出一份说明文件<br>2. 依不同游戏类型，提交以下文件资讯内容，如下(1)~(8)<br>3. 以下需求皆于范例文件中，請洽商务取得||
|(1) 基本信息|游戏名称、游戏代码、游戏特色、游戏操作方式、RTP值、游戏语系、细单语系、币值比、房型、准入、底注、配桌机制、十万风控机制、闲置机制、有限责任制說明、最低兼容规则|
|(2) 游戏画面|主游戏、免费游戏、大厅、牌桌…等画面截图||
|(3) 介面功能|遊戲中所有按鈕操作說明、呈現圖示||
|(4) 游戏賠付|游戏玩法、牌型、赔付规则||
|(5) 讯息代码|遊戲中用到的提示、錯誤訊息列表說明
|(6) 多国语系|若支持需提交 "简中对应多语系" 文件或游戏画面图示供验证||
|(7) 多国币别|若支持需提交相对应的<br>币值比(denomination)、投注额、限紅…等设定值供验证。||
|(8) 测试工具|若有测试用的功能或工具 (如：指定游戏结果仿真器)<br>请提交操作说明文件||

:::danger
**※ 若您的服务器放置于CQ9机房，则须于阶段二另行提供下列文件**
:::

### 阶段二、机房部署位置确认

|提交文件|内容标准|备注|
|:-------|:-------|:-------|
|资讯处机器规格申请表|1. 机器需求表<br>2. 机器架构图<br>3. 游戏流程图|厂商游戏使用CQ9机房时，才须提供此份文件|

### 阶段三~四、系统对接、问题排除、API接口验证
<font color=blue> **1. 系统对接可参阅文件 "游戏伺服器对接文件"，请洽商务窗口取得。
2. 对接期间，请准备并提交以下文件需求。**
</font>

|提交文件|内容标准|备注|
|:-------|:-------|:-------|
|RTP压测报告|1. 依据不同游戏类型，提交RTP数据报告，请参阅 ==[第二章-2.2 RTP 押注報告(连结)](https://hackmd.io/@mP2G9qP5SqaVoIFiXH-6RA/SJh_-ylOO)==<br>2. 如产品无法满足第1点的要求，仍必须提交至少经过10,000,000次以上的彷真RTP数据报告|
|最低兼容性文件|**【PC配置最低需求】**<br>1. 处理器<br>2. 内存<br>3. 硬盘空间<br>4. 显示器<br>5. 显卡<br>6. 浏览器要求<br>**【手机配置最低需求】**<br>1. iOS版本<br>2. Android版本|

### 阶段五、游戏验证与上线前准备

<font color=blue> **1. 上线前，游戏需通过我司品保验证，验证需求规范提列于 ["游戏验证对接文件(连结)"](https://hackmd.io/@mP2G9qP5SqaVoIFiXH-6RA/SJh_-ylOO)**
**2. 游戏验证期间，请准备并提交以下文件需求。**
</font>

|提交文件|内容标准|备注|
|:-------|:-------|:-------|
|图片素材及文宣|1. 游戏入口网Icon图档<br>2. 广宣素材共3张<br>3. 游戏广告文宣|1. Icon图档规格及提供数量<br>**==请参照注1==**<br>2. 广宣素材图档尺寸为1024x250 JPG,<br>768x270 JPG,1920x1080 JPG。<br>3. 游戏广告文宣范例<br>**==请参照注2.==**

### **==注1==**:游戏入口网Icon图档提供内容
:::danger
**※ 厂商提供之图档主要LOGO部分必须为圆形**
:::

* 需提供简体中文、英文版本Icon尺寸（PNG档共12张, PSD档2个)
* 不需去背: 80x80、 128x128、146x136、236x132、 291x136、 300x210、 301x180、 1920x1080、500x500(PSD)、 1920x1080(PSD)
* 需去背: 80x80、 200x200、 291x136、182x170、150x150、268x268

* 泰文語系游戏須提供－泰文版本Icon（PNG档共1张），規格 200x200

==※ Icon图档范例==




### **==注2==**:游戏广告文宣提供内容（纯文字档，中/英文版皆須)
* 游戏广告文宣内需包含游戏特色说明及简单行销文案、文字等，以作为日后游戏推广及玩家参考用。

==※ 游戏广告文宣范例==

## 三、CQ9游戏上线后营运管理
### **帐务验证标准**

1. 游戏提供商对接CQ9系统，必须经由CQ9品保单位于CQ9整合站点测试验证帐务通过，方得布署至正式站上线至正式环境。
2. 游戏若于正式环境发生异常无法复原等断线情况，游戏商必须提供退款机制将玩家金额退回给玩家。
3. 退款机制须于发生异常情况后1小时内必须启动。
_____
### **风险管理标准**
1. 若经由CQ9风控单位评估于正式环境上任何关于游戏异常或者有玩家套利行为，评估过后具有高风险状况，可能导致系统商关闭所有CQ9游戏，CQ9风控单位具有指定特殊游戏主动下架权力。
2. 上线后两周，乙方应限制输赢游戏单场派彩总额，且需提供每款游戏最高派彩倍数，甲方亦同意协助乙方设定单场最高压注额，双方同意于三个月后单场/单注，视情况持续调高。
3. 单日单款可承受风险损失为10万人民币(结算时间以GMT+0为主)经由CQ9风控单位确认后，将采取下架机制。
4. 单笔押注或累积押注后负盈利达10万人民币，经由CQ9风控单位确认后，将采取下架机制。
5. 所有被下架游戏重新上线前，必须由游戏提供商修正完毕且经过CQ9品保单位验证无误之后方可上线。
6. 游戏如果因为亏损而下架，游戏提供商重新上线后盈利须扣除先前亏损。
_____
### **细单显示资讯**

1. 游戏厂商必须提供完整串接CQ9平台后的游戏细单报表。
2. 游戏细单报表必须有完整的下注时间、结算时间、押注金额、赢分资讯、投注划面、游戏盘面资料。
3. 如为彩金游戏,必须清楚且明确的提供该把押码贡献、彩金回馈比率、彩金明细清楚且明确的显示于游戏细单。
4. 如为牌桌游戏,必须清楚且明确的把牌桌抽水比例及相关资讯清楚且明确的显示于游戏细单。
_____
### **上线游戏版本更新规则**
厂商所提供游戏上线后，除因我方平台环境有需要厂商配合之修改或更新外，其他由厂商自行提出之游戏版本更新，须先将更新内容等详细资料于Redmine上提出申请，我方确认允许后，厂商方可在整合站内进行更新版本部署，厂商更新版本规则依照类别区分如下：

**（一）不紧急优化更新(包含版本号不变的小修正)**

1. 厂商每月1号开始可提出redmine申请(指派给BIZ02或BIZ03)，商务客服确认后请厂商在每月10号内完成整合站所有版本更新，并申请QA验证。
2. 若于每月20号前QA验证完成，则安排当月最后一周让厂商做正式站更新(安排更新的日期以CQ9当周停机时间为主，若当周CQ9无停机维护，则统一安排在当周礼拜三)。

**（二）紧急或我方要求之更新**

1. 厂商提出redmine申请(指派给BIZ02或BIZ03)在整合站完成所有版本更新且QA验完后，配合当周CQ9停机或不停机的维护，让厂商在正式站更新。

==※ 版本更新注意事项==

* 我方正式环境上的游戏版本更新或是任何维护更新(含线路调整)，需要事先在redmine提出申请，若是使用自有机房，也需先行告知维护，若有当月连续三次未提前告知而导致营运商提出疑问，为 维持我方平台的稳定性，我方会停止双方的合作关系。
* 上述要求如遇紧急状况，可先于双方技术群组告知再后补redmine需求单。
* 维护更新需说明原因、更新内容、维护时间，如需展延维护时间也应提前在30分钟前告知我方。
* 正式环境的游戏版本，必须与整合站保持一致。

## 四、注意事項
:::info
* 由于我们CQ9在亚洲市场已经有相当的知名度和信任度，并且有大量的忠实玩家客群，为了让接入游戏商的游戏更容易被亚洲玩家接受，我方希望贵司在所有与我方对接的游戏中，能将所有置放在游戏中的原厂LOGO置换成CQ9的LOGO，抑或是将原厂LOGO暂时撤下，以直接有效的方式吸引CQ9原有的忠实玩家大量投入游戏中，并为双方建立更密切有效的合作模式。
* 为因应我方合作营运商要求，厂商游戏在正式环境中除了建议要使用HTTPS外，加密协定也建议使用TLS 1.2或以上
* 为加强我方品保测试对游戏测试的完整度，我方可能会要求贵司提供数值模型或协助测试的工具，请贵司配合提供
:::

## 更新狀況
> **`A` 新增、`U` 更新、`D` 刪除**

**2020/12/29**
`A` 新增中英文iCON尺寸268x268去背 PNG

**2020/12/9**
`A` 新增中英文Icon尺寸236x132 PNG

**2019/2/20**
`A` 新增上线游戏维护规则

**2018/09/17**
`U` 更新RTP压测报告的内容标准和备注
`U` 更新最低兼容性文件的内容标准和备注

**2018/10/01**
`U` 更新风险控制标准第4点

**2018/10/23**
`D` 删除风险控制标准
`A` 新增CQ9游戏上线后营运管理

**2018/10/29**
`U` 更新风险控制标准

**2018/11/27**
`U` 更新需提供的Icon尺寸

**2019/4/3**
`U` 更新上线游戏版本更新规则