3.3 Transaction Status Query API

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

Query the latest status of a single transaction (real-time) by ticket_id, commonly used to confirm whether a deposit / withdrawal succeeded. Data is retained for the most recent 6 months. Requests must include the HMAC authentication headers.

Request Body (JSON)

Field	Required	Type	Description
ticket_id	TRUE	string	Exchange ticket ID, up to 256 characters

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

Response data

Returns a single transaction record (not a list).

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

When no record matches the ticket_id, returns code:10030, transfer wallet transaction not found.

data fields

Field	Type	Description
player_id	string	Internal player ID (UUID)
player_external_id	string	Player ID
player_name	string	Player name
agent_id	string	Internal agent ID (UUID)
agent_name	string	Agent name
transaction_type	string	Transaction type (see transaction type enum)
currency	string	Currency
amount	string	Amount change (may be negative)
balance_after	string	Balance after the change
created_at	string	Transaction time (RFC3339 UTC)