首页

API 域名:https://api.pg-game.xyz(以实际分配为准,不要末尾 /)

本接口提供游戏代码列表、PG 电子游艺启动、额度转入转出、余额查询与注单拉取。运营商持有一对 agentToken + secretKey 即可对接自有大厅。

接口说明

  1. 所有接口都是 POST,Header 固定 Content-Type: application/json。
  2. 凭证放在 JSON 请求体,不放 Header。
  3. agentToken、secretKey 在代理后台开通后发放,请勿泄露。
  4. 建议超时设置为 30 秒以上;超时后应用同一 orderId重试转账。
  5. 金额保留 2 位小数,须大于 0。
  6. 数据返回格式统一为 JSON。
  7. 时区按服务器本地时间(一般 UTC+8)。
  8. 玩家账号 user_code 由你方保证唯一;首次转入会自动开户,无需单独注册。
默认钱包模式为 转入转出:主钱包在你方,游戏钱包在本平台。局中下注只变动玩家游戏余额;盈亏在转入/转出时结算到代理额度池。退出后请再转回主钱包。

请求返回正确示例

{
  "status": 1,
  "msg": "SUCCESS"
}

status = 1 表示成功,其它为失败(通常 status: 0)。启动游戏失败时偶发 status: "error"。

状态码

msg说明
SUCCESS成功
INVALID_AGENTagentToken / secretKey 错误
INVALID_PARAMS缺少必填字段
INVALID_TYPE转换类型不是 1 或 2
INVALID_AMOUNT金额非法(须为大于 0 的数字)
INVALID_ORDER_ID缺少 orderId,或长度超过 128
ORDER_CONFLICT同一 orderId 已存在,但 user_code / type / amount 不一致
INVALID_USER转出时玩家不存在
INVALID_TIME注单时间参数无法解析
INSUFFICIENT_FUNDS玩家游戏余额不足(转出)
INSUFFICIENT_AGENT_FUNDS代理额度不足(转入)
TRANSFER_FAILED转换失败
ERROR / ERRO服务异常

验签说明

Header:

字段类型必填说明
Content-Typestring是固定 application/json

请求体必须带商户凭证:

字段类型必填说明
agentTokenstring是商户标识
secretKeystring是商户密钥
{
  "agentToken": "发放给你的 token",
  "secretKey": "发放给你的密钥"
}

创建玩家

无需单独创建接口。调用 /api/v1/transfer 且 type=1 时,若 user_code 不存在会自动开户,初始游戏余额为转入金额。

建议 user_code 使用你方稳定唯一账号(字母数字,不要用会变化的会话 ID)。

查询余额

请求地址:/api/v1/user_balance

请求协议:POST

字段类型必填说明
agentTokenstring是商户标识
secretKeystring是商户密钥
user_codestring是玩家账号

返回示例:

{
  "status": 1,
  "msg": "SUCCESS",
  "user_code": "player001",
  "user_balance": 88.50,
  "user_exists": true
}

玩家不存在时仍返回 status: 1,user_balance: 0,user_exists: false。

额度转换

请求地址:/api/v1/transfer

请求协议:POST

字段类型必填说明
agentToken / secretKeystring是商户凭证
user_codestring是玩家账号
typenumber是1 转入(主钱包→游戏),2 转出(游戏→主钱包)
amountnumber是金额,须大于 0,保留 2 位小数
orderIdstring是幂等单号,同代理下唯一,≤128 字符
幂等必读:orderId 必填。同一 agent + orderId 只会成功记账一次。超时/网络抖动后用同一 orderId 重试是安全的:第二次返回首次成功结果且 replay: true,不会双倍扣款。同一 orderId 但 user_code / type / amount 不一致 → ORDER_CONFLICT。

成功示例:

{
  "status": 1,
  "msg": "SUCCESS",
  "user_code": "player001",
  "type": 1,
  "amount": 100,
  "user_before_balance": 0,
  "user_balance": 100,
  "agent_before_balance": 1000,
  "agent_balance": 900,
  "orderId": "in-1710000000",
  "replay": false
}

失败示例:

{ "status": 0, "msg": "INSUFFICIENT_FUNDS", "user_code": "player001", "user_balance": 12.3, "orderId": "out-1" }
{ "status": 0, "msg": "INSUFFICIENT_AGENT_FUNDS", "user_code": "player001", "agent_balance": 0, "orderId": "in-1" }
{ "status": 0, "msg": "INVALID_ORDER_ID" }
{ "status": 0, "msg": "ORDER_CONFLICT", "orderId": "in-1" }
  • 转入会扣减代理额度池;转出会加回。局中 spin 只动玩家游戏余额,不直接动代理额度。
  • 例:转入 500 → 代理 −500;玩家赢到 600 再转出 600 → 代理 −500 +600 = 净 +100。
  • 代理额度不足返回 INSUFFICIENT_AGENT_FUNDS;转出超过玩家游戏余额返回 INSUFFICIENT_FUNDS。
  • 建议:你方先扣主钱包再调 type=1;type=2 成功后再加回主钱包。失败用同一 orderId重试,不要换单号盲目重发。

游戏代码列表

请求地址:/api/v1/gameCode

请求协议:POST

对接方应先调本接口拿到可启动游戏列表,再把返回的 gameCode(英文 slug)传给 /api/v1/game_launch。不要传 GI 数字。

字段类型必填说明
agentToken / secretKeystring是商户凭证
includeModnumber/bool否默认包含自研/魔改;传 0 / false 则排除

返回示例:

{
  "status": 1,
  "code": 10000,
  "msg": "SUCCESS",
  "data": [
    {
      "platType": "mjhl",
      "gameType": "2",
      "gameCode": "mahjong-ways",
      "gi": "65",
      "ingress": "3",
      "gameName": { "zh-hans": "麻将胡了", "en": "Mahjong Ways" },
      "img": "zh-hans/65.webp",
      "provider_code": "PGSOFT",
      "game_type": "slot"
    }
  ]
}
游戏列表会随平台更新,必须以本接口实时返回为准。下方附录表仅为对照速查(生成时共 129 款,不含魔改,可能滞后)。封面请本地缓存,勿长期热链远程图。启动时传返回的 gameCode,不要传 gi。

登录游戏

请求地址:/api/v1/game_launch

请求协议:POST

字段类型必填说明
agentToken / secretKeystring是商户凭证
user_codestring是玩家账号
game_codestring是游戏 slug(来自 /api/v1/gameCode),不要传 GI 数字
user_balancenumber是转入转出模式请固定传 0;不会覆盖已有余额,新用户初始也为 0,须先 transfer
provider_codestring否默认 PGSOFT;另支持 PRAGMATIC(需代理侧已配置)
game_typestring否默认 slot

返回示例:

{
  "status": 1,
  "msg": "SUCCESS",
  "launch_url": "https://xxx/65/index.html?operator_token=...&t=...",
  "user_code": "player001",
  "user_balance": 100.50,
  "user_created": false,
  "currency": "BRL"
}

currency 取自代理配置,未配置时默认 BRL。前端用 iframe / WebView / 新窗口打开 launch_url。游戏不存在时可能返回 {"status":"error","message":"Esse game não existe."}。

游戏记录

请求地址:/api/v1/bet_records

请求协议:POST

字段类型必填说明
agentToken / secretKeystring是商户凭证
startTimestring是yyyy-MM-dd HH:mm:ss 或时间戳(秒/毫秒)
endTimestring是同上
afterIdnumber否游标,首次 0;下次传上次返回的 afterId
limitnumber否默认 200,最大 500
时间窗按注单的 updated_at 过滤(不是 created_at),并仅返回当前代理下的玩家注单。
{
  "status": 1,
  "msg": "SUCCESS",
  "list": [
    {
      "id": 12345,
      "user_id": 88,
      "username": "player001",
      "game_code": "mahjong-ways",
      "gid": 65,
      "tid": "txn-xxx",
      "gtba": 1.6,
      "gtwa": 3.2,
      "gtwla": 1.6,
      "currency": "BRL",
      "created_at": 1710000000000,
      "updated_at": 1710000005000
    }
  ],
  "afterId": 12345,
  "hasMore": true
}
list 字段说明
id注单主键,用作游标
user_id / username玩家 ID / 账号(对应你方 user_code)
game_code / gid游戏 slug / GI
tid局/交易号
gtba投注额
gtwa派彩额
gtwla盈亏(派彩 − 投注)
currency币种
created_at / updated_at毫秒时间戳

hasMore === true 时用返回的 afterId 继续拉取,直到 false。

推荐接入流程

启动前可先:POST /api/v1/gameCode  缓存游戏列表(建议定时同步)

用户点游戏
  │
  ├─1─ POST /api/v1/transfer   type=1   主钱包 → 游戏钱包(必带唯一 orderId)
  │
  ├─2─ POST /api/v1/game_launch        拿 launch_url,前端打开(user_balance 传 0)
  │
  │     (用户在游戏内下注,余额在本平台)
  │
  ├─3─ 退出后 POST /api/v1/transfer type=2  游戏钱包 → 主钱包(新的唯一 orderId)
  │
  └─4─ 定时 POST /api/v1/bet_records      同步注单(可选)

curl 示例:

BASE="https://api.qdd.asia"
TOKEN="你的agentToken"
SECRET="你的secretKey"
USER="demo_user_001"

curl -s -X POST "$BASE/api/v1/transfer" -H "Content-Type: application/json" -d "{
  \"agentToken\":\"$TOKEN\",\"secretKey\":\"$SECRET\",
  \"user_code\":\"$USER\",\"type\":1,\"amount\":100,\"orderId\":\"in-1\"
}"

curl -s -X POST "$BASE/api/v1/game_launch" -H "Content-Type: application/json" -d "{
  \"agentToken\":\"$TOKEN\",\"secretKey\":\"$SECRET\",
  \"user_code\":\"$USER\",\"user_balance\":0,
  \"game_code\":\"mahjong-ways\",\"provider_code\":\"PGSOFT\",\"game_type\":\"slot\"
}"

curl -s -X POST "$BASE/api/v1/user_balance" -H "Content-Type: application/json" -d "{
  \"agentToken\":\"$TOKEN\",\"secretKey\":\"$SECRET\",\"user_code\":\"$USER\"
}"

curl -s -X POST "$BASE/api/v1/bet_records" -H "Content-Type: application/json" -d "{
  \"agentToken\":\"$TOKEN\",\"secretKey\":\"$SECRET\",
  \"startTime\":\"2026-10-01 00:00:00\",\"endTime\":\"2026-10-01 23:59:59\",
  \"afterId\":0,\"limit\":200
}"

自测清单

  1. 错误 token → INVALID_AGENT
  2. 新用户 transfer type=1 → 自动开户且余额正确
  3. 不传 orderId → INVALID_ORDER_ID
  4. 同一 orderId 调两次 → 第二次 replay: true,余额只变一次
  5. 同一 orderId 改 amount 再调 → ORDER_CONFLICT
  6. game_launch 返回可打开 URL;user_balance 传 0 不覆盖已有余额
  7. 下注后 user_balance 变化;退出 type=2 转回主钱包
  8. bet_records 能按时间窗拉到注单,并可用 afterId 翻页
  9. 未知 game_code → 明确错误,不返回空 URL

游戏代码

game_code 必须传英文 slug,不要传 GI 数字。请以 /api/v1/gameCode 实时返回为准;本表仅为对照速查,可能滞后。图标路径一般为 zh-hans/{GI}.webp,请本地缓存。

当前附录共 129 款(不含自研/魔改,生成时间 2026-10-12T06:02:21.248Z)。

GIgame_code名称
20reel-love亲爱的
28hotpot麻辣火锅
31baccarat-deluxe至尊百家乐
33hip-hop-panda嘻哈熊猫
34legend-of-hou-yi后羿射日
35mr-hallow-jp万胜狂欢夜
39piggy-gold金猪报财
40jungle-delight水果丛林
42ganesha-gold象财神
44emperors-favour皇上吉祥
48double-fortune双囍临门
54captains-bounty赏金船长
58vampires-charm德古拉女爵
61flirting-scholar唐伯虎点秋香
63dragon-tiger-luck龙虎争霸
65mahjong-ways麻将胡了
67shaolin-soccer少林足球
68fortune-mouse鼠鼠福福
69bikini-paradise比基尼天堂
70candy-burst糖果连连爆
74mahjong-ways-2麻将胡了2
79dreams-of-macau澳门壕梦
82phoenix-rises凤凰传奇
83wild-fireworks火树赢花
84queen-bounty赏金女王
86galactic-gems星旅淘金
87treasures-aztec寻宝黄金城
89lucky-neko招财喵
91gdn-ice-fire冰火双娇
92thai-river水上泰神奇
93opera-dynasty新国粹
94bali-vacation巴厘之旅
95majestic-ts宝石传奇
98fortune-ox十倍金牛
101rise-sun-god太阳神传说
102mermaid-riches人鱼公主
103crypto-gold比特淘金
104wild-bandito亡灵大盗
105heist-stakes霹雳神偷
106ways-of-qilin麒麟送宝
107lgd-monkey-kg美猴王传奇
108buffalo-win美洲野牛
110jurassic-kdm恐龙帝国
112oriental-pros江山美景图
113crypt-fortune丽影奇兵之探秘埃及
114emoji-riches钞级表情包
115sprmkt-spree超市大血拼
117cocktail-nite夜醉佳人
118mask-carnival假面嘉年华
119spirit-wonder百鬼夜行
120queen-banquet韩宫御宴
121dest-sun-moon日月星辰
122garuda-gems神鹰宝石
123rooster-rbl斗鸡
124battleground绝地大逃杀
125butterfly-blossom蝶恋花
126fortune-tiger虎虎生财
127speed-winner极速赢家
128legend-perseus珀尔修斯传奇
129win-win-fpc发财鱼虾蟹
130lucky-piggy电玩金猪
132wild-coaster疯赚过山车
135wild-bounty-sd赏金大对决
1312883prosper-ftree黄金摇钱树
1338274totem-wonders图腾奇迹
1368367alchemy-gold炼金工坊
1372643diner-delights美食美刻
1402846midas-fortune点石成金
1418544bakery-bonanza烘焙总动员
1448762songkran-spl泰嗨泼水节
1473388cruise-royale皇家游轮
1489936ultimate-striker金球射手
1492288pinata-wins墨西哥狂欢
1508783wild-ape-3258猿宇宙#3258
1513328spr-golf-drive超级高尔夫
1529867ninja-raccoon忍者小浣熊
1543462fortune-rabbit金钱兔
1555350forge-wealth铸造大师
1568554wild-heist-co怪盗神偷
1572362gladi-glory角斗士荣耀
1580541mafia-mayhem黑帮风云
1594259safari-wilds非洲大冒险
1601012lucky-clover幸运草之恋
1615454werewolf-hunt狼人传奇
1623475anubis-wrath阿努比斯
1635221zombie-outbreak丧尸危机
1648578shark-bounty鲨鱼猎手
1655268tsar-treasures沙皇宝藏
1666445choc-deluxe真爱巧克力
1682240cash-mania快钱来了
1695365fortune-dragon金龙送宝
1702123geisha-revenge艺伎之刃
1717688mystic-potions魔法药水
1727711three-cz-pigs三只疯狂小猪
1738001chicky-run小鸡跑酷
1747549wings-iguazu南美之翼
1755623museum-wonders世界珍宝馆
1760238yakuza-honor极道荣耀
1778752futebol-fever热血足球
1786529rio-fantasia里约嘉年华
1799745mr-treasures-fortune宝藏大冒险
1804577graffiti-rush街头涂鸦
1815268oishi-delights美食夏日祭
1827457doomsday-rampg狂暴少女
1834850jack-giant-hunt魔豆传奇
1849515mythical-gdn四大神兽
1850016incan-wonders印加奇迹
1865521dead-man-riches宝藏船说
1879752fortune-snake金蛇招财
1881268knockout-rich拳击玫瑰
1897678dragons-treas寻龙宝藏
1903012grimm-bounty格林赏金:糖果巫
1918451galaxy-miner银河宝藏
1929177kraken-gold海怪传说
1935269diner-frenzy汉堡大升级
1940257alibaba-cave芝麻开门
1950910inferno-mayhem地狱狂响
1964781pharaoh-royals法老牌
1971587majestic-emp天竺王朝
1981965forbid-alchemy炼金术
1997301mayan-destiny玛雅黄金
2009635poker-kingdom扑克王国
2012025skylight-wonder宝石热气球
2024510perfect-strike保龄球之王
2035783funky-fortunez嘻哈派对
2040102super-wildrix超级百搭王
2058347reel-royale-sd擂台之王
2100928fortune-horse马上赢
2126622tornado-rampg直击龙卷风