Skip to main content

Query Transaction Details

Retrieve details 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​

Parameters Before Encryption​

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

Encrypted Request Body​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
FieldTypeRequiredDescription
usernamestringYesPlayer Account
transIdstringYesTransaction ID (Operator's unique identifier)

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

ResponseFieldDescription​

FieldTypeDescription
data.agentIdstringAgent ID
data.transIdstringTransaction ID (Operator unique identifier)
data.transactionTimestringTransaction Time (ISO 8601 format)
data.amountnumberTransaction Amount (negative value indicates withdrawal, positive value indicates deposit)
data.usernamestringPlayer Account

Error Response​

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

Common Error Codes​

CodeDescription
4Transaction does not exist
8Player does not exist
11Parameter error
83Authentication Failed
84Decryption Failed

For more error code descriptions, please refer to: Appendix - Error Code Overview

Important Notes​

  1. Query Scope: Only transactions under one's own agentId can be queried.
  2. Historical Records: Transaction records will be permanently saved 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).
  4. Transaction Time: transactionTime is an ISO 8601 formatted timestamp.