Skip to main content

Query Transaction Detail

Query detailed information for a specified transaction.

API Information​

  • URL：POST /v2/members/check/transactions
  • Authentication：Bearer Token
  • Encryption：Requests are encrypted using AES-256-GCM; responses are returned as plaintext JSON

request​

request Headers​

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

Request Parameters​

Request Body Before Encryption​

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

Encrypted Request Body​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
FieldTypeRequiredDescription
usernamestringYesPlayer Account
transIdstringYesTransaction id

Response​

Success Response​

{
    "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"
}
FieldTypeDescription
codenumberStatus code
messagestringStatus message
data.agentstringagentId
data.transIdstringTransaction id
data.transactionTimestringThe time which is transaction is success
data.amountnumberTransfer amount, Positive means deposit, Negative means withdraw
data.usernamestringPlayer Account
logUUIDstringRequest tracking ID for troubleshooting and log queries

Error Response​

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

Common Error Codes​

CodeDescription
4The transaction doesn`t exist
8The member does not exist
11Parameters error
83Authentication Failed
84Decryption Failed

Important Notes​

  1. Query Scope: Only transactions under the same agentId can be queried
  2. Historical Records: Transaction records are stored permanently and can be queried at any time
  3. Amount Sign: The sign of the amount field indicates the transaction direction (negative for withdrawal, positive for deposit)