ExtraTrans
- John Chen
URl: https://{{gmag_game_data_url}}/history/extraTrans?hash={{xxx}}.
Method: POST.
Purpose: This method returns the list of transactions(promotion/ tournament).
It is only possible to return up to 10,000 transactions in one API response.
GameTrans must use a specific API domain gmag_game_data_url. For the real domain, please check the brand account information from GM-Ag.
Request
Name | Type | Required | Description |
|---|---|---|---|
startTime | String(32) | Yes | Date and time in GMT+0 timezone. |
endTime | String(32) | Yes | Date and time in GMT+0 timezone. |
size | Int | No | The number of transactions per page, default value = 5000. |
page | Int | No | The page number to retrieve, default value = 1. |
playerId | String(24) | No | The unique ID of a Player, to get game transaction for a specific player. |
providerCode | String(32) | No | Get game transactions of a specific game provider. |
showAll | Int | No | 1 - include sub brand, 0 - no sub brand included, default: 0. |
currency | String(8) | No | To get game trans of specific currency |
Response
Name | Type | Required | Description |
|---|---|---|---|
total | Int | Yes | The total number of transactions. |
pages | Int | Yes | The total pages of transactions. |
size | Int | Yes | The number of transactions per page. |
current | Int | No | The number of current page. |
records | Array | Yes | Array of extraTrans, it could be empty. |
ExtraTrans
Name | Type | Required | Description |
|---|---|---|---|
transId | String(64) | Yes | The unique identifier of the transaction. |
playerId | String(24) | Yes | The Player’s unique identifier. |
brandId | bigInt | Yes | The unique ID of an brand. |
providerCode | String(8) | Yes | The code of a Game Provider. |
currency | String(8) | Yes | The currency code of the transaction. |
amount | numeric(16, 4) | Yes | The amount of the transaction. |
balanceBefore | numeric(16, 4) | Yes | The player’s balance before the transaction. |
balanceAfter | numeric(16, 4) | Yes | The player’s balance after the transaction. |
transTime | DateTime | Yes | The created time of the transaction. |
referenceId | String(64) | Yes | The promo id |
referenceName | String(512) | No | The promo name |
description | String(2048) | No | The description |
Request example
{
"requestId": "requestId1234",
"brandId": "222",
"startTime": "2024-09-11 01:30:00",
"endTime": "2024-09-11 01:45:00",
"size": 1000,
"page": 1
}
Response example
//success
{
"requestId": "requestId1234",
"error": "0",
"message": "SUCCESS",
"total":2200,
"size":1000,
"current":1,
"pages":2,
"records": [
{
"transId": "10003",
"playerId": "JohnCNY_T_0424",
"providerCode": "oaks",
"brandId": 222,
"transTime": "2024-09-11 01:35:15.220",
"amount": 0,
"currency": "CNY",
"balanceBefore": 975055.89,
"balanceAfter": 975055.89,
"referenceId": "10003",
"referenceName":"10003",
},
{
"transId": "10004",
"playerId": "JohnCNY_T_0424",
"providerCode": "oaks",
"brandId": 222,
"transTime": "2024-09-11 01:36:21.495",
"amount": 0.09,
"currency": "CNY",
"balanceBefore": 975055.89,
"balanceAfter": 975055.98,
"referenceId": "10004",
"referenceName":"10004"
},
{
"transId": "10005",
"playerId": "JohnCNY_T_0424",
"providerCode": "oaks",
"brandId": 222,
"transTime": "2024-09-11 01:36:40.632",
"amount": 0.09,
"currency": "CNY",
"balanceBefore": 975055.98,
"balanceAfter": 975056.07,
"referenceId": "10005",
"referenceName":"10005",
"description":"10005"
}
]
}
//error
{
"requestId": "requestId1234",
"error": "P_02",
"message": "Invalid hash",
}