改版进程

2019/07/08


停启用登入游戏与下注 調整參數 (user, type, status)

2019/02/06


加扣点 Response 新增 cash

2019/01/08


api-功能 未结算单查询GetUnsettleReport

2019/01/07


游戏纪录报表(时间) Request 新增 gameno1, gameno2

2018/12/24


api-功能 登出游戏LogoutGame
开游戏 Request 新增 returnurl
游戏纪录报表(时间) Request 新增 datatype

2018/12/21


api-功能 查询代理商余额GetAgentBalance

2018/11/05


api-功能 修改限額EditLimit

2018/10/26


api-功能 开游戏SigninGame

2018/10/01


游戏纪录报表功能GetMemberReport停止使用。

2018/09/18


1.游戏纪录报表(时间)Request新增beforeCash。
2.游戏纪录报表功能預計十月停止使用。

2018/09/03


交易纪录Request新增startTime跟endTime。

2018/08/21


1.全部Request新增syslang、
2.抓單Request新增timetype，
3.抓單Response新增commission、reset、settime

2018/04/17

api-功能-更新密码

2018/04/09

游戏纪录报表、 游戏纪录报表(时间)、小费纪录报表 因应c++关键字(保留字) 场次编号 原代碼 event 新增 round ，子场次编号 原代碼 eventChild 新增 subround。

2018/03/08


api-功能-开游戏 新増语系、新增mode onlyniuniu

2017/12/29


api-功能 EnableorDisablemem 。

2017/11/17


1. LoginGame 新增 mode参数,略过大厅直接进入游戏。

2017/10/17


1. LoginGame 新增 lang 导入英文游戏介面。

2017/10/11


1. 注册功能加入帐号 ，密码最小与最大代入的限制的。
2. api功能-小费纪录报表GetTipReport 代入参数 帐号 改成非必要。

2017/09/03


1. 新增抓取小费的报表功能 api功能-小费纪录报表GetTipReport。

2017/08/25


1. 新增以时间为单位抓取的游戏报表功能 api功能-游戏纪录报表(时间)GetDateTimeReport。

2017/05/09

1. 取余额功能现在可以代参数放贵公司的订单序号。
2. 手册误植vendorld 全数修改改成 vendorId。
3. 新增功能GetMemberTradeReport 查寻加扣点是否有成功。
4. 删除重复的格式FORMAT 表格叙述 。
5. 回传 0 不再代有任何空格符。
6. 简介回传值之定义。

连接需求与流程

技术人员会把 测试对接网址(url) 、代理商ID(vendorId)、代理商代码(signature)，一组发送给您。贵渠道商应可将这些资料成功与之对接。
贵司应在测试环境中应跑完下方流程测试: 


                    测试 注册帐户登入取得余额加(扣)游戏点数开游戏会员报表

系统架构

贵司为渠道网站，以加扣点为例，先从渠道网站登入后，如选择利新视讯转点使用其钱包系统当指令送出时，应使用我方登入验证的API(代理商ID(vendorId)，代理商代码(signature)，贵司与利新视讯对应的user ,与转点值)呼叫我方api服务器，而我方在回传成功与否的数值予以呼应，贵司将其回传值予以判断是否成功进行加扣点并写入贵司的数据库里。以下为系统介接的架构。


连接API测试 Hello

目的

首先使用测试页面来测试是否接通渠道

最后组成的url 

                            http://api.a45.me/api/public/Gateway.php?cmd=Hello&vendorId=请索取&signature=请索取

FORMAT 格式

Method Post
Request Array
Response Json

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String Hello
vendorId String 代理商(aid)
signature String 代理商标识符

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0 :表示成功,其他为失败)
errorMessage String 错误讯息
result String 回传:HELLO

api功能-注册 MemberRegister

目的

增加此代理商(vendorId)的下线账号

user在我方系統是唯一值，建議註冊時加上前後綴(例如: wm_abc123)。

maxwin、maxlose、limitType为风险控管的一环。设定会员最大输赢金额。请经营者多善利用。

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String MemberRegister
vendorId String 代理商(aid)
signature String 代理商标识符
user String 账号   最小值:5字符   最大值:30字符
password String 密码   最小值:6字符   最大值:64字符
username String 姓名   最大值:30字符
profile Integer 头像 (非必要)
maxwin Integer 最大可赢 (非必要)
(此为风险控管的一环，请经营者多善利用)
maxlose Integer 最大可输 (非必要)
(此为风险控管的一环，请经营者多善利用)
mark String 备注    最大值:20   (非必要)
rakeback Integer 會員退水是否歸零   0為: 不歸零 1為: 歸零  (非必要)
limitType String 例:2,5,9,14,48,107,111,131 (非必要)
(此为风险控管的一环，请经营者多善利用)
http://wmapi.a45.me/Limit.html
chip String 会员筹码 使用逗号隔开，可填入5-10组 (非必要)
若没带入，会员筹码预设为 10,20,50,100,500,1000,5000,10000,20000,50000
可用筹码种类：1, 5, 10, 20, 50, 100, 500, 1000, 5000, 10000, 20000, 50000, 100000, 200000, 1000000, 5000000, 10000000, 20000000, 50000000, 10000000, 20000000, 50000000, 100000000
timestamp Integer Unix 时间戳 ex: 1603436917
syslang Integer 0:中文, 1:英文(非必要)

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0:表示成功,其他为失败)
errorMessage String 错误讯息
result String 新增完成

错误代码errorCode

ErrorCode 错误代码 ErrorType 错误种类 Description 描述
0 操作成功 新增成功
104 操作失败 新增会员资料错误,此帐号已被使用!!
10404 参数错误 帐号长度过长
10405 参数错误 帐号长度过短
10406 参数错误 密码长度过短
10407 参数错误 密码长度过长
10409 参数错误 姓名长度过长
10413 参数错误 代理输赢低于设定上限暂停使用
10502 参数错误 帐号名不得为空
10508 参数错误 密码不得为空
10509 参数错误 姓名不得为空
10419 参数错误 筹码格式错误(请用逗号隔开)
10420 参数错误 筹码个数错误(介于5-10个)
10421 参数错误 筹码种类错误
10422 参数错误 帐号只接受英文、数字、下划线与@
10520 参数错误 上层代理停用或停押

api功能-开游戏SigninGame

目的

获取该会员的sid与网址，游戏凭此连结跳转至大厅。

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String SigninGame
vendorId String 代理商(aid)
signature String 代理商标识符
user String 帐号
password String 密碼
lang integer 使用语言 0或空值 为简体中文
1为英文
2为泰文
3为越文
4为日文
5为韩文
6为印度文
7为马来西亚文
8为印尼文
9为繁体中文
10为西文
mode string 略过大厅直接进入百家乐
略过大厅直接进入龙虎
略过大厅直接进入轮盘
略过大厅直接进入骰宝
略过大厅直接进入牛牛
略过大厅直接进入番摊
略过大厅直接进入色碟
(非必要)
voice string cn 普通话
tw 粤语
en 英语
th 泰语
vi 越南语
ja 日语
ko 韩语
hi 印度语
in 印尼语
ms 马来语
es 西语
(非必要)
returnurl string 登出wm時，返回地址 (非必要)
isTest Integer 1:試玩 (非必要)
size Integer 1:iframe嵌入 (非必要)
slot Integer 开电子游戏, 1:直接开启, 不带入:原本模式 (非必要)
slotCode Integer slot=1 时为，电子游戏类型(非必要) 电子游戏列表
slotGameId String slot=1 时为，电子游戏代码(非必要) 电子游戏列表
timestamp Integer Unix时间戳 ex: 1603436917
syslang Integer 0:中文, 1:英文 (非必要)

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0 :表示成功,其他为失败)
errorMessage String 错误讯息
result String 传回登入游戏网址

api功能-登出游戏LogoutGame

目的

将会员登出游戏。

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String LogoutGame
vendorId String 代理商(aid)
signature String 代理商标识符
user String 帐号 (非必要,不填則登出所有會員)
timestamp Integer Unix时间戳 ex: 1603436917
syslang Integer 0:中文, 1:英文(非必要)

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0 :表示成功,其他为失败)
errorMessage String 错误讯息

api功能-更新密码ChangePassword

目的

让该代理下的会员更新密码

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String ChangePassword
vendorId String 代理商(aid)
signature String 代理商标识符
user String 帐号
newpassword String 密码
timestamp Integer Unix时间戳 ex: 1603436917
syslang Integer 0:中文, 1:英文(非必要)

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0:表示成功,其他为失败)
errorMessage String 错误讯息
result String 修改完成

错误代码errorCode

ErrorCode 错误代码 ErrorType 错误种类 Description 描述
0 操作成功 该会员操作成功
10501 操作失败 查无此帐号,请检查
10502 操作失败 帐号名不得为空
10503 操作失败 密码不得为空
10511 操作失败 修改密码与原密码相同

api功能-查询代理商余额GetAgentBalance

目的

查寻该代理商在利新(WM)平台里还剩多少余额。

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String GetAgentBalance
vendorId String 代理商(aid)
signature String 代理商标识符
timestamp Integer Unix时间戳 ex: 1603436917
syslang Integer 0:中文, 1:英文(非必要)

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0:表示成功,其他为失败)
errorMessage String 错误讯息
result float 获取当前余额

错误代码errorCode

ErrorCode 错误代码 ErrorType 错误种类 Description 描述
0 操作成功 取得该代理商当下余额

api功能-取余额GetBalance

目的

查寻该会员在利新(WM)平台里还剩多少余额。

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String GetBalance
vendorId String 代理商(aid)
signature String 代理商标识符
user String 帐号
timestamp Integer Unix时间戳 ex: 1603436917
syslang Integer 0:中文, 1:英文(非必要)

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0:表示成功,其他为失败)
errorMessage String 错误讯息
result float 获取当前余额

错误代码errorCode

ErrorCode 错误代码 ErrorType 错误种类 Description 描述
0 操作成功 取得该会员当下余额

api功能-加扣点ChangeBalance

目的

用于从网站帐号存入额度到wm游戏帐号, 或者从wm游戏帐号提取额度到网站帐号。

请注意： 交易时请勿关闭连线。

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String ChangeBalance
vendorId String 代理商(aid)
signature String 代理商标识符
user String 帐号
money float 加(扣)该会员的点数转点最小值为0.0001，小于该金额将会失败
order String 贵公司产生的订单序号(非必要)最大值:32字符
timestamp Integer Unix时间戳 ex: 1603436917
syslang Integer 0:中文, 1:英文(非必要)

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0 :表示成功,其他为失败)
errorMessage String 错误讯息
result String
Field 参数名称 Type 种类 Description 描述
yourOrderNum String 贵公司的自订单号
orderId String 本公司此次交易的单号
cash String 操作后金额

错误代码 errorCode

ErrorCode 错误代码 ErrorType 错误种类 Description 描述
0 操作成功 该会员交易成功
901 操作失败 转点失败
10410 操作失败 会员上笔交易未成功，请联系客服人员解锁
10501 操作失败 查无此帐号，请检查
10507 操作失败 此账号非此代理下线，不能使用此功能
10801 参数错误 加扣点不得为零
10802 参数错误 加扣点为空，或未设置(money)参数
10803 参数错误 加扣点不得为汉字
10804 操作失败 不得5秒內重复转帐
10805 操作失败 转账失败，该账号余额不足
10806 操作失败 转账失败，账户代理已超过信用额度
10807 操作失败 转帐失败，该笔单号已存在
10808 操作失败 转帐失败,一分钟内转帐次数超过10次,帐号已锁定
10810 操作失败 连线异常，交易未成功
10811 操作失败 金额低于最小值
10812 操作失败 金额小数低于最小值

api功能-交易纪录GetMemberTradeReport

目的

因网络环境问题(封包遗失，封包阻塞)，或其他不可违之因素可能在进行加扣点时导致失败，而贵公司有写入此单号，故做此功能以便查寻争议的单据。

报表查询需间隔30秒，未搜寻到数据需间隔10秒。

请注意：报表资料只保留60天。

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String GetMemberTradeReport
vendorId String 代理商(aid)
signature String 代理商标识符
user String 帐号(必要)
orderid String 我方对该次交易纪录的编号
order String 贵公司对该次交易纪录自定的订单编号
startTime String 例:20190314000000 (2019年03月14日00時00分00秒)
endTime String 例:20190314235959 (2019年03月14日23時59分59秒)
timestamp Integer Unix时间戳 ex: 1603436917
syslang Integer 0:中文, 1:英文(非必要)
使用此功能orderid 与 order 非必要代入，如只有带入user必须带入startTime与endTime,否则只可查寻一小时内该用户的交易纪录，如果代入orderid与order则不受时间限制。

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0 :表示成功,其他为失败)
errorMessage String 错误讯息
result Array
Field 参数名称 Type 种类 Description 描述
orderid String 该次交易单号
addtime String 该次交易纪录时间
money String 该次交易金额
op_code Integer 加扣点代码:加点(121)扣点(122)
subtotal String 此用户目前余额
ordernum String 该次交易贵公司自订单号
user String 该次交易的帐号

错误代码errorCode

ErrorCode 错误代码 ErrorType 错误种类 Description 描述
0 操作成功 该会员操作成功
107 操作成功 操作成功，但未搜寻到数据
10501 操作失败 查无此帐号,请检查
10502 操作失败 帐号名不得为空

api功能-游戏纪录报表GetDateTimeReport

目的

查寻该玩家或者代理旗下会员时间内的游戏纪录。

该功能搜寻起始时间至搜寻结束时间不能多于一天。

该功能搜寻时间至秒数。例:20170809130101 (2017-08-09 13:01:01)

报表查询需间隔30秒，未搜寻到数据需间隔10秒。

请注意：报表资料只保留60天。

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String GetDateTimeReport
vendorId String 代理商(aid)
signature String 代理商标识符
user String 帐号 (非必要)
startTime String 例:20170809130500 (2017年08月09日 13点05分00秒)
endTime String 例:20170809130600 (2017年08月09日 13点06分00秒)
timestamp Integer Unix时间戳 ex: 1603436917
syslang Integer 0:中文, 1:英文(非必要)
timetype Integer 0:抓下注时间, 1:抓结算时间
datatype Integer 0:输赢报表, 1:小费报表, 2:全部
gameno1 Integer 期数 (非必要)
gameno2 Integer 局号 (非必要)
如欲查询全部用户就不用输入user，会以时间区间进行呈现。
如果报表是要搜寻到起始时间到现在，endTime即可以不用代值，只需带startTime。

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0 :表示成功,其他为失败)
errorMessage String 错误讯息
result Array
Field 参数名称 Type 种类 Description 描述
user String 账号
betId String 注单号
betTime String 下注時間
beforeCash String 下注前金额
bet String 下注金额
validbet String 有效下注
water String 退水金额
result String 下注结果
betCode String 請參閱
下注代碼 Code的部分
betResult String 下注内容ex:"Banker"
waterbet String 下注退水金额
winLoss String 输赢金额
ip String IP
gid String 游戏类别编号 101:百家乐,102:龙虎,103:轮盘,104:骰宝,105:牛牛,107:番摊,108:色碟
event and round String 场次编号
eventChild and subround String 子场次编号
tableId String 桌台编号
gameResult String 牌型ex:庄:♦3♦3 闲:♥9♣10
游戏结果取消会显示:The council canceled
gname String 游戏名称ex:百家乐
commission String 0:一般, 1:免佣
reset String Y:有重对, N:非重对
settime String 结算时间
slotGameId String 电子游戏代码 当游戏为电子游戏时出现

错误代码errorCode

ErrorCode 错误代码 ErrorType 错误种类 Description 描述
0 操作成功 该会员操作成功
107 操作成功 操作成功，但未搜寻到数据
101 操作失败 会员身分认证错误
102 参数错误 时间格式错误

api功能-小费纪录报表GetTipReport

目的

查寻该玩家时间内的小费纪录。

报表查询需间隔30秒，未搜寻到数据需间隔10秒。

请注意：报表资料只保留60天。

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String GetTipReport
vendorId String 代理商(aid)
signature String 代理商标识符
user String 帐号   非必要
startTime interger 例:20170809 (2017年08月09日 )
endTime interger 例:20170809 (2017年08月09日 )
timestamp Integer Unix时间戳 ex: 1603436917
syslang Integer 0:中文, 1:英文(非必要)

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0 :表示成功,其他为失败)
errorMessage String 错误讯息
result Array
Field 参数名称 Type 种类 Description 描述
betId String 注单号
Id String Id
betTime String 下注時間
Tip String 小费金额
betResult String 下注内容ex:"Tip_1_"(小费代码均以Tip开头)
winLoss String 输赢金额
ip String ip
gid interger 游戏类别编号 101:百家乐,102:龙虎,103:轮盘,104:骰宝,105:牛牛,107:番摊,108:色碟
event or round String 场次编号
eventChild or subround String 子场次编号
tableId String 桌台编号
username String 账号
gname String 游戏名称ex:百家乐

错误代码errorCode

ErrorCode 错误代码 ErrorType 错误种类 Description 描述
0 操作成功 该会员操作成功
107 操作成功 操作成功，但未搜寻到数据
101 操作失败 会员身分认证错误
102 参数错误 时间格式错误

api功能-停启用登入游戏与下注EnableorDisablemem

目的

用api 操作代理會員停啟用 登入與下注。

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String EnableorDisablemem
vendorId String 代理商(aid)
signature String 代理商标识符
user String 启停用登入帐号   帐号，如若多个帐号请使用','分开(无法登入游戏，api即反回错误讯息)
type String 類型   login:啟用, bet: 下注
status String Y 或 N Y:启用, N:停用
timestamp Integer Unix时间戳 ex: 1603436917
syslang Integer 0:中文, 1:英文(非必要)

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0 :表示成功,其他为失败)
errorMessage String 错误讯息
result String 回传停启用的帐号资讯 ex:会员:xxxxxxx已停用下注。

错误代码errorCode

ErrorCode 错误代码 ErrorType 错误种类 Description 描述
0 操作成功 该会员操作成功
10305 操作失败 代理商已被停用登入或下注
10501 操作失败 查无此帐号,请检查
10705 操作失败 参数错误或未填写

api功能-修改限額EditLimit

目的

修改玩家限額。

maxwin、maxlose、limitType为风险控管的一环。设定会员最大输赢金额。请经营者多善利用。

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String EditLimit
vendorId String 代理商(aid)
signature String 代理商标识符
user String 帐号
maxwin Integer 最大可赢 (非必要)
(此为风险控管的一环，请经营者多善利用)
reset Integer 1:时间重设 (非必要)
maxlose Integer 最大可输 (非必要)
(此为风险控管的一环，请经营者多善利用)
limitType String 例:2,5,9,14,48,107,111,131 (非必要)
(此为风险控管的一环，请经营者多善利用)
http://wmapi.a45.me/Limit.html
timestamp Integer Unix时间戳 ex: 1603436917
syslang Integer 0:中文, 1:英文(非必要)

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0:表示成功,其他为失败)
errorMessage String 错误讯息
result String 修改完成

错误代码errorCode

ErrorCode 错误代码 ErrorType 错误种类 Description 描述
0 操作成功 该会员操作成功
106 操作失败 新增资料错误
900 操作失败 查无此函数
10501 操作失败 查无此帐号,请检查
10502 操作失败 帐号名不得为空

api功能-未結算單查詢GetUnsettleReport

目的

查詢未結算注單。

报表查询需间隔30秒，未搜寻到数据需间隔10秒。

请注意：报表资料只保留60天。

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String GetUnsettleReport
vendorId String 代理商(aid)
signature String 代理商标识符
Time interger 例:20190108 (2019年01月08日)
timestamp Integer Unix时间戳 ex: 1603436917
syslang Integer 0:中文, 1:英文(非必要)

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0:表示成功,其他为失败)
errorMessage String 错误讯息
result Array
Field 参数名称 Type 种类 Description 描述
user String 账号
betId String 注单号
betTime String 下注時間
bet String 下注金额
betResult String 下注内容ex:"Banker"
gid interger 游戏类别编号 101:百家乐,102:龙虎,103:轮盘,104:骰宝,105:牛牛,107:番摊,108:色碟
event or round String 场次编号
eventChild or subround String 子场次编号
tableId interger 桌台编号
gname String 游戏名称ex:百家乐
commission Integer 0:一般, 1:免佣

错误代码errorCode

ErrorCode 错误代码 ErrorType 错误种类 Description 描述
0 操作成功 操作成功
107 操作成功 操作成功，但未搜寻到数据
102 参数错误 时间格式错误
10411 操作失败 請於30秒後再試

api功能-注單資料查詢 GetReportDetail

目的

查詢注單資料查詢。

代入参数Request

Field 参数名称 Type 种类 Description 描述
cmd String GetReportDetail
vendorId String 代理商(aid)
signature String 代理商标识符
user String 账号
betId interger 注单编号
url String 資料格式 Y/N，Ｙ：連結顯示方式，Ｎ：同GetDateTimeReport格式 (预设:Y) (非必要)
limit String 连结有效限制，Y/N (预设:Y) (非必要)
limitTime interger 连结有效限制时间，于 limit=Y ⽤ (预设:300秒) (非必要)
syslang Integer 0:中文, 1:英文 (非必要)

回传值Response

Field 参数名称 Type 种类 Description 描述
errorCode Integer 错误代码(0:表示成功,其他为失败)
errorMessage String 错误讯息
result Array
Field 参数名称 Type 种类 Description 描述
url String 注單信息網址

错误代码errorCode

ErrorCode 错误代码 ErrorType 错误种类 Description 描述
0 操作成功 操作成功
10910 操作失败 订单编号不可为空
10911 操作失败 無此订单资料
10912 参数错误 时间格式错误

其他错误代码Error Code

错误代码errorCode

ErrorCode 错误代码 ErrorType 错误种类 Description 描述
0 操作成功 该会员操作成功
103 参数错误 代理商ID与识别码格式错误
900 参数错误 查无此函数
911 操作失败 维护中
10201 参数错误 此功能仅能查询一天内的报表，您已超过上限
10202 参数错误 时间戳异常,超过30秒
10301 参数错误 代理商ID为空,请检查(vendorId)
10302 参数错误 没有这个代理商ID
10303 参数错误 有此代理商ID,但代理商代码(signature)错误
10304 参数错误 代理商代码(signature)为空
10411 操作失败 請於30秒後再試
10418 操作失败 請於10秒後再試
10501 参数错误 查无此帐号,请检查
10502 参数错误 帐号名不得为空
10504 参数错误 此帐号的密码错误
10505 参数错误 此帐号已被停用
10507 参数错误 此账号非此代理下线,不能使用此功能
10512 参数错误 帐号密码格式错误
10601 参数错误 限額未開放，請檢查