MG+ Agent Guide for Single Wallet Integrations
Breadcrumbs

回复交易纪录

当需要返回到上一笔交易结果时使用。

使用回复交易时,该笔回复交易的交易金额须与待回复交易的交易金额相同,不支援回复部分的交易纪录。

由于此方法是幂等的,因此任何重复调用都需返回与第一个成功响应完全相同的结果。


POST {base_url}/rollback


请求资讯

名称

是否必填

资料类型

描述

playerId

String (50)

玩家的系统识别码。

amount

非必填

Number

回复交易金额。

总数可能为0,但不可为负值。

currency

非必填

String (3)

指定货币时,使用ISO 4217 货币代码表示,不包括加密货币。

txnId

String (256)

MG+交易纪录识别码,该资讯在系统内为唯一值,依幂等方法使用。

betId

非必填

String (256)

要回复的交易 Bet ID。此 ID 可用于将不同交易对应到同笔下注。

extOperatorToken

非必填

String (150)

选择性的追踪识别码,如果在上一次登入调用回应期间及在游戏中提供了值。

如果在游戏之外进行 MG+ 调用,则此参数可能不存在。


请求范例

JSON
{
  "playerId": "test_player",
  "amount": 110.00,
  "currency": "CNY",
  "txnId": " AQEAAgA4AAAAAAAAAE0CAAAAAAAA",
  "betId": "AIBQABYAAIIS4TAAAAAABAHXTC23AC7QAA",
  "extOperatorToken": "tracertoken77"
}


回传资讯

名称

是否必填

资料类型

描述

balance

Number

回复交易完成后的玩家余额。

currency

String (3)

玩家币别,使用ISO 4217 货币代码。

extTxnId

非必填

String (512)

此回复交易纪录识别码储存在代理的系统。

extCreationTimeMs

非必填

Number

该交易纪录储存于代理系统资料库的时间戳(储存格式应为Epoch毫秒)。


回传范例

JSON
{
  "currency": "CNY",
  "balance": 2050.50,
  "extTxnId": "QEFR-SUWE-OALC-SPUF",
  "extCreationTimeMs": 1673436250458
}


HTTP 回复代码

状态代码

描述

范例

200

完成

 

500

内部伺服器错误