Query Transaction Detail
Query the detailed information of 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==..."
}
| Field | Type | Required | Description |
|---|---|---|---|
username | string | Yes | Player Account |
transId | string | Yes | Transaction ID (Operator 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"
}
Response Field Description
| Field | Type | Description |
|---|---|---|
data.agentId | string | Agent ID |
data.transId | string | Transaction ID (Operator unique identifier) |
data.transactionTime | string | Transaction time (ISO 8601 format) |
data.amount | number | Transaction amount (negative for withdrawal, positive for deposit) |
data.username | string | Player Account |
Error Response
{
"code": 4,
"message": "The transaction doesn't exist.",
"logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}
Common Error Codes
| Code | Description |
|---|---|
| 4 | The transaction doesn't exist |
| 8 | Player doesn't exist |
| 11 | Parameters error |
| 83 | Authentication Failed |
| 84 | Decryption Failed |
For more error code descriptions, please refer to: Appendix - Error Code Overview
Important Notes
- Query Scope: Can only query transactions under its own agentId
- History Records: Transaction records are permanently saved and can be queried at any time
- Amount Sign: The sign of the amount Field indicates the transaction direction (negative for withdrawal, positive for deposit)
- Transaction Time: transactionTime is a timestamp in ISO 8601 format