当需要返回到上一笔交易结果时使用。
使用回复交易时,该笔回复交易的交易金额须与待回复交易的交易金额相同,不支援回复部分的交易纪录。
由于此方法是幂等的,因此任何重复调用都需返回与第一个成功响应完全相同的结果。
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 |
内部伺服器错误 |
|