跳到主要内容

查询交易详情

查询指定交易的详细信息。

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​