本文件旨在帮助运营商使用 VegasLounge API 集成各种游戏内容，为其玩家提供最佳游戏体验。

本文为具有基本 API 和 HTTP 集成理解的技术人员设计。

环境

Vegas Lounge 提供两种环境供新运营商集成使用：

环境	URL	描述
测试环境	https://fl.playgon01.net/	请注意，此环境仅用于测试，因此可能无法启用某些功能：- 真人类游戏桌只会开放给正式环境，不支持测试环境测试。测试环境请使用 ETG 和 VIP 桌进行测试。要查看此环境的演示运营商实现，请访问：https://www.playgon01.net/
正式环境	https://fl.vegaslounge.live/	功能齐全。如需查看所有功能的演示，请访问:https://www.vegaslounge.live/ 如果来自中国：https://www.kmnywl.com/china

术语

术语	定义
VegasLounge	真人荷官和电子赌桌游戏应用。
玩家	运营商的会员
运营商	提供玩家身份验证和钱包的服务
运营商 API	提供玩家身份验证和钱包服务的平台交易的 API
运营商登录页面	运营商网站的登录页面
authorization_code	运营商提供的临时授权码，用于获取 access_token 访问令牌
access_token	访问令牌是在进行 API 调用时使用来验证玩家的
游戏	被称为特定游戏类型的"回合"或"手牌"。这包括从投注开放到计算结果和分发奖金之间的时间
gameType	游戏类别，包括 `百家乐` 、 `轮盘赌` 或 `二十一点` 。
www.operator.com	运营商网站的示例域名
api.operator.com	运营商 API 的示例域名
fl.vegaslounge.live	VegasLounge 网站的域名
pl.vegaslounge.live	VegasLounge API 的域名（包括获取游戏列表和转账钱包 API）

集成方式

运营商可以通过免转钱包或转账钱包多种方式实现此集成。

免转钱包：

每个玩家操作通过运营商网站和 Vegas Lounge 之间的 API 调用进行授权和管理。

所需 API

客户端 API v2.0

身份验证 API v2.0

免转钱包 API v2.0

转账钱包：

所有玩家的操作都在 Vegas Lounge 钱包内管理，通过与运营商的授权存款和取款进行更新。 *所需 API

客户端 API v2.0

身份验证 API v2.0

转账钱包 API v2.0

支持的语言和货币

目前，Vegas Lounge 为所有运营商支持以下语言和货币。 注意： 如果您所需的语言和货币不在此列表中，请联系您的 Playgon 对接专员。

语言列表

语言	语言代码
丹麦语	da_DK
德语	de_DE
希腊语	el_GR
英语	en_EN
西班牙语	es_ES
芬兰	fi_FI
法语	fr_FR
日本	ja_JP
印地语	hi_IN
印度尼西亚	id_ID
韩国	ko_KR
柬埔寨	km_KH
马来语	ms_MY
挪威	nb_NO
抛光	pl_PL
葡萄牙语（巴西）	pt_BR
俄语	ru_RU
瑞典	sv_SE
泰国	th_TH
土耳其	tr_TR
越南语	vi_VN
简体中文	zh_CN
塞尔维亚	sr_sr
繁体中文	zh_TW

货币列表

Currency	货币	代码	符号
Argentine peso	阿根廷比索	ARS	$
Armenian Dram	亚美尼亚德拉姆	AMD	֏
Australian Dollar	澳元	AUD	$
Azerbaijani Manat	阿塞拜疆马纳特	AZN	₼
Bolivian boliviano	玻利维亚诺	BOB	Bs.
Brazilian Real	巴西雷亚尔	BRL	R$
Cambodian Riel	柬埔寨瑞尔	KHR	៛
Canadian Dollar	加拿大元	CAD	$
Chilean peso	智利比索	CLP	$
Chinese Yuan	人民币	CNY	¥
Colombian peso	哥伦比亚比索	COP	$
Danish Krone	丹麦克朗	DKK	kr
Dogecoin	狗狗币	DOGE	Ð
Dominican peso	多米尼加比索	DOP	$
Euro	欧元	EUR	€
Georgian Lari	格鲁吉亚拉里	GEL	ლ
Ghana	加纳	GHS	₵
Great British Pound	英镑	GBP	£
Haitian gourde	海地古德	HTG	G
Hungarian forint	匈牙利福林	HUF	Ft
Indian Rupee	印度卢比	INR	₹
Indonesian Rupiah Truncated	印尼卢比 (1:1000)	IDRT	Rp
Indonesian Rupiah	印尼卢比	IDR	Rp
Japanese Yen	日元	JPY	¥
Kazakhstani Tenge	哈萨克斯坦坚戈	KZT	₸
Korean Won	韩元	KRW	₩
Laotian Kip	老挝基普	LAK	₭
Litecoin	莱特币	LTC	Ł
Malaysian Ringgit	马来西亚林吉特	MYR	RM
Mexican peso	墨西哥比索	MXN	$
Micro BTC	微比特币	BTC	µBTC
Milli Bitcoin Cash	毫比特币现金	mBCH	mBCH
Milli BTC	毫比特币	MBTC	mɃ
Milli ETH	毫以太币	METH	mΞ
Milli Litecoin	毫莱特币	mLTC	mŁ
Mongolian tögrög	蒙古图格里克	MNT	₮
Myanmar Kyat	缅甸缅元	MMK	K
New Zealand Dollar	新西兰元	NZD	$
Norwegian Krone	挪威克朗	NOK	kr
Paraguayan guaraní	巴拉圭瓜拉尼	PYG	₲
Peruvian sol	秘鲁索尔	PEN	S/
Philippine peso	菲律宾比索	PHP	₱
Polish	波兰兹罗提	PLN	zł
Russian Ruble	俄罗斯卢布	RUB	₽
South African Rand	南非兰特	ZAR	R
Sri Lankan Rupee	斯里兰卡卢比	LKR	₨
Swedish Krona	瑞典克朗	SEK	kr
Swiss franc	瑞士法郎	CHF	Rp.
Taiwanese Dollar	台币	TWD	$
Tether	泰达币	USDT	₮
Thai Baht	泰铢	THB	฿
Tunisian Dinar	突尼斯第纳尔	TND	TND
Turkish Lira	土耳其里拉	TRY	₺
Ukrainian Hryvni	乌克兰格里夫尼亚	UAH	₴
Uruguayan peso	乌拉圭比索	UYU	$
US Dollar	美元	USD	$
Venezuelan bolívar soberano	委内瑞拉玻利瓦尔	VES	Bs.
Vietnamese Dồng Truncated	越南盾 (1:1000)	VNDT	₫
Vietnamese Dồng	越南盾	VND	₫
West African CFA franc	西非 CFA 法郎	XOF	Franc

客户端 CLIENT API

本页面概述了玩家访问 VegasLounge 的游戏登陆页面。

环境 IP 地址

正式环境 IP 地址： 13.232.208.217

测试环境 IP 地址： 3.222.134.125

支持的设备和平台

Vegas Lounge 设计为可在移动浏览器和桌面设备上使用。以下是我们支持的平台和浏览器

操作系统支持版本

操作系统	最低支持版本（仍在维护）	当前稳定版本
微软 11	10.0.22621.382	10.0.22621.525
微软 10	10.0.19043.985 （21H1 版本）	10.0.19044.2075
Mac OS Mavericks	MacOS10.9	MacOS12
iOS	14	16.0.2
安卓	8	13

浏览器支持版本

操作系统	最低支持版本（仍在维护）	当前稳定版本
Chrome 移动端	105.0.5195	105.0.5195
Chrome 桌面端	105.0.5195	106.0.5249
Safari 移动端	14.0	15.5
Safari 桌面端	14	15.5
Edge	84.0.522	97.0.1072.69
Opera	76	78

启动游戏

在启动游戏前，VegasLounge 团队必须向运行商提供有效的运营商商户 ID client_id。如果运营商没有此代码，请联系您的 Playgon 对接专员获取。

参数	类型	必传	描述
client_id	TEXT(255)	是	运营商商户 ID。
countryISOCode	（TEXT）	否	国家 ISO 代码。例如，中国的代码为 CN。

对于来自中国的玩家，使用以下游戏启动器 URL 来构建链接。玩家的位置将根据 IP 地址确定（可以通过 countryISOCode 查询参数覆盖）。所有额外的查询参数将被传递到启动 URL.

启动链接示例


https://fl.vegaslounge.live/player/&lt;client_id&gt;/launch?code=d4c0a75f-6953-4718-b75b-9fdb90eb457f&amp;countryISOCode=CN

响应

 Location: https://fl.vegaslounge.live/?client_id=<client_id>&code=d4c0a75f-6953-4718-b75b-9fdb90eb457f

游戏入口

根据运营商的需求，Vegas Lounge 为提供三种不同类型的游戏入口：

子大厅

主大厅

直接进入牌桌为了获得最佳的玩家体验，Vegas Lounge 推荐使用 子大厅 入口，因为它使玩家可以根据自己的策略选择桌子。

子大厅

当玩家从子大厅参数进入游戏时，将会看到同游戏类别的游戏桌选项。子大厅游戏页面如下：

启动链接示例

https://fl.vegaslounge.live/?var=<REGULAR_BACCARAT>&attr=<LIVE>&client_id=<VL001>

参数	类型	必传	描述
var	TEXT(255)	是	玩家将直接转到指定类别，显示该游戏的所有开放桌子 - 有效值： `REGULAR_BACCARAT` （默认）， `TIGER_BACCARAT` ， `EU_ROULETTE` ， `BLACKJACK` 。对应为百家乐，老虎百家乐，轮盘，二十一点
attr	TEXT(255)	是	玩家将直接转到指定的游戏类型。 - 有效值： `LIVE` (默认)， `ETG` ， `ETG_SPEED` 。对应为真人类，电子桌，极速电子桌
client_id	TEXT(255)	是	运营商商户 ID。

主大厅

当玩家从子大厅参数进入游戏时，将会看到所有游戏类别的入口。主大厅游戏页面如下：

启动链接示例

https://fl.vegaslounge.live/?client_id=<VL001>&code=<code>

参数	类型	必传	描述
client_id	TEXT(255)	是	运营商商户 ID
code	(TEXT)	是	一次性临时授权码，用于交换访问令牌。

牌桌

当玩家进入游戏应用时，他们将直接进入到指定的牌桌中。游戏页面如下：

启动链接示例

https://fl.vegaslounge.live/?ti=<bc.01>&gl=<Bronze>&client_id=<VL001>

参数	类型	必传	描述
ti	TEXT(255)	是	游戏 tile ID。当指定时，玩家将直接进入游戏/桌子。
gl	TEXT(255)	是	有效值为 `Bronze` 。
client_id	TEXT(255)	是	运营商商户 ID.

API 概述

类别	API	链接	描述	可见性	必传
游戏	获取游戏列表	`https://pl.vegaslounge.live/operator/tiles`	获取可用游戏列表的接口	公开	否

获取游戏列表

这是一个具有可用游戏列表的接口。如果您想要每个游戏的单独链接，则这是一个可选端点。

请求示例

对于 Authorization,将会使用来自授权 OAuth2.0 服务阶段的 base64(client_id + ":" + client_secret)进行授权。

成功响应

[{
    "id": "TI",
    "type": "LIVE",
    "name": {
        "en_US": "Baccarat",
        "ja_JP": "バカラ",
        "ko_KR": "바카라",
        "zh_CN": "百家乐",
        "zh_TW": "百家樂"
    },
    "table": {},
    "limits": [{}],
    "trend": {},
    "image": "https://fl.vegaslounge.live/cdn/images/lobby/TI.jpg",
    "url": "https://fl.vegaslounge.live/?ti=TI&gl=GL&client_id=VL001"
}]

响应参数	类型	必传	注释
id	TEXT(255)	是	游戏的唯一 ID。
type	TEXT(255)	否	默认情况下，游戏的类型为 LIVE。有效值为： `LIVE` `RNG`
name	MAP(TEXT(10) `TEXT(255))`	是	游戏的名称在不同语言中的非唯一名称，其中键是区域标识符，值是翻译。语言标签在 RFC 5646 中正式定义，依赖于 ISO 639 标准（通常是 ISO 639-1 代码列表）用于使用语言代码。
image	TEXT(255)	是	游戏图片 URL。有效格式为： `JPG` `PNG` `SVG`
url	TEXT(255)	是	具有特定限制的特定游戏的直接链接。OAuth 2.0 代码可以作为额外参数添加，以加快加载速度，如 &code=CODE

错误响应

此端点可能响应任何 500 状态。

游戏列表

类别	游戏名称	游戏英文名字		桌号
真人百家乐	速度百家乐 L1	Speed Baccarat 1	bc.01	bc.01
	速度百家乐 L2	Speed Baccarat 2	bc.02	bc.02
	速度百家乐 L3	Speed Baccarat 3	bc.03	bc.03
	速度百家乐 L5	Speed Baccarat 5	bc.05	bc.05
	百家乐 L6	Baccarat 6	bc.06	bc.06
	百家乐 L7	Baccarat 7	bc.07	bc.07
	百家乐 L8	Baccarat 8	bc.08	bc.08
	百家乐 L9	Baccarat 9	bc.09	bc.09
	速度老虎百家乐 L1	Speed Tiger Baccarat 1	tg.01	bc.01
	速度老虎百家乐 L2	Speed Tiger Baccarat 2	tg.02	bc.02
	速度老虎百家乐 L3	Speed Tiger Baccarat 3	tg.03	bc.03
	速度老虎百家乐 L5	Speed Tiger Baccarat 5	tg.05	bc.05
	老虎百家乐 L6	Tiger Baccarat 6	tg.06	bc.06
	老虎百家乐 L7	Tiger Baccarat 7	tg.07	bc.07
	老虎百家乐 L8	Tiger Baccarat 8	tg.08	bc.08
	老虎百家乐 L9	Tiger Baccarat 9	tg.09	bc.09
	多桌百家乐	Multi-Table Baccarat	LD_BACCARAT_CONCURRENT_GAME_TILE
	多桌轮盘	Multi-Table Roulette	LD_EU_ROULETTE_CONCURRENT_GAME_TILE
	多桌老虎百家乐	Multi-Table Tiger Baccarat	LD_TIGER_BONUS_CONCURRENT_GAME_TILE
真人轮盘赌	轮盘 L1	Roulette 1	rl.01	rl.01
	轮盘 L2	Roulette 2	rl.02	rl.02
	自动轮盘 1	Auto Roulette 1	rl.05	rl.05
	自动轮盘 2	Auto Roulette 2	rl.06	rl.06
	自动轮盘 3	Auto Roulette 3	rl.07	rl.07
	极速自动轮盘 1	Auto Roulette Rapid 1	rl.11	rl.11
	极速自动轮盘 2	Auto Roulette Rapid 2	rl.12	rl.12
	极速自动轮盘 3	Auto Roulette Rapid 3	rl.13	rl.13
	Odds UP 轮盘 1	Odds UP Roulette 1	rl.17	rl.17
	自动 Odds UP 轮盘	Auto Odds UP Roulette 1	rl.21	rl.21
电子类百家乐	百家乐 E1	E-Table Baccarat 1	st.0m	st.0m
	百家乐 E2	E-Table Baccarat 2	st.0n	st.0n
	百家乐 E3	E-Table Baccarat 3	st.0o	st.0o
	百家乐 E4	E-Table Baccarat 4	st.0p	st.0p
	百家乐 E5	E-Table Baccarat 5	st.0q	st.0q
	百家乐 E6	E-Table Baccarat 6	st.0r	st.0r
	百家乐 E7	E-Table Baccarat 7	st.0s	st.0s
	百家乐 E8	E-Table Baccarat 8	st.0t	st.0t
	百家乐 ES1	E-Table Speed Baccarat 1	st.0u	st.0u
	百家乐 ES2	E-Table Speed Baccarat 2	st.0v	st.0v
	百家乐 ES3	E-Table Speed Baccarat 3	st.0w	st.0w
	百家乐 ES4	E-Table Speed Baccarat 4	st.0x	st.0x
	百家乐 ES5	E-Table Speed Baccarat 5	st.0y	st.0y
	百家乐 ES6	E-Table Speed Baccarat 6	st.0z	st.0z
	百家乐 ES7	E-Table Speed Baccarat 7	st.10	st.10
	百家乐 ES8	E-Table Speed Baccarat 8	st.11	st.11
	老虎百家乐 E1	E-Table Tiger Baccarat 1	st.13	st.13
	老虎百家乐 E2	E-Table Tiger Baccarat 2	st.14	st.14
	老虎百家乐 E3	E-Table Tiger Baccarat 3	st.15	st.15
	老虎百家乐 E4	E-Table Tiger Baccarat 4	st.16	st.16
	老虎百家乐 E5	E-Table Tiger Baccarat 5	st.17	st.17
	老虎百家乐 E6	E-Table Tiger Baccarat 6	st.18	st.18
	老虎百家乐 E7	E-Table Tiger Baccarat 7	st.19	st.19
	老虎百家乐 E8	E-Table Tiger Baccarat 8	st.1a	st.1a
	老虎百家乐 ES1	E-Table Speed Tiger Baccarat 1	st.1b	st.1b
	老虎百家乐 ES2	E-Table Speed Tiger Baccarat 2	st.1c	st.1c
	老虎百家乐 ES3	E-Table Speed Tiger Baccarat 3	st.1d	st.1d
	老虎百家乐 ES4	E-Table Speed Tiger Baccarat 4	st.1e	st.1e
	老虎百家乐 ES5	E-Table Speed Tiger Baccarat 5	st.1f	st.1f
	老虎百家乐 ES6	E-Table Speed Tiger Baccarat 6	st.1g	st.1g
	老虎百家乐 ES7	E-Table Speed Tiger Baccarat 7	st.1h	st.1h
	老虎百家乐 ES8	E-Table Speed Tiger Baccarat 8	st.1i	st.1i
	VIP 百家乐	E-Table VIP Baccarat	VIP_BACCARAT	st.12
	VIP 老虎百家乐	E-Table VIP Tiger Baccarat	VIP_TIGER_BONUS	st.1j
	多桌百家乐	E-Table Multi-Table Baccarat	ETABLE_BACCARAT_CONCURRENT_GAME_TILE
	多桌速度百家乐	E-Table Multi-Table Speed Baccarat	ETABLE_SPEED_BACCARAT_CONCURRENT_GAME_TILE
	多桌老虎百家乐	E-Table Multi-Table Tiger Baccarat	ETABLE_TIGER_BONUS_CONCURRENT_GAME_TILE
电子桌二十一点	VIP 二十一点 3	E-Table Blackjack 3	ETABLE_BLACKJACK_HI	st.2k
	VIP 二十一点 1	E-Table Blackjack 1	ETABLE_BLACKJACK_LOW	st.2i
	VIP 二十一点 2	E-Table Blackjack 2	ETABLE_BLACKJACK_MED	st.2j

身份验证 Authentication API

本节概述了运营商需要向 Vegas Lounge 提供的内容，以便成功集成。

API 概述

API 类别	API	示例端点	描述	可见性	必传
认证	授权	https://www.operator.com/oauth2.0/authorize	为未认证用户提供登录和认证页面。如果用户直接访问 Vegas Lounge 而未先登录运营商，则会发生这种情况。	公开	否
认证	登出	https://www.operator.com/logout	当玩家选择登出（包括从 Vegas Lounge 和运营商登出）时，这是用户将被重定向到的 URL。	公开	否
认证	验证授权码	https://api.operator.com/oauth2.0/token	Vegas Lounge 将使用运营商验证短期授权码。响应结果是访问令牌。	IP 限制	是
认证	刷新令牌	https://api.operator.com/oauth2.0/token	Vegas Lounge 通过与运营商交换已过期的令牌以获取新令牌，来延长用户的 API 会话。	IP 限制	否
认证	获取账户信息	https://api.operator.com/account	返回关于用户的账户信息。	IP 限制	是

授权

如果玩家直接访问 Vegas Lounge（未进行身份验证），他们将被重定向到运营商的登录页面（例如：https://{{运营商的网站}}/oauth2.0/authorize）进行登录和获取授权。一旦玩家成功认证，运营商将根据客户端 API 中指定的 URL 将玩家重定向回 Vegas Lounge。

请求示例

https://www.operator.com/oauth2.0/authorize?response_type=code&client_id=VL001&redirect_uri=https://fl.vegaslounge.live

请求参数	类型	描述
response_type	TEXT(40)	应始终为 `code`
client_id	TEXT(40)	运营商商户 ID
redirect_uri	TEXT(255)	成功登录后重定向玩家的 URL。

场景示例

玩家直接访问 https://fl.vegaslounge.live/

由于玩家未认证，他们将被重定向到
https://www.operator.com/oauth2.0/authorize?response_type=code&client_id=VL001&redirect_uri=https://fl.vegaslounge.live

玩家将看到运营商的登录页面。

玩家输入其凭据并成功登录。

运营商将玩家重定向到 https://fl.vegaslounge.live/?code=xyz123.

登出

当用户选择登出（包括从 Vegas Lounge 和运营商登出）时，这是用户将被重定向到的 URL。运营商随后可以执行任何自定义操作，例如移除浏览器会话 cookie。请注意，访问令牌仍然有效。

请求示例

  https://www.operator.com/logout

示例场景

玩家登录到运营商的网站。

然后选择Vegas Lounge。

玩了一会儿。

玩家点击Vegas Lounge中的登出按钮。

玩家随后被重定向到https://www.operator.com/logout.

验证授权 (必)

此 API 由 VegasLounge 发出请求，而运营商需按照指定格式返回响应信息。

Vegas Lounge 将使用运营商验证短期授权码。响应结果是访问令牌。此访问令牌将被 Vegas Lounge 用于通过运营商 API 检索与此玩家相关的信息。

请求示例

请求参数	类型	必传	描述
grant_type	TEXT(40)	是	应始终为 `authorization_code`
code	TEXT(255)	是	授权码（客户端 API 中的 code URL 参数值）
client_id	TEXT(40)	是	运营商商户 ID。
client_secret	TEXT(255)	是	运营商商户秘钥

成功响应

{
  "access_token": "JewdX+n7R4DZekCEx6LxUtT87kU=",
  "expires_in": 3600,
  "refresh_token": "7uCIR6QZHUqYMT51OYVk2sliC3LV"
}

响应参数	类型	必传	说明
access_token	TEXT(255)	是	访问令牌。Vegas Lounge 将使用此令牌向运营商 API 请求此玩家的信息
expires_in	INTEGER	否	定义访问令牌到期的秒数。如果提供，Vegas Lounge 将调用刷新令牌 API 以获取另一个令牌。默认为无到期。
refresh_token	TEXT(255)	否	用于在访问令牌过期时获取新访问令牌的令牌

错误响应

{
  "errorCode": 1001,
  "error": "Authorization code has expired"
}

参数	类型	必传	描述
errorCode	INTEGER	是	如果 success 为 false，运营商需要提供错误代码
error	TEXT(255)	是	如果 success 为 false，运营商需要提供错误信息

刷新令牌

此 API 由 VegasLounge 发出请求，而运营商需按照指定格式返回响应信息。

用于在当前令牌过期时检索新访问令牌。需要刷新令牌才能获取新访问令牌。

请求示例

请求参数	类型	必传	描述
grant_type	TEXT(40)	是	应始终为 `refresh_token`
refresh_token	TEXT(255)	是	在验证授权码时返回的刷新令牌
client_id	TEXT(40)	是	运营商商户 ID
client_secret	TEXT(255)	是	运营商商户秘钥

成功响应

{
  "access_token": "HPoR5_e5FSXb8r_jL4dVAnxnHGNu",
  "expires_in": 3600,
  "refresh_token": "G9XRPkUgTGtR2JmSx0C22smppcU2"
}

响应参数	类型	必传	描述
access_token	TEXT(255)	是	访问令牌。Vegas Lounge 将使用此令牌向运营商 API 请求此玩家的信息
expires_in	INTEGER	否	定义访问令牌到期的秒数。如果提供，Vegas Lounge 将调用刷新令牌 API 以获取另一个令牌。默认为无到期。
refresh_token	TEXT(255)	否	用于在访问令牌过期时获取新访问令牌的令牌。默认为无法获取新访问令牌，这意味着访问令牌过期后，玩家将被重定向到运营商的登录页面以获取新授权码

错误响应

{
  "errorCode": 1002,
  "error": "Refresh token has expired"
}

参数	类型	必传	描述
errorCode	INTEGER	是	如果 success 为 false，运营商需要提供错误代码
error	TEXT(255)	是	如果 success 为 false，运营商需要提供错误信息

获取玩家信息 (必)

此 API 由 VegasLounge 发出请求，而运营商需按照指定格式返回响应信息。

返回有关玩家的信息。

请求示例

请求参数	类型	必传	描述
client_id	TEXT(40)	是	运营商商户 ID。

成功响应

真实玩家	试玩玩家
玩家类型参数 `playerType` 为 `REAL` (默认值)	玩家类型参数 `playerType` 为 `TEST`

真实玩家

{
    "playerId": "a3u",
    "sessionId": "HfuXQCzhIn",
    "currency": "USD",
    "balance": 405.64,
    "language": "zh_CN",
    "playerName": "highroller335",
    "avatarUrl": "https://img.operator.com/avatar.png",
    "homeUrl": "https://www.operator.com"
}

试玩玩家

{
    "playerId": "ftp123",
    "sessionId": "HfuXQCzhIn",
    "currency": "CNY",
    "balance": 1000.00,
    "language": "zh_CN",
    "playerName": "freetoplay123",
    "playerType": "TEST"
}

响应参数	类型	必传	描述
playerId	TEXT(255)	是	玩家账号
sessionId	TEXT(255)	是	会话 ID
currency	TEXT(3)	是 `免转钱包` 否 `转账钱包`	ISO 4217 货币代码。参见支持的语言和货币
balance	DECIMAL(20, 4)	是 `免转钱包` 否 `转账钱包`	玩家当前余额，以玩家的货币表示
language	TEXT(255)	是	玩家使用的语言
playerName	TEXT(255)	否	玩家名称
avatarUrl	TEXT(255)	否	玩家头像的链接 L。此链接是需要 HTTPS 协议支持
homeUrl	TEXT(255)	否	当玩家点击"首页"按钮时应用程序重定向的 URL
playerType	TEXT(4)	否	玩家类型： `REAL` （默认值） `TEST` 用于免费试玩玩家
partner	TEXT(255)	请看描述栏	运营商下线 ID 是对于使用多个 `clientPartner` 设置的单个 `clientId` 的客户，需要使用 `clientPartner` 参数。否对于没有 `clientPartner` 设置的客户，则不需要使用该参数。 `clientPartner` 参数用于区分操作中不同部分的流量。在单一运营商设置中，通常不使用 `clientPartner` 参数，因此它不是必需的。然而，对于拥有多个业务分段和预定义 `clientPartner` 配置的运营商,包网网或聚合商等，`clientPartner` 参数是必须的。

错误响应

{
  "errorCode": 1001,
  "error": "Authorization token has expired"
}

参数	类型	必传	描述
errorCode	INTEGER	是	如果 success 为 false，运营商需要提供错误代码
error	TEXT(255)	是	如果 success 为 false，运营商需要提供错误信息

转账钱包 TRANSFER WALLET

转账钱包需玩家手动将资金转入和转出 Vegas Lounge，此功能不能与免转钱包 API 结合使用。

API 概述

	API 类别	示例端点	描述	可见性	必传
转账钱包	入款	https://pl.vegaslounge.live/operator/deposit	将余额从转入游戏钱包。	IP 受限	是
	提款	https://pl.vegaslounge.live/operator/withdrawal	将余额从游戏钱包转出。	IP 受限	是
	获取玩家余额	https://pl.vegaslounge.live/operator/balance	获取玩家当前余额。	IP 受限	是
查询	查询玩家指定余额	https://pl.vegaslounge.live/operator/playersByBalance	查询余额大于一定数额的玩家。	IP 受限	否
	查询玩家最后存款投注金额	https://pl.vegaslounge.live/operator/betAmountSinceLastDeposit	查询玩家最后存款至当前的总投注金额。	IP 受限	否
	查询玩家投注总结	https://pl.vegaslounge.live/operator/report/getSummaryBet	查询玩家在指定时间段内的投注/收益/损失汇总。	IP 受限	否
	总损失报表	https://pl.vegaslounge.live/operator/report/getTotalLoss	查询玩家在指定时间段内的损失汇总。	IP 受限	否
	总投注记录	https://pl.vegaslounge.live/operator/report/getTotalLoss	查询玩家的所有投注记录。	IP 受限	否

本页所有 header 授权（Authorization）使用 authorize OAuth2.0 服务阶段的 base64(client_id + ":" + client_secret)。

入款

将玩家余额转入 VegasLounge 钱包的接口。

请求示例

请求参数	类型	必传	描述
clientId	TEXT（40）	是	运营商商户 ID
playerId	TEXT（255）	是	玩家账号
txId	TEXT（40）	是	交易代碼 ID (需為唯一值)
amount	DECIMAL（20，4）	是	玩家入款金额
currency	TEXT（3）	是	币别（ISO 4217 货币代码）

成功响应

{
    "balance": 994.43
}

响应参数	类型	描述
balance	DECIMAL(20，4）	交易处理后玩家的新余额。

错误响应

{
    "txId": "dc4adb70-e029-460a-8681-be72e720f64f",
    "errorCode": 1002,
    "error": "Insufficient funds",
    "balance": 994.43
}

响应参数	类型	描述
txId	TEXT（40）	交易代碼 ID (需為唯一值)
errorCode	INTEGER	错误码。
error	TEXT（255）	错误码信息
balance	DECIMAL（20，4）	交易成功后的玩家余额。

提款

将玩家余额从 VegasLounge 钱包转出的接口。

请求示例

请求参数	类型	必传	描述
clientId	TEXT（40）	是	运营商商户 ID
playerId	TEXT（255）	是	玩家账号
txId	TEXT（40）	是	交易代碼 ID (需為唯一值)
amount	DECIMAL（20，4）	是	玩家提款金额。
currency	TEXT（3）	是	ISO 4217 货币代码。

成功响应

{
    "balance": 994.00
}

响应参数	类型	描述
balance	DECIMAL（20，4）	交易处理后玩家的新余额。

错误响应

{
    "txId": "dc4adb70-e029-460a-8681-be72e720f64f",
    "errorCode": 1002,
    "error": "Insufficient funds",
    "balance": 994.43
}

响应参数	类型	描述
txId	TEXT（40）	此响应对应的交易 ID。
errorCode	INTEGER	错误码。
error	TEXT（255）	错误码信息
balance	DECIMAL（20，4）	交易成功后的玩家余额。

获取玩家余额

获取玩家当前余额的接口。

请求示例

请求参数	类型	必传	描述
clientId	TEXT（40）	是	运营商商户 ID。
playerId	TEXT（255）	是	玩家账号

成功响应

{
    "balance": 994.43
}

响应参数	类型	描述
balance	DECIMAL（20，4）	交易处理后玩家的新余额。

错误响应

错误将按照错误的情况而定，请到错误码列表了解更多。

查询玩家指定余额

返回余额不低于指定最小余额的玩家列表。

请求示例

请求参数	类型	必传	描述
clientId	TEXT（40）	是	运营商商户 ID
minBalance	DECIMAL（20，4）	是	最低余额
limit	INT	是	小于 1000
offset	INT	否	分页偏移，默认为 0
clientPartner	TEXT(40)	请看描述栏	运营商下线 ID 是对于使用多个 `clientPartner` 设置的单个 `clientId` 的客户，需要使用 `clientPartner` 参数。否对于没有 `clientPartner` 设置的客户，则不需要使用该参数。 `clientPartner` 参数用于区分操作中不同部分的流量。在单一运营商设置中，通常不使用 `clientPartner` 参数，因此它不是必需的。然而，对于拥有多个业务分段和预定义 `clientPartner` 配置的运营商,包网网或聚合商等，`clientPartner` 参数是必须的。

成功响应

{
  "players": [
    {"id": "player1", "balance": 99999},
    {"id": "player2", "balance": 88888}
  ],
  "hasMore": false
}

响应参数	描述
players	满足搜索条件的玩家列表，按照玩家在 playgon 开始玩的时间降序排列。
hasMore	表示是否还有满足搜索条件的更多玩家。

错误响应

错误将按照错误的情况而定，请到错误码列表了解更多。

查询玩家最后存款投注投注金额

返回特定玩家自上次存款以来的总投注金额。

请求示例

请求参数	类型	必传	描述
clientId	TEXT(40)	是	运营商商户 ID
playerId	TEXT(255)	是	玩家账号

成功响应

{
  "amount": 1994.43
}

响应参数	描述
amount	玩家自上次存款以来的总下注金额

错误响应

错误将按照错误的情况而定，请到错误码列表了解更多。

查询玩家投注总结

返回指定时段内玩家的总下注、总支付、总损失的接口

聚合算法
totalBet：sum（bet）	指定玩家进行的所有有效投注的总和
totalPayout：sum（payout）	指定玩家收到的所有有效支付的总和
totalLoss：sum（sum（case（game.bet-game.payout> 0）then（game.bet-game.payout）else 0）end）	对于玩家在此期间玩的每个游戏，如果支付金额低于投注金额，则将（投注金额 - payoutAmount）添加到 Totalloss，否则当前游戏的输为 0。

请求示例

请求参数	类型	必传	描述
clientId	TEXT（40）	是	运营商商户 ID
startDate	LONG	是	开始日期，以 Epoch 毫秒数为单位，（包含 00:00:00 时间内 00 秒也算入）
endDate	LONG	是	结束日期，以 Epoch 毫秒数为单位，不包含 00:00:00 时间内 00 秒不算入，查询时间不可超过 24 小时。
playerId	LONG	否	玩家账号
clientPartner	TEXT(40)	请看描述栏	运营商下线 ID 是对于使用多个 `clientPartner` 设置的单个 `clientId` 的客户，需要使用 `clientPartner` 参数。否对于没有 `clientPartner` 设置的客户，则不需要使用该参数。 `clientPartner` 参数用于区分操作中不同部分的流量。在单一运营商设置中，通常不使用 `clientPartner` 参数，因此它不是必需的。然而，对于拥有多个业务分段和预定义 `clientPartner` 配置的运营商,包网网或聚合商等，`clientPartner` 参数是必须的。

成功响应

{
  "data": [
    {"userId": "player1", "totalBet": 40, "totalPayout": 0, "totalLoss": 40},
    {"userId": "player2", "totalBet": 150, "totalPayout": 97.5, "totalLoss": 52.5}
  ],
  "errorCode": null,
  "error": null
}

响应参数	描述
data	给定时段内玩家的总下注、总支付、总损失
errorCode	错误代码（如果有）
error	错误描述（如果有）

错误响应

错误将按照错误的情况而定，请到错误码列表了解更多。

查询总损失总结

返回给定时段内玩家的总损失的接口。

聚合算法	描述
TotalBet：SUM(bets.betAmount)	指定玩家进行的所有有效下注的总和。
TotalPayout：SUM(bets.payoffAmount）	指定玩家收到的所有有效支付的总和。
totalLoss: SUM(CASE WHEN bets.payoffAmount = 0 THEN bets.betAmount ELSE 0 END)	无赢的投注总额

请求示例

请求参数	类型	必传	描述
clientId	TEXT（40）	是	运营商商户 ID
startDate	LONG	是	开始日期，以 Epoch 毫秒数为单位，（包含 00:00:00 时间内 00 秒也算入）
endDate	LONG	是	结束日期，以 Epoch 毫秒数为单位。不包含 00:00:00 时间内 00 秒不算入。查询时间不可超过 24 小时。
playerId	LONG	否	玩家账号
clientPartner	TEXT(40)	请看描述栏	运营商下线 ID 是对于使用多个 `clientPartner` 设置的单个 `clientId` 的客户，需要使用 `clientPartner` 参数。否对于没有 `clientPartner` 设置的客户，则不需要使用该参数。 `clientPartner` 参数用于区分操作中不同部分的流量。在单一运营商设置中，通常不使用 `clientPartner` 参数，因此它不是必需的。然而，对于拥有多个业务分段和预定义 `clientPartner` 配置的运营商,包网网或聚合商等，`clientPartner` 参数是必须的。

成功响应

{
    "errorCode": null,
    "error": null,
    "data": [
        {
            "userId": "ANGrlacjsghl",
            "totalBet": 45000,
            "totalLoss": 45000,
            "totalPayout": 0
        },
        {
            "userId": "ACOqaws1565",
            "totalBet": 342000,
            "totalLoss": 157000,
            "totalPayout": 300000
        }
    ]
}

响应参数	描述
data	给定时段内玩家的总下注、总支付、总损失
errorCode	错误代码（如果有）
error	错误描述（如果有）

错误响应

错误将按照错误的情况而定，请到错误码列表了解更多。

投注报告

返回给定时段内的投注报告列表。

请求示例

请求参数	类型	是否	描述
clientId	`TEXT（40）`	是	运营商商户 ID
startDate	`LONG`	是	开始日期，以 Epoch 毫秒数为单位，（包含 00:00:00 时间内 00 秒也算入）
endDate	`LONG`	是	结束日期，以 Epoch 毫秒数为单位。不包含 00:00:00 时间内 00 秒不算入。查询时间不可超过 24 小时。
partnerIds	`String`	否	想要过滤的合作伙伴，可以多次指定，例如，&partnerIds=red&partnerIds=blue&partnerIds=white
clientPartner	TEXT(40)	请看描述栏	运营商下线 ID 是对于使用多个 `clientPartner` 设置的单个 `clientId` 的客户，需要使用 `clientPartner` 参数。否对于没有 `clientPartner` 设置的客户，则不需要使用该参数。 `clientPartner` 参数用于区分操作中不同部分的流量。在单一运营商设置中，通常不使用 `clientPartner` 参数，因此它不是必需的。然而，对于拥有多个业务分段和预定义 `clientPartner` 配置的运营商,包网网或聚合商等，`clientPartner` 参数是必须的。

成功响应

[{
    "uid": "cs1.d7zk:sha.knst",
    "createdDate": 1705017604,
    "gameUid": "sha.knst",
    "gameReferenceCode": "NYITR7WR",
    "gameStartTime": 1705017587707,
    "gameEndTime": 1705017615928,
    "gameType": "BACCARAT",
    "playerUid": "cs1.d7zk",
    "运营商商户下线ID": "84ae5b25-f24b-4f5b-859e-99aba79c5def",
    "currency": "USD",
    "status": "PAID",
    "totalBetAmount": 39.0,
    "totalPayoffAmount": 0.0
}]

响应参数	描述
uid	唯一注单号
createdDate	记录创建日期的时间戳
gameUid	唯一游戏局号(内部使用)
gameReferenceCode	局号
gameStartTime	游戏开始时间的时间戳
gameEndTime	游戏结束时间的时间戳
gameType	游戏类型
playerUid	玩家唯一账号(内部使用)
运营商商户下线 ID	玩家账号
currency	进行投注的货币
status	投注的状态， `PAID` `REFUNDED`
totalBetAmount	总投注金额
totalPayoffAmount	如果投注状态为 PAID，则为玩家赢得的总金额

错误响应

错误将按照错误的情况而定，请到错误码列表了解更多。

免转钱包 SEAMLESS WALLET

免转钱包（或通用钱包）涉及投注和支付直接与运营商自己的钱包进行交互。此方法不能与转账钱包 API 结合使用。

API 概述

本节概述了运营商必须向 Vegas Lounge 提供哪些才能成功对接。

API 类别	API	示例端点	描述	可见性	必传
免转钱包	投注	https://api.operator.com/bet	用户下注（从运营商账户中扣款）。	IP 限制	是
	支付	https://api.operator.com/payoff	用户赢得奖金。	IP 限制	是
	撤销交易	https://api.operator.com/reverse	错误/错误更正（信用/借记）。	IP 限制	是
	获取余额	https://api.operator.com/balance	返回用户的当前余额。	IP 限制	是

¶ 实施此功能将为玩家提供最佳体验。
§ 此方法是幂等的。

投注

此 API 由 VegasLounge 发出请求，而运营商需按照指定格式返回响应信息。

此端点支持高并发量且延迟最小，以确保最佳玩家体验。对于每个玩家，每场游戏只会发送一个投注请求。

请求示例

请求参数

参数	类型	必传	描述
txId	TEXT(40)	是	此交易的全局唯一交易 ID
tileId	TEXT(40)	是	对应的 tile ID。代表玩家点击进入游戏的按钮。
tableId	TEXT(40)	是	桌子的 ID。
live	BOOLEAN	是	如果为 `true` ，则为真人荷官桌子
gameType	TEXT(40)	是	其中之一：BACCARAT、ROULETTE、BLACKJACK
gameId	TEXT(255)	是	内部游戏 ID。请使用 gameCode。
gameCode	TEXT(255)	是	游戏参考代码。
minBet	DECIMAL(20, 4)	是	桌子的最低下注金额
maxBet	DECIMAL(20, 4)	是	桌子的最高下注金额
bets	数组	是	必传提供至少一个。
betType	TEXT(40)	是	设置下注类型
betAmount	DECIMAL(20, 4)	是	玩家货币中的下注金额。
totalBetAmount	DECIMAL(20, 4)	是	玩家货币中的总下注金额。
pays	DECIMAL(20, 4)	是	此下注类型的赔付金额。

下注取消和退款场景

在以下场景中会立即退款：

如果在 3 秒内未收到响应

如果响应包含不在保留错误代码列表中的错误代码

幂等

此 API 必传处理多次接收相同消息的情况。

成功响应

{
  "txId": "dc4adb70-e029-460a-8681-be72e720f64f",
  "balance": 994.43
}

参数	类型	必传	描述
txId	TEXT(40)	是	此响应所属的交易 ID
balance	DECIMAL(20, 4)	是	此交易后的玩家新余额

错误响应

{
  "txId": "dc4adb70-e029-460a-8681-be72e720f64f",
  "errorCode": 1002,
  "error": "Insufficient funds",
  "balance": 994.43
}

参数	类型	必传	描述
txId	TEXT(40)	是	此响应所属的交易 ID
errorCode	INTEGER	是	如果成功为 false，运营商必传提供代码指示错误类型。
error	TEXT(255)	是	如果成功为 false，运营商必传提供描述指示出了什么问题。
balance	DECIMAL(20, 4)	否	玩家当前余额

支付

此 API 由 VegasLounge 发出请求，而运营商需按照指定格式返回响应信息。

对于奖金，每场游戏每个玩家只会发送一个支付请求。

请求

参数

参数	类型	必传	描述
txId	TEXT(40)	是	此交易的全局唯一交易 ID
tileId	TEXT(40)	是	对应的 tile ID。代表玩家点击进入游戏的按钮。
tableId	TEXT(40)	是	桌子的 ID。
live	BOOLEAN	是	如果为 true，则为真人荷官桌子
gameType	TEXT(40)	是	其中之一：BACCARAT、ROULETTE、BLACKJACK
gameId	TEXT(255)	是	内部游戏 ID。请使用 gameCode。
gameCode	TEXT(255)	是	游戏参考代码。
minBet	DECIMAL(20, 4)	是	桌子的最低下注金额
maxBet	DECIMAL(20, 4)	是	桌子的最高下注金额
betType	TEXT(40)	是	设置下注类型
payoffAmount	DECIMAL(20, 4)	是	支付给玩家的金额。如果 payoffAmount 为 0，则玩家输了。
betAmount	DECIMAL(20, 4)	是	玩家货币中的下注金额。
totalBetAmount	DECIMAL(20, 4)	是	玩家货币中的总下注金额。
totalPayoffAmount	DECIMAL(20, 4)	是	支付给玩家的总金额。
refTxIds	TEXT(40)	是	引用的交易 ID 数组（下注交易 ID）

幂等

此 API 必传处理多次接收相同消息的情况。

成功响应

{
  "txId": "83cf02f7-5045-479b-9d9a-26807f168b32",
  "balance": 994.43
}

参数	类型	必传	描述
txId	TEXT(40)	是	此响应所属的交易 ID
balance	DECIMAL(20, 4)	是	此交易后的玩家新余额

错误响应

{
  "txId" : "83cf02f7-5045-479b-9d9a-26807f168b32",
  "errorCode": 1050,
  "error": "Timed out",
  "balance": 994.43
}

参数	类型	必传	描述
txId	TEXT(40)	是	此响应所属的交易 ID
errorCode	INTEGER	是	如果成功为 false，运营商必传提供代码指示错误类型。
error	TEXT(255)	是	如果成功为 false，运营商必传提供描述指示出了什么问题。
balance	DECIMAL(20, 4)	否	玩家当前余额

撤销交易

此 API 由 VegasLounge 发出请求，而运营商需按照指定格式返回响应信息。

用于系统错误、游戏取消和争议解决的信用/借记玩家账户。

请求示例

参数

参数	类型	必传	描述
txId	TEXT(40)	是	此交易的全局唯一交易 ID
tileId	TEXT(40)	是	对应的 tile ID。代表玩家点击进入游戏的按钮。
tableId	TEXT(40)	是	桌子的 ID。
live	BOOLEAN	是	如果为 true，则为真人荷官桌子
gameType	TEXT(40)	是	其中之一：BACCARAT、ROULETTE、BLACKJACK
gameId	TEXT(255)	是	内部游戏 ID。请使用 gameCode。
gameCode	TEXT(255)	是	游戏参考代码。
minBet	DECIMAL(20, 4)	是	桌子的最低下注金额
maxBet	DECIMAL(20, 4)	是	桌子的最高下注金额
reversalTxId	TEXT(40)	是	要撤销的交易 ID
reversalTxType	TEXT(40)	是	其中之一：BET、PAYOFF
reversalReason	TEXT(255)	是	撤销原因（例如：响应超时）
reversalAmount	DECIMAL(20, 4)	是	撤销的金额。可以是整个游戏的下注金额（正数）或游戏收益的 50%（负数）
totalReversalAmount	DECIMAL(20, 4)	是	撤销的总金额

对同一交易的多次撤销
此 API 必传处理对同一交易执行多次撤销的情况。

幂等

此 API 必传处理多次接收相同消息的情况。

成功响应

{
  "txId": "aea6f87a-fb82-4966-8696-5eb32c3bb0f4",
  "balance": 994.43
}

参数	类型	必传	描述
txId	TEXT(40)	是	此响应所属的交易 ID
balance	DECIMAL(20, 4)	是	此交易后的玩家新余额

错误响应

{
  "txId": "aea6f87a-fb82-4966-8696-5eb32c3bb0f4",
  "errorCode": 1050,
  "error": "Timed out",
  "balance": 994.43
}

参数	类型	必传	描述
txId	TEXT(40)	是	此响应所属的交易 ID
errorCode	INTEGER	是	如果成功为 false，运营商必传提供代码指示错误类型。
error	TEXT(255)	是	如果成功为 false，运营商必传提供描述指示出了什么问题。
balance	DECIMAL(20, 4)	否	玩家当前余额

获取余额

返回玩家的余额及其货币。

请求

参数

参数	类型	必传	描述
client_id	TEXT(40)	是	运营商和拉斯维加斯休息室之间同意的 client_id 列表之一。

成功响应

{
  "balance": 994.43
}

参数	类型	必传	描述
balance	DECIMAL(20, 4)	是	此交易后的玩家新余额

错误响应

{
  "errorCode": 1050,
  "error": "Timed out",
}

参数	类型	必传	描述
errorCode	INTEGER	是	如果成功为 `false` ，运营商必传提供代码指示错误类型。
error	TEXT(255)	是	如果成功为 false，运营商必传提供描述指示出了什么问题。

报表 Report API

本⽂档旨在提供额外的报表 API。

本⽂档⾯向具有基本 API 和 HTTP 集成知识的技术读者。

API 概述

概述	⽰例端点	描述
验证交易	https://pl.vegaslounge.live/operator/report/verifyTransactions?clientId=bbn88&startDate=1688210909000&endDate=1688418744000	提供指定时间段的转账交易列表。
检查交易	https://pl.vegaslounge.live/operator/report/checkTransaction?clientId=bbn88&txId=123	提供交易状态和余额。
订单链接	https://pl.vegaslounge.live/operator/report/orderLink?clientId=bbn88&gameId=sha.1x9z&playerId=455673734	提供到游戏历史页⾯的链接。
验证交易摘要	https://pl.vegaslounge.live/operator/report/verifyTransactionsSummary?clientId=bbn88&startDate=1688210909000&endDate=1688418744000	提供指定时间段的交易摘要。
详细投注报表	https://pl.vegaslounge.live/operator/vl/bbn88/replay/transfer?startDay=1688210909000&endate=1688418744000	提供指定时间段所有玩家的详细投注记录（包括细节）。
投注报表	https://pl.vegaslounge.live/operator/report/bets?clientId=bbn88&startDate=1705017600000&endDate=1705104000000	提供指定时间段所有玩家的投注记录

获取转账记录

⼀个返回指定时间段所有玩家的转⼊转出列表的接口。

请求示例

授权使⽤从 OAuth2.0 服务阶段获取的 base64(client_id + ":" + client_secret)。

参数

参数	类型	必传	描述
clientId	TEXT(40)	是	运营商商户ID
startDate	LONG	是	开始⽇期，以Epoch毫秒数为单位，（包含00:00:00时间内,00秒也算⼊）
endDate	LONG	是	结束⽇期，以Epoch毫秒数为单位。不包含00:00:00时间内

成功响应

{
  "errorCode": null,
  "error": null,
  "data": [
    {
      "playerId": "389273",
      "type": "TRANSFER_IN",
      "amount": 10,
      "currency": "CNY",
      "newBalance": 10,
      "createdDate": 1688693039316,
      "txId": "2800"
    },
    {
      "playerId": "389273",
      "type": "TRANSFER_OUT",
      "amount": -5.0005,
      "currency": "CNY",
      "newBalance": 4.9995,
      "createdDate": 1688697136643,
      "txId": "2801"
    }
  ]
}

参数	类型	必传	描述
data	ARRAY	是	代表指定时间段交易的数据列表
errorCode	INTEGER	否	错误代码
error	STRING	否	错误描述

错误响应

{
  "errorCode": 403,
  "error": "Unauthorized."
}

检查交易

⼀个返回交易状态和余额的接口。

请求示例

授权使⽤从 OAuth2.0 服务阶段获取的 base64(client_id + ":" + client_secret)。

参数	类型	必传	描述
clientId	TEXT(40)	是	运营商商户ID
txId	TEXT(40)	是	交易 ID

成功响应

{
  "balance": 10,
  "status": "SUCCESS",
  "errorCode": null,
  "error": null
}

参数	类型	必传	描述
balance	DECIMAL(20, 4)	是	成功交易后的玩家余额
status	STRING	是	交易状态。可⽤值：SUCCESS、FAILURE
errorCode	INTEGER	否	错误代码
error	STRING	否	错误描述

错误响应

{
  "errorCode": 403,
  "error": "Unauthorized."
}

游戏详情

⼀个返回带有回合详情的游戏历史页⾯链接的接口。

请求示例

授权使⽤从 OAuth2.0 服务阶段获取的 base64(client_id + ":" + client_secret)。

请求参数	类型	必传	描述
clientId	STRING	是	运营商商户ID
gameId	STRING	是	唯⼀游戏 ID
playerId	STRING	是	玩家账号
lang	STRING	否	语⾔参数，⽀持 zh、ko、uk、ru

请求⽰例：

成功响应

{
  "url": "https://pl.vegaslounge.live/operator/gameHistory?token=FcyerS5mKi&env_dp=blue",
  "errorCode": null,
  "error": null
}

响应参数	类型	必传	描述
url	STRING	是	游戏历史页⾯ URL
errorCode	INTEGER	否	错误代码
error	STRING	否	错误描述

错误响应

{
  "errorCode": 403,
  "error": "Unauthorized."
}

验证交易摘要

⼀个返回指定时间段的交易摘要的接口。

请求示例

授权使⽤从 OAuth2.0 服务阶段获取的 base64(client_id + ":" + client_secret)。

参数	类型	必传	描述
clientId	TEXT(40)	是	运营商商户ID
startDate	LONG	是	开始⽇期，以Epoch毫秒数为单位，（包含00:00:00时间内 00秒也算⼊）
endDate	LONG	是	结束⽇期，以Epoch毫秒数为单位。不包含00:00:00时间内, 00秒不算⼊。查询时间不可超过24⼩时。

成功响应

{
  "errorCode": null,
  "error": null,
  "data": [
    {
      "totalBet": 75,
      "totalLoss": 65,
      "totalPayout": 19.75,
      "count": 15,
      "currency": "CNY"
    }
  ]
}

参数	类型	必传	描述
data	ARRAY	是	指定时段内玩家数据列表
errorCode	INTEGER	否	错误代码
error	STRING	否	错误描述

错误响应

{
  "errorCode": 403,
  "error": "Unauthorized."
}

详细投注报表

⼀个返回给指定时间段的详细投注报表列表接口。

请求示例

授权使⽤从 OAuth2.0 服务阶段获取的 base64(client_id + ":" + client_secret)。

参数	类型	必传	描述
clientId	TEXT(40)	是	运营商商户ID
startDate	LONG	是	开始⽇期，以Epoch毫秒数为单位，（包含00:00:00时间内, 00秒也算⼊）
endDate	LONG	是	结束⽇期，以Epoch毫秒数为单位。不包含00:00:00时间内 00秒不算⼊。查询时间不可超过24⼩时。

成功响应

[
  {
    "gameUid": "sha.b4",
    "gameReferenceCode": "NX75RNDS",
    "gameType": "BACCARAT",
    "gameResultType": "BANKER_WIN",
    "gameplay": {
      "BaccaratGameplay": {
        "betEndDate": 1670867109410,
        "bankerHand": {
          "cards": {
            "0": "S_6",
            "1": "C_9",
            "2": "C_4"
          },
          "cancelledCards": []
        },
        "playerHand": {
          "cards": {
            "0": "H_8",
            "1": "H_8"
          },
          "cancelledCards": []
        },
        "burnCards": {},
        "betTypeToResultType": {
          "BC_KINGS": "BC_LOSE",
          "BC_PLAYER_PAIR": "BC_WIN",
          "BC_PLAYER": "BC_LOSE",
          "BC_PLAYER_TIGER": "BC_LOSE",
          "BC_BANKER": "BC_WIN",
          "BC_BANKER_NO_COMMISSION": "BC_WIN",
          "BC_BANKER_PAIR": "BC_LOSE",
          "BC_TIE": "BC_LOSE"
        }
      }
    },
    "dealerName": null,
    "startDate": 1670867088874,
    "endDate": 1670867122558,
    "gameRecordingUrl": null,
    "playersBets": [
      {
        "playerId": "cs1.sf",
        "playerName": "Test",
        "currency": "USD",
        "totalBetAmount": 100,
        "totalPayoffAmount": 50,
        "bets": [
          {
            "txId": "8cc24ccc-ae04-11ed-afa1-0242ac120002",
            "betAmount": 10,
            "payoffAmount": 2,
            "theoreticalWin": 1,
            "rejectionCode": 0,
            "playerBetStatus": "PAID",
            "resultType": "BC_WIN",
            "seatId": 2,
            "betType": "BC_BANKER",
            "handId": 1
          }
        ]
      }
    ]
  }
]

请求参数

参数	类型	必传	描述
data	ARRAY	是	代表给定指定时间段交易的数据列表
errorCode	INTEGER	否	错误代码
error	STRING	否	错误描述

响应参数	描述
gameUid	每个游戏的唯⼀系统标识符
gameReferenceCode	在⽤户界⾯上显⽰的游戏 ID
gameType	游戏类型，Baccarat百家乐 , Roulette,轮盘 Blackjac、⼆⼗⼀点
gameResultType	游戏结果
gameplay	游戏结果详情
betEndDate	关闭投注时的 Epoch 时间戳
dealerName	分配到桌⼦的荷官名称，若为电⼦桌则返回 NULL
startDate	游戏开始时间的时间戳
endDate	游戏结束时间的时间戳
gameRecordingUrl	存储游戏记录的 URL 地址（电⼦桌不可⽤）
playersBets	注册投注详情
playerId	玩家在系统中的唯⼀标识符（内部玩家 ID）
playerName	运营商⽅玩家 ID
currency	玩家账户使⽤的货币
totalBetAmount	投注总⾦额
totalPayoffAmount	派彩总⾦额
bets	游戏回合投注详情的数组
txId	交易 ID
betAmount	投注类型的投注⾦额
payoffAmount	投注类型的⽀付⾦额
theoreticalWin	计算的数学期望胜利（赌场优势*总投注）
rejectionCode	若投注被拒绝则返回错误代码。若未被拒绝则返回 0
playerBetStatus	⽀付状态。可为"PAID"或"Pending"
resultType	游戏结果类型：BC_WIN（百家乐赢）、BC_LOSE（百家乐输）、BC_PUSH（百家乐平局）、RL_WIN（轮盘赢）、RL_LOSE （轮盘输）、BJ_WIN（⼆⼗⼀点赢）、BJ_LOSE（⼆⼗⼀点输）等。
seatId	⾃动分配的座位号（未使⽤）
betType	在游戏中投注的类型
handId	当玩多个投注点时的计数器（仅适⽤于⼆⼗⼀点）

错误响应

{
  "errorCode": 403,
  "error": "Unauthorized."
}

投注报表

⼀个返回给定指定时间段的投注记录的接口。

请求示例

授权使⽤从 OAuth2.0 服务阶段获取的 base64(client_id + ":" + client_secret)。

参数	类型	必传	描述
clientId	TEXT(40)	是	运营商商户ID
startDate	LONG	是	开始⽇期，以Epoch毫秒数为单位，（包含00:00:00时间内,00秒也算⼊）
endDate	LONG	是	结束⽇期，以Epoch毫秒数为单位。不包含00:00:00时间内. 00秒不算⼊。查询时间不可超过24⼩时。

成功响应

[
  {
    "uid": "cs1.d7zk:sha.knst",
    "createdDate": 1705017604,
    "gameUid": "sha.knst",
    "gameReferenceCode": "NYITR7WR",
    "gameStartTime": 1705017587707,
    "gameEndTime": 1705017615928,
    "gameType": "BACCARAT",
    "playerUid": "cs1.d7zk",
    "clientPlayerId": "84ae5b25-f24b-4f5b-859e-99aba79c5def",
    "currency": "USD",
    "status": "PAID",
    "totalBetAmount": 39,
    "totalPayoffAmount": 0
  }
]

参数	描述
uid	玩家在游戏中所下投注的唯⼀标识符
createdDate	记录创建⽇期的时间戳
gameUid	唯⼀游戏局号
gameReferenceCode	局号
gameStartTime	游戏开始时间的时间戳
gameEndTime	游戏结束时间的时间戳
gameType	游戏类型
playerUid	玩家唯⼀账号(内部使⽤)
clientPlayerId	玩家账号
currency	进⾏投注的货币
status	投注的状态，PAID REFUNDED
totalBetAmount	投注总⾦额
totalPayoffAmount	如果投注状态为 PAID，则为玩家赢得的总⾦额

错误响应

{
      "errorCode": 403,
      "error": "Unauthorized."
}

附录

某些 API 方法需要处理接收到相同消息的情况（由于请求者在出现错误时重试）。除了保留错误中概述的错误外，在每个错误发生时，Vegas Lounge 将以增加的延迟重试请求，最多每天一次。例如：

延迟 0 秒

延迟 1 秒

延迟 2 秒

延迟 4 秒

延迟 8 秒

......

延迟 1 天（最大）

请注意，Vegas Lounge将一直重试，直到：

成功响应

返回以下其中的错误码信息

访问令牌过期且无法获取新令牌

错误码对应

以下列表描述了 Vegas Lounge能够处理的错误代码。

响应参数	类型	描述
errorCode	INTEGER	错误码
error	TEXT（255）	错误码信息

错误	HTTP 响应	错误代码	错误响应
交易已处理	409	1000	`{ "errorCode": 1000, "error": "Transaction has already been processed"}`
未经授权	401	1001	`{ "errorCode": 1001, "error": "Authorization code is not valid."}`
余额不足	400	1002	`{ "errorCode": 1002,"error": "Insufficient balance"}`
服务不可用	200	1003	`{ "errorCode": 1003, "error": "Game not configured for this platform"}`
令牌过期	401	1004	`{ "errorCode": 1004, "error": "Auth token has expired"}`
账户已禁用	401	1005	`{ "errorCode": 1005, "error": "The account is disabled."}`
下注不存在	400	1006	`{ "errorCode": 1006, "error": "The reverse bets requested don't exist."}`
验证错误	400	1007	`{ "errorCode": 1007, "error": "Validation error. Don't retry."}`
玩家不存在		404	`{ "errorCode": 403,"error": "Player not found""}`
未授权		403	`{ "errorCode":403, "error":"Unauthorized.""}`

百家乐

投注类别	说明
BC_BANKER	庄
BC_PLAYER	闲
BC_TIE	和
BC_BANKER_PAIR	庄对子
BC_PLAYER_PAIR	闲对子

老虎红利百家乐

投注类别	说明
BC_BANKER_NO_COMMISSION	庄
BC_PLAYER	闲
BC_TIE	和
BC_KINGS	老虎7

二十一点

投注类别	说明
BJ_BET	主注
BJ_INSURANCE	保险注
BJ_DOUBLE	双倍投注
BJ_SPLIT	分注

轮盘

直注

投注类型	投注类型
RL_S00	RL_S18
RL_S0	RL_S19
RL_S1	RL_S20
RL_S2	RL_S21
RL_S3	RL_S22
RL_S4	RL_S23
RL_S5	RL_S24
RL_S6	RL_S25
RL_S7	RL_S26
RL_S8	RL_S27
RL_S9	RL_S28
RL_S10	RL_S29
RL_S11	RL_S30
RL_S12	RL_S31
RL_S13	RL_S32
RL_S14	RL_S33
RL_S15	RL_S34
RL_S16	RL_S35
RL_S17	RL_S36

分注

投注类别	投注类别	投注类别	投注类别	投注类别	投注类别
RL_SPL0_00	RL_SPL15_18	RL_SPL1_2	RL_SPL00_2	RL_SPL16_19	RL_SPL2_3
RL_SPL00_3	RL_SPL17_20	RL_SPL4_5	RL_SPL0_1	RL_SPL18_21	RL_SPL5_6
RL_SPL0_2	RL_SPL19_22	RL_SPL7_8	RL_SPL0_3	RL_SPL20_23	RL_SPL8_9
RL_SPL1_4	RL_SPL21_24	RL_SPL10_11	RL_SPL2_5	RL_SPL22_25	RL_SPL11_12
RL_SPL3_6	RL_SPL23_26	RL_SPL13_14	RL_SPL4_7	RL_SPL24_27	RL_SPL14_15
RL_SPL5_8	RL_SPL25_28	RL_SPL16_17	RL_SPL6_9	RL_SPL26_29	RL_SPL17_18
RL_SPL7_10	RL_SPL27_30	RL_SPL19_20	RL_SPL8_11	RL_SPL28_31	RL_SPL20_21
RL_SPL9_12	RL_SPL29_32	RL_SPL22_23	RL_SPL10_13	RL_SPL30_33	RL_SPL23_24
RL_SPL11_14	RL_SPL31_34	RL_SPL25_26	RL_SPL12_15	RL_SPL32_35	RL_SPL26_27
RL_SPL13_16	RL_SPL33_36	RL_SPL28_29	RL_SPL14_17	RL_SPL29_30	RL_SPL31_32
RL_SPL32_33	RL_SPL34_35	RL_SPL35_36

街注

投注类别	投注类别
RL_STR00_2_3	RL_STR13
RL_STR00_0_2	RL_STR16
RL_STR0_1_2	RL_STR19
RL_STR0_2_3	RL_STR22
RL_STR1	RL_STR25
RL_STR4	RL_STR28
RL_STR7	RL_STR31
RL_STR10	RL_STR34

角注

投注类别	投注类别
RL_COR0	RL_COR17
RL_COR1	RL_COR19
RL_COR2	RL_COR20
RL_COR4	RL_COR22
RL_COR5	RL_COR23
RL_COR7	RL_COR25
RL_COR8	RL_COR26
RL_COR10	RL_COR28
RL_COR11	RL_COR29
RL_COR13	RL_COR31
RL_COR14	RL_COR32
RL_COR16

Alley Bets

投注类别	投注类别
RL_ALL00	RL_ALL16
RL_ALL1	RL_ALL19
RL_ALL4	RL_ALL22
RL_ALL7	RL_ALL25
RL_ALL10	RL_ALL28
RL_ALL13	RL_ALL31

外注

投注类别	说明
RL_COL1	1st Column
RL_COL2	2nd Column
RL_COL3	3rd Column
RL_DOZ1	1st 12
RL_DOZ2	2nd 12
RL_DOZ3	3rd 12
RL_EVEN	Even
RL_ODD	Odd
RL_RED	Red
RL_BLACK	Black
RL_BET_1_18	First 18
RL_BET_19_36	Last 18

VEGASLOUNGE API集成指南手册

环境#

术语#

集成方式#

支持的语言和货币#

语言列表#

货币列表#

客户端 CLIENT API#

支持的设备和平台#

操作系统支持版本#

浏览器支持版本#

启动游戏#

游戏入口#

子大厅#

主大厅#

牌桌#

API 概述#

获取游戏列表#

请求示例#

成功响应#

错误响应#

游戏列表#

身份验证 Authentication API#

API 概述#

授权#

登出#

验证授权 (必)#

请求示例#

成功响应#

错误响应#

刷新令牌#

请求示例#

成功响应#

错误响应#

获取玩家信息 (必)#

请求示例#

成功响应#

错误响应#

转账钱包 TRANSFER WALLET#

API 概述#

入款#

请求示例#

成功响应#

错误响应#

提款#

请求示例#

成功响应#

错误响应#

获取玩家余额#

请求示例#

成功响应#

错误响应#

查询玩家指定余额#

请求示例#

成功响应#

错误响应#

查询玩家最后存款投注投注金额#

请求示例#

成功响应#

错误响应#

查询玩家投注总结#

请求示例#

成功响应#

错误响应#

查询总损失总结#

请求示例#

成功响应#

错误响应#

投注报告#

请求示例#

成功响应#

错误响应#

免转钱包 SEAMLESS WALLET#

API 概述#

投注#

请求示例#

幂等#

成功响应#

错误响应#

支付#

环境

术语

集成方式

支持的语言和货币

语言列表

货币列表

客户端 CLIENT API

支持的设备和平台

操作系统支持版本

浏览器支持版本

启动游戏

游戏入口

子大厅

主大厅

牌桌

API 概述

获取游戏列表

请求示例

成功响应

错误响应

游戏列表

身份验证 Authentication API

API 概述

授权

登出

验证授权 (必)

请求示例

成功响应

错误响应

刷新令牌

请求示例

成功响应

错误响应

获取玩家信息 (必)

请求示例

成功响应

错误响应

转账钱包 TRANSFER WALLET

API 概述

入款

请求示例

成功响应

错误响应

提款

请求示例

成功响应

错误响应

获取玩家余额

请求示例

成功响应

错误响应

查询玩家指定余额

请求示例

成功响应

错误响应

查询玩家最后存款投注投注金额

请求示例

成功响应

错误响应

查询玩家投注总结

请求示例

成功响应

错误响应

查询总损失总结

请求示例

成功响应

错误响应

投注报告

请求示例

成功响应

错误响应

免转钱包 SEAMLESS WALLET

API 概述

投注

请求示例

幂等

成功响应

错误响应

支付

请求