跳至主要内容

查詢交易詳情

查詢指定交易的詳細信息。

API 信息​

  • 端點：POST /v2/members/check/transactions
  • 認證：Bearer Token
  • 加密：請求使用 AES-256-GCM 加密，響應為明文 JSON

請求​

請求標頭​

POST /v2/members/check/transactions HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
x-agentid: integratorNBTest04
x-timestamp: 1769746894501
x-nonce: 56ffd5ecd8a3a4457863a0bd7c298fb2
x-signature: 904e97bee2589b93e9747eed0346c68b23d8ff8b568dabaf4b94a5e89093df67

請求參數​

加密前的參數​

{
  "username": "testacoount001",
  "transId": "TXN-20250129-001"
}

加密後的請求體​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
欄位類型必填說明
usernamestring是會員帳號
transIdstring是交易 ID（營運商端唯一標識符）

響應​

成功響應​

{
    "code": 0,
    "message": "No error.",
    "data": {
        "agent": "integratorNBTest03",
        "transId": "ThisisaTestTrans0014",
        "transactionTime": "2026-02-03T06:18:06.963Z",
        "amount": -2323.582,
        "username": "VPSysDevTest001",
    },
    "logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
欄位類型說明
codenumber響應代碼，0 表示成功
messagestring響應訊息
data.agentstring代理商 ID
data.transIdstring交易 ID（營運商端唯一標識符）
data.transactionTimestring交易時間（ISO 8601 格式）
data.amountnumber交易金額（負數表示提款，正數表示存款）
data.usernamestring會員帳號
logUUIDstring請求追蹤 ID，用於問題排查和日誌查詢

錯誤響應​

{
  "code": 4,
  "message": "The transaction doesn't exist.",
  "logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}

常見錯誤碼​

狀態碼說明
4交易不存在
8會員不存在
11參數錯誤
83認證失敗
84解密失敗

更多錯誤碼說明請參考：附錄 - 錯誤碼總覽

注意事項​

  1. 查詢範圍：只能查詢自己 agentId 下的交易
  2. 歷史記錄：交易記錄會永久保存，可隨時查詢
  3. 金額正負號：amount 欄位的正負號表示交易方向（負數為提款，正數為存款）
  4. 交易時間：transactionTime 為 ISO 8601 格式的時間戳

相關 API​