# TG、MG(ThothGaming、MovaGaming)<br> 串接API文件

###### tags: `PRODUCTION`, `TG`, `API`

## 版本歷史
| 版本 | 描述 | 日期
|:----------|:----------|:----------
| 1.0.0 | 第一版本釋出 | 2019-08-20
| 1.0.0 | 棋牌遊戲釋出 | 2019-10-14
| 1.0.0 | <ul><li>遊戲開放列表加入支援語系</li><li>二爺捕魚活動代碼新增：1011 等級獎勵, 2005~2009消耗返利</li></ul> | 2019-12-20
| 1.0.0 | 棋牌遊戲-百人炸金花，中文名稱更新為`紅黑大戰` | 2020-01-13
| 1.0.0 | 捕魚遊戲-捕魚大亨&&劈魚來了<ul><li>新增活動代號列表</li><li>新增注單類型列表</li> | 2020-01-14
| 1.0.0 | 遊戲試玩網址api新增語系參數 | 2020-02-10
| 1.0.0 | 新增遊戲-夜店棋牌<ul><li>新增遊戲開放列表</li><li>新增注單類型列表</li></ul> | 2020-04-09
| 1.0.0 | <ul><li>會員資料api 新增幣別回傳欄位</li><li>注單歷程api 新增幣別回傳欄位</li><li>遊戲跳轉網址api 新增error code -12(遊戲尚未支援會員綁定幣別)</li><li>遊戲開放列表 新增各遊戲支援幣別</li><li>附錄新增幣別代碼</li></ul> | 2020-04-23
| 1.0.0 | 新增遊戲開放列表支援幣別<ul><li>USD（美元）</li><li>VND（越南盾）</li><li>THB（泰銖）</li><li>IDR（印尼盾）</li></ul> | 2021-02-26
| 1.0.0 | 遊戲列表新增欄位<ul><li>category: 遊戲類型</li><li>img: 圖片路徑</li><li>popular: 熱門遊戲</li></ul> | 2021-07-02
| 1.0.0 | 遊戲試玩網址新增error code -9 (遊戲尚未支援試玩) | 2021-09-03
| 1.0.0 | 遊戲列表新增Parameters欄位<ul><li>platform: 平台</li> | 2021-11-13
| 1.0.0 | 查詢注單歷程 by datetime新增Parameters欄位<ul><li>account: 會員帳號</li><li>platform: 平台代號</li><li>game: 遊戲代號</li> | 2021-11-17
| 1.0.0 | 查詢注單歷程 by datetime新增Response Code<ul><li>-6: 會員帳號不存在</li><li>-7: 平台代號不存在</li><li>-8: 遊戲代號不存在</li><li>-9: 會員帳號錯誤</li><li>-10: 平台代號錯誤</li><li>-11: 遊戲代號錯誤</li><li>-12: 查詢遊戲代號必填平台代號</li></ul> | 2021-11-17
| 1.0.0 | 遊戲跳轉網址新增Response Code<ul><li>-13: 跳轉過於頻繁</li>| 2021-12-06
| 1.0.0 | 轉帳新增Response Code<ul><li>-12: 轉帳過於頻繁</li>| 2021-12-06
| 1.0.0 | 遊戲跳轉網址 \ 遊戲試玩網址 新增語系<ul><li>th: 泰文</li><li>vn: 越南文</li>| 2022-02-16
| 1.0.0 | 新增遊戲開放列表支援幣別<ul><li>PHP（菲律賓披索）</li></ul> | 2022-03-11
| 1.0.0 | 新增 查詢注單歷程 Response Data<ul><li>bet_time: 下注時間</li><li>report_time: 報表時間</li><li>payout_time: 派彩時間</li></ul> | 2022-05-11
| 1.0.0 | 新增Response Code<ul><li>(轉帳) -13: 代理額度不足</li><li>(遊戲跳轉網址) -14: 代理額度不足</li></ul> | 2022-05-13
| 1.0.0 | 新增Response Code<ul><li>(遊戲跳轉網址) -15: 裝置代號錯誤</li><li>(遊戲跳轉網址) -16: 不支援該裝置</li><li>(遊戲跳轉試玩) -10: 裝置代號錯誤</li><li>(遊戲跳轉試玩) -11: 不支援該裝置</li></ul> | 2022-09-05
| 1.0.0 | 新增查詢轉帳<br>Parameters<ul>account: 會員帳號</ul>Response Code<ul><li>-3: 會員帳號不存在</li><li>-4: 會員轉帳處理中</li><li>-5: 會員帳號格式錯誤</li></ul> | 2022-09-23
| 1.0.0 | 轉帳上限十位數 | 2022-09-23
| 1.0.0 | 新增在線會員列表 Response data <ul><li>platform: 正在遊玩的遊戲平台代號</li></ul> | 2022-10-20
| 1.0.0 | 注單明細URL Parameters新增多語系<ul><li>tw: 繁體</li><li>cn: 簡體</li><li>en: 英文</li><li>vn: 越南文</li></ul> | 2022-11-15
| 1.0.0 | 新增 查詢平台幣別及匯率 | 2023-04-20

## 環境
* api版本：**v1**
* api調用方式：**HTTP POST request**
* api連線逾時最大限制：**5秒**
* 系統時區：**GMT+8 北京時間**(request/response)

## 加密方式
| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| key | string(48,64) | 密鑰<ul><li>加密方式：`商戶帳號 + md5(商戶api_key + datetime) + datetime`</li></ul>

#### 加密參數說明
| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| 商戶帳號 | string(4,20) | 請填入`介接資訊`所提供的 商戶帳號
| 商戶api_key | string(40) | 請填入`介接資訊`所提供的 商戶api_key
| datetime | number(14) | date('YmdHis')<ul><li>時區：GMT+8 北京時間</li><li>datetime與api請求時間不得超過`5`秒</li></ul>
### 範例

商戶帳號 = agtest
商戶api_key = ebae1770b2ecf14aa5a1ff84ae24b84de1fd8d14
datetime = 20190719142425

key = 商戶帳號 + md5(商戶api_key + datetime) + datetime
    = agtest + md5(ebae1770b2ecf14aa5a1ff84ae24b84de1fd8d14 + 20190719142425) + 20190719142425
    = agtest19fd6a93b3f8be624b2fef8eb7042ad820190719142425

## API功能

### 創建會員帳號

#### HTTP request URL
`{api-domain}/{version}/user/create`

#### Parameters
| 名稱 | 類型 | 必填 | 描述
|:----------|:----------|:----------|:----------
| key | string | Y | 密鑰
| agent | string(4, 20) | Y | 代理帳號<ul><li>創建此代理下線會員帳號</li><li>需自行到後台開設`代理`帳號</li></ul>
| account | string(4, 20) | Y | 會員帳號<ul><li>格式: 英文(a-zA-Z), 數字(0-9), 下底線(_)</li></ul>
| password | string(4, 20) | Y | 會員密碼<ul><li>格式: 英文(a-zA-Z), 數字(0-9)</li></ul>

#### Response

| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| code | number | 代碼<ul><li>1: 成功</li><li>-1: 帳號格式錯誤</li><li>-2: 密碼格式錯誤</li><li>-3: 暱稱格式錯誤</li><li>-4: 上層代理帳號格式錯誤</li><li>-5: 會員帳號重複</li><li>-6: 上層代理帳號不存在</li></ul>
| data | array | 回傳資料

---

### 修改會員密碼
#### HTTP request URL
`{api-domain}/{version}/user/password`

#### Parameters
| 名稱 | 類型 | 必填 | 描述
|:----------|:----------|:----------|:----------
| key | string | Y | 密鑰
| account | string(4, 20) | Y | 會員帳號
| password | string(4, 20) | Y | 修改密碼<ul><li>格式:英文(a-zA-Z), 數字(0-9)</li></ul>

#### Response

| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| code | number | 代碼<ul><li>1: 成功</li><li>-1: 帳號格式錯誤</li><li>-2: 密碼格式錯誤</li><li>-3: 會員帳號不存在</li></ul>
| data | array | 回傳資料

---

### 會員資料

#### HTTP request URL
`{api-domain}/{version}/user`

#### Parameters
| 名稱 | 類型 | 必填 | 描述
|:----------|:----------|:----------|:----------
| key | string | Y | 密鑰
| account | string(4, 20) | Y | 會員帳號

#### Response

| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| code | number | 代碼<ul><li>1: 成功</li><li>-1: 會員帳號格式錯誤</li><li>-2: 會員帳號不存在</li></ul>
| data | object | 回傳資料

##### data 回傳資料
| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| account | string | 會員帳號
| currency | string | 會員幣別
| credit | string | 會員額度
| is_online | number | 會員在線狀態<ul><li>1: 在線</li><li>0: 離線</li></ul>
| is_transfer | number | 會員額度狀態<ul><li>1: 額度移轉處理中, 系統會在5秒內做狀態排除</li><li>0: 正常</li></ul>
| status | string | 會員狀態<ul><li>normal: 正常</li><li>lock: 鎖定</li></ul>

---

### 轉帳
#### HTTP request URL
`{api-domain}/{version}/transaction/create`

#### Parameters
| 名稱 | 類型 | 必填 | 描述
|:----------|:----------|:----------|:----------
| key | string | Y | 密鑰
| account | string(4, 20) | Y | 會員帳號
| transfer_id | string(25) | Y | 交易id<ul><li>格式: 英文(a-zA-Z), 數字(0-9)</li><li>固定長度25</li></ul>
| credit | number | Y | 交易額度<ul><li>額度轉入<ul><li>格式：int(10)</li><li>限制只能帶入整數金額</li></ul></li><li>額度轉出<ul><li>格式：decimal(10,2)</li><li>額度帶入0會執行全部轉出</li></ul></li></ul>
| action | string | Y | 動作<ul><li>in: 額度轉入</li><li>out: 額度轉出</li></ul>

#### Response

| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| code | number | 代碼<ul><li>1: 成功</li><li>-1: 交易拒絕,會員帳號格式錯誤</li><li>-2: 交易拒絕,交易額度格式錯誤</li><li>-3: 交易拒絕,交易id格式錯誤</li><li>-4: 交易拒絕,動作代號錯誤</li><li>-5: 交易拒絕,會員帳號不存在</li><li>-6: 交易拒絕,重複的交易id</li><li>-7: 交易拒絕,會員餘額不足</li><li>-8: 轉點交易失敗(請呼叫查詢api做狀態確認)</li><li>-9: 交易逾時(請呼叫查詢api做狀態確認)</li><li>-10: 交易拒絕,會員在線無法轉出</li><li>-11: 交易拒絕,該會員還有其他轉帳交易處理中</li><li>-12: 交易拒絕,轉帳過於頻繁</li><li>-13: 交易拒絕,代理額度不足</ul>
| data | object | 回傳資料

##### data 回傳資料
| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| transfer_id | string | 交易id
| credit | string | 交易額度
| before_credit | string | 交易前額度
| after_credit | string | 交易後額度
| action | string | 動作<ul><li>in: 額度轉入</li><li>out: 額度轉出</li></ul>
| status | string | 狀態<ul><li>1: 成功</li><li>2: 交易逾時處理中</li><li>3: 失敗</li></ul>

---

### 查詢轉帳
#### HTTP request URL
`{api-domain}/{version}/transaction`

#### Parameters
| 名稱 | 類型 | 必填 | 描述
|:----------|:----------|:----------|:----------
| key | string | Y | 密鑰
| transfer_id | string(25) | Y | 交易id
| account | string(4, 20) | N | 會員帳號

#### Response

| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| code | number | 代碼<ul><li>1: 成功</li><li>-1: 交易id格式錯誤</li><li>-2: 交易不存在</li><li>-3: 會員帳號不存在</li><li>-4: 會員轉帳處理中</li><li>-5: 會員帳號格式錯誤</li></ul>
| data | object | 回傳資料

##### data 回傳資料
| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| transfer_id | string | 交易id
| credit | string | 交易額度
| before_credit | string | 交易前額度
| after_credit | string | 交易後額度
| action | string | 動作<ul><li>in: 加點</li><li>out: 扣點</li></ul>
| status | string | 狀態<ul><li>1: 成功</li><li>2: 交易逾時處理中, 請再次呼叫查詢api做狀態確認</li><li>3: 失敗</li></ul>

---

### 遊戲跳轉網址
#### HTTP request URL
`{api-domain}/{version}/game/forward`

#### Parameters
| 名稱 | 類型 | 必填 | 描述
|:----------|:----------|:----------|:----------
| key | string | Y | 密鑰
| account | string(4, 20) | Y | 會員帳號
| platform | string | Y | 平台代號
| game | string | Y | 遊戲代號
| group | string(2, 50) | N | 遊戲分組編號<ul><li>棋牌百人類遊戲分組用</li><li>格式：只允許英文、數字</li><li>預設：00</li></ul>
| lang | string | N | 遊戲語系<ul><li>cn: 簡中 (預設)</li><li>en: 英文</li><li>th: 泰文</li><li>vn: 越南文</li></ul>
| device | string | N | 裝置代號<ul><li>web: 網頁版</li><li>mobile: 手機版 (預設)</li></ul>

#### Response

| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| code | number | 代碼<ul><li>1: 成功</li><li>-1: 帳號格式錯誤</li><li>-2: 平台代號格式錯誤</li><li>-3: 遊戲代號格式錯誤</li><li>-4: 語系格式錯誤</li><li>-5: 會員帳號不存在</li><li>-6: 取得跳轉網址失敗</li><li>-7: 平台維護中</li><li>-8: 平台不存在</li><li>-9: 遊戲維護中</li><li>-10: 遊戲不存在</li><li>-11: 額度移轉處理中(系統會在5秒內做狀態排除)</li><li>-12: 遊戲尚未支援會員綁定幣別</li><li>-13: 跳轉過於頻繁</li><li>-14: 代理額度不足</li><li>-15: 裝置代號錯誤</li><li>-16: 不支援該裝置</li></ul>
| data | object | 回傳資料

##### data 回傳資料
| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| game_url | string | 遊戲網址

---

### 遊戲試玩網址
#### HTTP request URL
`{api-domain}/{version}/game/forward-demo`

#### Parameters
| 名稱 | 類型 | 必填 | 描述
|:----------|:----------|:----------|:----------
| key | string | Y | 密鑰
| platform | string | Y | 平台代號
| game | string | Y | 遊戲代號
| lang | string | N | 遊戲語系<ul><li>cn: 簡中 (預設)</li><li>en: 英文</li><li>th: 泰文</li><li>vn: 越南文</li></ul>
| device | string | N | 裝置代號<ul><li>web: 網頁版</li><li>mobile: 手機版 (預設)</li></ul>

#### Response

| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| code | number | 代碼<ul><li>1: 成功</li><li>-1: 平台代號格式錯誤</li><li>-2: 遊戲代號格式錯誤</li><li>-3: 取得跳轉網址失敗</li><li>-4: 平台維護中</li><li>-5: 平台不存在</li><li>-6: 遊戲維護中</li><li>-7: 遊戲不存在</li><li>-8: 遊戲語系格式錯誤</li><li>-9: 遊戲尚未支援試玩</li><li>-10: 裝置代號錯誤</li><li>-11: 不支援該裝置</li></ul>
| data | object | 回傳資料

##### data 回傳資料
| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| game_url | string | 試玩網址

---

### 查詢注單歷程 by bet_id
#### HTTP request URL
`{api-domain}/{version}/bet-record/detail`

#### Parameters
| 名稱 | 類型 | 必填 | 描述
|:----------|:----------|:----------|:----------
| key | string | Y | 密鑰
| bet_id | string(22) | Y | 注單id

#### Response

| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| code | number | 代碼<ul><li>1: 成功</li><li>-1: bet_id格式錯誤</li><li>-2: 注單不存在</li></ul>
| data | object | 回傳資料

##### data 回傳資料
| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| account | string | 會員帳號
| currency | string | 幣別
| bet_id | string(22) | 注單id
| bet_sn | string(1, 255) | 注單遊戲場景編號
| bet_amount | decimal(16,2) | 下注金額
| bet_valid | decimal(16,2) | 有效投注額
| bet_result | decimal(16,2) | 輸贏結果<ul><li>負數: 輸</li><li>正數: 贏</li><li>0:和局</li></ul>
| bet_type | string | 注單類型(附錄：注單類型列表)
| bet_activity | string | 活動代號 (附錄：活動代號列表)
| bet_time | string | 下注時間
| report_time | string | 報表時間
| payout_time | string | 派彩時間
| offset | string(18) | 查詢偏移值
| platform | string | 平台代號
| game | string | 遊戲代號
| status | string | 狀態<ul><li>1: 已派彩</li></ul>

---

### 查詢注單歷程 by datetime
#### HTTP request URL
`{api-domain}/{version}/bet-record/date-interval`

#### Parameters
| 名稱 | 類型 | 必填 | 描述
|:----------|:----------|:----------|:----------
| key | string | Y | 密鑰
| start_at | string | Y | 起始時間<ul><li>格式: Y-m-d H:i:s</li><li>日期查詢區間最大60天</li></ul>
| end_at | string | Y | 結束時間<ul><li>格式: Y-m-d H:i:s</li><li>日期查詢區間最大60天</li></ul>
| page | number | Y | 起始頁數<ul><li>起始值：1</li></ul>
| limit | number | Y | 分頁筆數<ul><li>範圍值：1~1000</li></ul>
| account | string | N | 會員帳號
| platform | string | N | 平台代號
| game | string | N | 遊戲代號

#### Response

| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| code | number | 代碼<ul><li>1: 成功</li><li>-1: start_at格式錯誤</li><li>-2: end_at格式錯誤</li><li>-3: page格式錯誤</li><li>-4: limit格式錯誤</li><li>-5: 時間區間錯誤</li><li>-6: 會員帳號不存在</li><li>-7: 平台代號不存在</li><li>-8: 遊戲代號不存在</li><li>-9: 會員帳號錯誤</li><li>-10: 平台代號錯誤</li><li>-11: 遊戲代號錯誤</li><li>-12: 查詢遊戲代號必填平台代號</li></ul>
| data | array | 回傳資料
| meta | object | 分頁資料

##### data 回傳資料
| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| account | string | 會員帳號
| currency | string | 幣別
| bet_id | string(22) | 注單id
| bet_sn | string(1, 255) | 注單遊戲場景編號
| bet_amount | decimal(16,2) | 下注金額
| bet_valid | decimal(16,2) | 有效投注額
| bet_result | decimal(16,2) | 輸贏結果
| bet_type | string | 注單類型(附錄：注單類型列表)
| bet_activity | string | 活動代號 (附錄：活動代號列表)
| bet_time | string | 下注時間
| report_time | string | 報表時間
| payout_time | string | 派彩時間
| offset | string(18) | 查詢偏移值
| platform | string | 平台代號
| game | string | 遊戲代號
| status | string | 狀態<ul><li>1: 已派彩</li></ul>

##### meta 分頁資料
| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| limit | number | 分頁筆數
| page | number | 目前分頁
| last_page | number | 最後分頁
| total | number | 總筆數

---

### 查詢注單歷程 by offset
#### HTTP request URL
`{api-domain}/{version}/bet-record/offset`

#### Parameters
| 名稱 | 類型 | 必填 | 描述
|:----------|:----------|:----------|:----------
| key | string | Y | 密鑰
| offset | number(18) | Y | 查詢偏移值<ul><li>回傳該偏移值往後查詢1000筆資料</li><li>首次查詢時輸入0</li></ul>

#### Response

| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| code | number | 代碼<ul><li>1: 成功</li><li>-1: offset格式錯誤</li></ul>
| data | array | 回傳資料

##### data 回傳資料
| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| account | string | 會員帳號
| currency | string | 幣別
| bet_id | string(22) | 注單id
| bet_sn | string(1, 255) | 注單遊戲場景編號
| bet_amount | decimal(16,2) | 下注金額
| bet_valid | decimal(16,2) | 有效投注額
| bet_result | decimal(16,2) | 輸贏結果
| bet_type | string | 注單類型(附錄：注單類型列表)
| bet_activity | string | 活動代號 (附錄：活動代號列表)
| bet_time | string | 下注時間
| report_time | string | 報表時間
| payout_time | string | 派彩時間
| offset | string(18) | 查詢偏移值
| platform | string | 平台代號
| game | string | 遊戲代號
| status | string | 狀態<ul><li>1: 已派彩</li></ul>

---

### 踢除會員
#### HTTP request URL
`{api-domain}/{version}/user/kick`

#### Parameters
| 名稱 | 類型 | 必填 | 描述
|:----------|:----------|:----------|:----------
| key | string | Y | 密鑰
| account | string(4, 20) | Y | 會員帳號

#### Response

| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| code | number | 代碼<ul><li>1: 成功</li><li>-1: 帳號格式錯誤</li><li>-2: 會員帳號不存在</li></ul>
| data | array | 回傳資料

---

### 平台遊戲列表
#### HTTP request URL
`{api-domain}/{version}/game`

#### Parameters
| 名稱 | 類型 | 必填 | 描述
|:----------|:----------|:----------|:----------
| key | string | Y | 密鑰
| platform | string | N | 僅回傳該平台代號遊戲列表

#### Response

| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| code | number | 代碼<ul><li>1: 成功</li></ul>
| data | array | 回傳資料

##### data 回傳資料
| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| platform | string | 平台代號
| category | string | 遊戲類型<ul><li>01: 捕魚</li></ul>
| img | string | 遊戲圖片，預設為''
| popular | bool | 熱門遊戲<ul><li>0: 否</li><li>1: 是</li></ul>
| game | string | 遊戲代號
| status | string | 狀態<ul><li>normal: 正常</li><li>maintaining: 維護中</li></ul>

##### 遊戲開放列表
| 類型 | 中文名稱 | 英文名稱 | category | platform | game | 支援語系 | 支援幣別
|:----------|:----------|:----------|:----------|:----------|:----------|:---------|:-------
| 捕魚| 二爺捕魚 | Twoyeah Fishing | 01 | twoyeah | 1 | cn,en,vn,th | CNY、USD、VND、THB、IDR、INR、PHP
| 捕魚| 捕魚大亨 | Fishing Tycoon | 01 | fishing | 1 | cn,en,vn,th | CNY、USD、VND、THB、IDR、INR、PHP
| 捕魚| 王者捕魚 | King Fishing | 01 | fishking | 1 | cn,en,vn,th | CNY、USD、VND、THB、IDR、INR、PHP
| 捕魚| 劈魚来了 | Split Fishing | 01 | cutfish | 1 | cn,en,vn,th | CNY、USD、VND、THB、IDR、INR、PHP
| 捕魚| 捕魚大富翁 | Rich Fishing | 01 | fish3d | 1 | cn,en,vn,th | CNY、USD、VND、THB、IDR、INR、PHP

---

### 在線會員列表
#### HTTP request URL
`{api-domain}/{version}/user/online`

#### Parameters
| 名稱 | 類型 | 必填 | 描述
|:----------|:----------|:----------|:----------
| key | string | Y | 密鑰

#### Response

| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| code | number | 代碼<ul><li>1: 成功</li><li>-1: 維護中</li></ul>
| data | array | 回傳資料

##### data 回傳資料
| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| account | string | 會員帳號
| platform | string | 正在遊玩的遊戲平台代號

---

### 注單明細URL
#### HTTP request URL
`{api-domain}/{version}/bet-record/detail-url`

#### Parameters
| 名稱 | 類型 | 必填 | 描述
|:----------|:----------|:----------|:----------
| key | string | Y | 密鑰
| bet_id | string(22) | Y | 注單id
| lang | string | N | 語系<ul><li>tw: 繁體</li><li>cn: 簡體</li><li>en: 英文</li><li>vn: 越南文</li></ul>

#### Response

| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| code | number | 代碼<ul><li>1: 成功</li><li>-1: bet_id格式錯誤</li><li>-2: 注單不存在</li><li>-3: lang格式錯誤</li></ul>
| data | object | 回傳資料

##### data 回傳資料
| 名稱 | 類型 | 描述
|:----------|:----------|:----------
| account | string | 會員帳號
| bet_id | string | 注單id
| url | string | 明細網址

---

### 查詢平台幣別及匯率
HTTP request URL
`{api-domain}/{version}/game/support-currency`

#### Parameters

| 名稱 | 類型 | 必填 | 描述 |
| -------- | -------- | -------- | -------- |
| key | string | Y | 密鑰
| platform | string | N | 平台代號
| wallet | string | N | 錢包代號 <li> 00: 轉帳錢包 (預設)<li>01: 單一錢包

#### Response

| 名稱 | 類型 | 描述 |
| -------- | -------- | -------- |
| code | number | 代碼 <li>1: 成功 <li>-1: platform 格式錯誤 <li>-2: platform 不存在 <li>-3: wallet 格式錯誤誤
| data | array | 回傳資料

data 回傳資料
| 名稱 | 類型 | 描述 |
| -------- | -------- | -------- |
| platform | string | 平台代號
| support_currency | array | 支援幣別
| rate | array | 幣別匯率

---

## 附錄
### 常用錯誤代碼
| 代碼 | 描述
|:----------:|:----------
| 1001001 | 系統異常
| 1001002 | 系統維護中
| 1002001 | 密鑰格式錯誤
| 1002002 | api連線逾時
| 1002003 | 密鑰驗證失敗

### 注單類型列表
| 遊戲名稱 | 代碼 | 描述
|:----------:|:----------:|:----------
| 二爺捕魚 | 0101001 | 歡樂廳(0.1-1倍炮場)
| 二爺捕魚 | 0101002 | 財神廳(1-10倍炮場)
| 二爺捕魚 | 0101003 | 武聖廳(10-100倍炮場)
| 二爺捕魚 | 0101015 | 活動獎勵
| 捕魚大亨 | 0102001 | 0.1元炮場
| 捕魚大亨 | 0102002 | 1元炮場
| 捕魚大亨 | 0102003 | 10元炮場
| 捕魚大亨 | 0102015 | 活動獎勵
| 王者捕魚 | 0103001 | 0.1元炮場
| 王者捕魚 | 0103002 | 1元炮場
| 王者捕魚 | 0103003 | 10元炮場
| 王者捕魚 | 0103030 | VIP初级房
| 王者捕魚 | 0103031 | VIP中级房
| 王者捕魚 | 0103032 | VIP高级房
| 劈魚来了 | 0104001 | 0.1元炮場
| 劈魚来了 | 0104002 | 1元炮場
| 劈魚来了 | 0104003 | 10元炮場
| 劈魚来了 | 0104015 | 活動獎勵
| 捕魚大富翁 | 0105001 | 0.1-1倍炮場
| 捕魚大富翁 | 0105002 | 1-10倍炮場
| 捕魚大富翁 | 0105003 | 10-100倍炮場
| 糖果大亨 | 0301016 | 糖果大亨
| 寶石迷城 | 0302016 | 寶石迷城

### 活動代號列表
| 遊戲名稱 | 代碼 | 描述
|:----------:|:----------:|:----------
| 二爺捕魚 | 1000 ~ 1011 | 等級獎勵
| 二爺捕魚 | 2000 ~ 2009 | 消耗返利
| 二爺捕魚 | 3000 ~ 3005 | 捕獲任意魚
| 二爺捕魚 | 4000 ~ 4005 | 捕獲指定魚
| 二爺捕魚 | 5000 | 兌換第一檔獎勵
| 二爺捕魚 | 5001 | 兌換第二檔獎勵
| 二爺捕魚 | 5002 | 兌換第三檔獎勵
| 二爺捕魚 | 5003 | 兌換第四檔獎勵
| 二爺捕魚 | 6000 | 拼圖活動
| 捕魚大亨 | 1000 ~ 1011 | 等級獎勵
| 捕魚大亨 | 2000 ~ 2009 | 消耗返利
| 劈魚來了 | 1000 ~ 1011 | 等級獎勵
| 劈魚來了 | 2000 ~ 2009 | 消耗返利

### 幣別代碼
| 代碼 | 描述
|:----------:|:----------
| CNY | 人民幣
| USD | 美金
| VND | 越南盾
| THB | 泰銖
| IDR | 印尼盾
| INR | 盧比
| PHP | 菲律賓披索