取得點數異動紀錄

GET /vendor/v2.0/transaction/changeList

取得點數異動紀錄

cURL

curl --request GET \
  --url https://your-api-host/vendor/v2.0/transaction/changeList \
  --header 'Authorization: <api-key>'

200

{
  "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"
  }
}

• 點數異動紀錄資料保存3個月。
• 單次搜尋的最大時間區間為30分鐘，且不得跨日。
• 此服務僅支援轉帳錢包會員。
• 點數異動類型: GameRefund、PlatformTransfer、EventBonus、ManualAdjustment。
• 分頁請參考查詢分頁注意事項。

​

請求參數

startTime · string · 必填 · 參與簽章

搜尋起始時間 (時區、格式請參考API注意事項)

endTime · string · 必填 · 參與簽章

搜尋結束時間 (時區、格式請參考API注意事項)

changeTypeList · string · 參與簽章

點數異動類型 (查詢全部請帶空值,特定類型參照應用說明以逗點隔開,例如:PlatformTransfer,EventBonus)

nextToken · string · 參與簽章

查詢憑證 (初次查詢帶入空白，之後應帶入前一次結果的nextToken)

maxResults · number · 必填 · 參與簽章

返回限制筆數 (最小2000筆，最大5000筆)

sign · string · 必填

簽章，產生方式請參考簽章規則

​

回應

成功（HTTP 狀態碼固定為 200，請以 status.code 判斷結果）

data · object

顯示 屬性

transactionList · object[]

點數異動紀錄

顯示 屬性

transactionID · string

交易代碼

status · boolean

異動狀態 (true:成功、false:失敗)

channelID · number

渠道編號

account · string

會員帳號

currency · string

幣別 (請洽詢我方商務)

amount · number

異動金額

balanceBefore · number

異動前錢包餘額

balanceAfter · number

異動後錢包餘額

time · string

異動時間 (時區、格式請參考API注意事項)

changeType · string

異動類型

note · string

備註

nextToken · number

下次查詢憑證(最後一次查詢返回空字串)

maxResults · number

返回限制筆數

total · number

本次查詢總注單數

status · object

每次回應都會附帶的請求處理狀態

顯示 屬性

code · string

回應訊息碼，請參照回應訊息碼

message · string

回應詳細訊息

datetime · string

請求接收時間，格式為 RFC3339

traceCode · string

回應追蹤碼（唯一值），供雙方比對回應內容

200

{
  "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"
  }
}