改变用户余额

OMG调用该接口改变玩家余额

这个接口只会在余额有变动的时候调用，例如下注扣钱调用一次，派奖调用一次，验证结束调用一次。每一次调用都有type字段指明调用原因。

ChangeBalance

该API接口由 接入方 提供 OMG平台 进行调用

POST {AGENT_URL}/api/luck/balance/change_balance?trace_id=omg_trace_id

{AGENT_URL}为接入方后台填写的回调地址

Headers

Name	Value
Content-Type	"application/json; charset=utf-8"
sign	"omg_sign_string"

签名算法请查阅 签名算法及示例 页面描述

Body

Name	Type	Description
app_id	string	商户的唯一标识 可通过商户后台获得
uname	string	接入方提供的用户id
money	string (decimal)	余额变动（正、负）
game_id	integer	游戏id
session_id	string	游戏主局号
round_id	string	游戏副局号,如果只有一局,值和session_id一样
order_id	string	订单号,每次有金额改变会产生的唯一编号(长度最长64位)
timestamp	integer	时间戳(秒)
bet	string (decimal)	下注金额,该值始终为正数,只有在玩家下注时才会有值
type	integer	1:游戏下注; 2:取消下注; 3:游戏返奖; 4:验证对局结束; 5:LuckWin游戏宝箱下发奖励; 详见下方 type类型说明*
end_round	bool	当前局是否结束
cancel_order_id	string	仅当type=2时有值，表示取消的是哪一笔订单
award_order_ids	array	仅当type=3时有值，表示这一轮所有注单的派奖金额,详见下方 award_order_ids参数说明*
player_login_token	string 非必填	接入方上传的用户token

OMG请求参数示例

{
    "app_id": "10013",
    "bet": "3",
    "game_id": 74,
    "money": "-3",
    "order_id": "20240716195311drxaoz1mxx6g",
    "session_id": "1813180074526625845",
    "round_id": "1813180074526625845",
    "timestamp": 1721130791,
    "uname": "1006417",
    "end_round": false,
    "type": 1,
    "cancel_order_id": "",
    "award_order_ids": null,
    "player_login_token":"c51597bb-969f-11ef-ad19-0242ac120002"
}

接入方响应参数示例

成功

{
    "code": 1,
    "msg": "ok",
    "data": {
        "balance": "4289.15"
    }
}

失败

成功返回示例的参数说明

参数名	必选	类型	说明
data	是	object	返回数据
balance	是	string (decimal)	余额(最多支持4位小数)
code	是	integer	状态码
msg	是	string	提示信息

错误码

更多返回错误代码请查阅 通用错误码 页面描述

---

*award_order_ids 字段说明

award_order_ids是一个数组类型，里面存的是一个对象

对象的字段如下 更多请查看 游戏返奖 示例

参数名	必选	类型	说明
order_id	是	string	注单id
money	是	string(decimal)	派奖金额

*type 字段说明

每个type对应的都是一次http调用

• 流程举例说明：

  1. 游戏下注→游戏返奖→游戏对局结束；对应type1→3→4；玩家在游戏内进行投注，并中奖结算，验证对局结束；此情况适用大部分游戏流程；

  2. 游戏下注→取消下注；对应type1→2；玩家在游戏内进行投注，对局开始前自主取消下注，一般为百人场、Mini Game类游戏；取消下注的session_id与下注的session_id一致；

  3. 游戏下注→未中奖→游戏对局结束；对应type1→4；玩家在游戏内进行投注，当局未中奖，验证对局结束；

  4. 游戏下注→游戏返奖→游戏返奖→游戏返奖········→游戏对局结束；对应type1→3→3→········→4；玩家在游戏内进行投注，此局中奖多次直到对局结束；此种情况一般为连消类slot、slot游戏进入特殊玩法、彩票类游戏；

  5. LUCKYWIN游戏宝箱下发奖励:LUCKYWIN游戏内当玩家达到流水条件可随时领取宝箱奖励，跟游戏流程无关；

---

OMG请求ChangeBalance接口示例参数举例

type=1 用户下注

{
    "app_id": "10013",
    "bet": "3",
    "game_id": 74,
    "money": "-3",
    "order_id": "20240716195311drxaoz1mxx6g",
    "session_id": "1813180074526625845",
    "round_id": "1813180074526625845",
    "timestamp": 1721130791,
    "uname": "1006417",
    "end_round": false,
    "type": 1,
    "cancel_order_id": "",
    "award_order_ids": null
}

type=2 用户取消下注

{
    "app_id": "13",
    "uname": "1033201",
    "money": "10000",
    "game_id": 100001,
    "session_id": "1777333924821798912",
    "round_id": "1777333924821798912",
    "order_id": "10920408215323di4cal9or8ji",
    "timestamp": 1712584403,
    "bet": "0",
    "type": 2,
    "end_round": false,
    "cancel_order_id":"20240408215323di4cal9or8jk",
    "award_order_ids":null
}

type=3 游戏返奖

{
    "app_id": "10013",
    "bet": "0",
    "game_id": 100001,
    "money": "33.66",
    "order_id": "20240715204114drtuiv8r7ny8",
    "session_id": "24713",
    "round_id": "24713",
    "timestamp": 1721047274,
    "uname": "1006415",
    "end_round": false,
    "type": 3,
    "cancel_order_id": "",
    "award_order_ids": [
        {
            "order_id": "20240715204030drtugi3tau4g",
            "money": "5.1"
        },
        {
            "order_id": "20240715204053drtuhqp0jthc",
            "money": "10.2"
        },
        {
            "order_id": "20240715204104drtuibx5hlhc",
            "money": "18.36"
        }
    ]
}

type=4 通知接入方对局结束

{
    "app_id": "10013",
    "bet": "0",
    "game_id": 100001,
    "money": "0",
    "order_id": "20240715204114drtuiv8r7ny9",
    "session_id": "24713",
    "round_id": "24713",
    "timestamp": 1721047274,
    "uname": "1006415",
    "end_round": true,
    "type": 4,
    "cancel_order_id": "",
    "award_order_ids": null
}

type=5 LuckWin游戏宝箱下发奖励

只会出现在LuckWin这个游戏中

{
    "app_id": "10013",
    "bet": "0",
    "game_id": 100003,
    "money": "2",
    "order_id": "20240628171403dq4oali2j30g",
    "session_id": "14973",
    "round_id": "14973",
    "timestamp": 1719566043,
    "uname": "1004612",
    "end_round": false,
    "type": 5,
    "cancel_order_id": "",
    "award_order_ids": null
}