3.3 交易状态查询 API

http

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

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

TIP

本 API 限流 100 次 / 分钟，超过返回 code:10060。额度按 api_key × 接口独立计算，各接口不共用；每次请求（含返回错误者）均计入。

请求 Body（JSON）

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

json

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

响应 data

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

json

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

IMPORTANT

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

10030 同时代表「不存在」与「尚未入账」两种情况。转账为单一数据库交易、全同步处理，没有「已受理、未入账」的中间状态——查不到即代表当下没有入账。

请勿依赖 10030 推断后补单。确认未入账后，直接以同一个 ticket_id 重送原请求即可（HMAC Header 须重新产生新的 X-Nonce 与 X-Timestamp）。

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）

3.3 交易状态查询 API ​

请求 Body（JSON） ​

响应 data ​

data 字段 ​

3.3 交易状态查询 API

请求 Body（JSON）

响应 data

data 字段