3.3 交易状态查询 API

POST /api/v1/user/exchange/transfer-wallet-transactions/status

依 ticket_id 查询该笔交易的最新状态（实时），常用于确认存款 / 提款是否成功。数据保留最近 6 个月。请求须带入 HMAC 验证 Header。

请求 Body（JSON）

字段	必填	类型	说明
ticket_id	TRUE	string	交易所 ticket ID，最长 256 字符

{ "ticket_id": "fadbd4ce-4f14-4b9e-8ee4-accd4b9c729e" }

响应 data

返回单笔交易记录（非列表）。

{
  "code": 0,
  "message": "success",
  "data": {
    "player_id": "45d3d8eb-1a95-4e47-9315-bc507ea06d65",
    "player_external_id": "player1",
    "player_name": "player1_name",
    "agent_id": "bea4274e-4333-423c-a8e8-4c203d256d2c",
    "agent_name": "agent_demo",
    "transaction_type": "EXCHANGE_TRANSACTION_TYPE_DEPOSIT",
    "currency": "CNY",
    "amount": "100",
    "balance_after": "1000",
    "created_at": "2026-05-20T10:00:00Z"
  }
}

查无该 ticket_id 时返回 code:10030，transfer wallet transaction not found。

data 字段

字段	类型	说明
player_id	string	玩家内部 ID（UUID）
player_external_id	string	玩家 ID
player_name	string	玩家名称
agent_id	string	代理内部 ID（UUID）
agent_name	string	代理名称
transaction_type	string	交易类型（见交易类型枚举）
currency	string	货币
amount	string	金额变动（可为负）
balance_after	string	变动后余额
created_at	string	交易时间（RFC3339 UTC）