List balance changes - VA Docs

Balance change records are kept for 3 months.
Each query can cover at most 30 minutes and cannot span days.
This service supports transfer wallet members only.
Balance change types: GameRefund, PlatformTransfer, EventBonus, ManualAdjustment.
For paging, see Pagination.

Path

GET {host}/vendor/v2.0/transaction/changeList

Headers

Field	Type	Required	Description
`Authorization`	string	Yes	Token we provide

Request parameters

Field	Type	Required	Signed	Description
`startTime`	string	Yes	✓	Search start time (see Time format)
`endTime`	string	Yes	✓	Search end time (see Time format)
`changeTypeList`	string	No	✓	Balance change types (leave empty for all; otherwise comma-separated types from the notes above, for example PlatformTransfer,EventBonus)
`nextToken`	string	No	✓	Query token (empty on the first query, then the nextToken from the previous result)
`maxResults`	number	Yes	✓	Maximum number of results (min 2000, max 5000)
`sign`	string	Yes		Signature. See Signature for how to generate it

Response

Success (the HTTP status code is always 200; check status.code for the result)

Field	Type	Description
`data`	object
`data.transactionList`	object[]	Balance change records
`data.transactionList[].transactionID`	string	Transaction ID
`data.transactionList[].status`	boolean	Change status (true: succeeded, false: failed)
`data.transactionList[].channelID`	number	Channel ID
`data.transactionList[].account`	string	Member account
`data.transactionList[].currency`	string	Currency (contact our business team)
`data.transactionList[].amount`	number	Change amount
`data.transactionList[].balanceBefore`	number	Wallet balance before the change
`data.transactionList[].balanceAfter`	number	Wallet balance after the change
`data.transactionList[].time`	string	Change time (see Time format)
`data.transactionList[].changeType`	string	Change type
`data.transactionList[].note`	string	Note
`data.nextToken`	string	Token for the next query (empty string on the last page)
`data.maxResults`	number	Maximum number of results returned
`data.total`	number	Total number of records in this query
`status`	object	Response status. See Response format

Response example

{
  "data": {
    "transactionList": [
      {
        "transactionID": "deposit-7524266853ebe08f9783dba97",
        "status": true,
        "channelID": 1,
        "account": "player001",
        "currency": "CNY",
        "amount": 99,
        "balanceBefore": 0,
        "balanceAfter": 99,
        "time": "2022-07-04T10:13:54.920+08:00",
        "changeType": "PlatformTransfer",
        "note": ""
      }
    ],
    "nextToken": "gdfv5451gg5574fs",
    "maxResults": 2000,
    "total": 2000
  },
  "status": {
    "code": "0",
    "message": "success",
    "datetime": "2022-07-04T10:13:54.920+08:00",
    "traceCode": "7cf25e1957cc47fe8e01f1a7c6d504d6"
  }
}

Response codes

Besides the common codes, this API may also return:

Code	Description
`103`	Request failed on our side