查询交易状态

由商户实现，平台调用，必须实现

GET {MERCHANT_URL}/v1/wallet-transactions/{transaction_id}，使用交付的 secret 签名。

平台没有拿到改变玩家余额的明确结果时，会调用本接口确认。这个接口是单一钱包资金安全的基础，没有实现的话，平台不会开通单一钱包新业务。

请求参数（path）

参数	类型	说明
transaction_id	string	平台交易 ID

成功响应 200

data 的字段与改变玩家余额相同，但 HTTP 状态固定为 200，业务状态通过 status 返回。

{
  "data": {
    "transaction_id": "0192f6b0-8a1d-7c3e-9f20-1a2b3c4d5e6f",
    "external_player_id": "merchant-user-1",
    "currency": "USD",
    "kind": "BET",
    "amount": "10.00",
    "status": "SUCCEEDED",
    "balance": "1240.50",
    "updated_at": "2026-09-23T08:00:02Z"
  },
  "request_id": "b3f1c2d4-query-0001"
}

• 查到的必须是权威记录，并与首次处理的结果一致，包括 balance。
• 处理中返回 200 加 status=PENDING。

查无此单

{
  "error": { "code": "TRANSACTION_NOT_FOUND", "message": "transaction not found", "retryable": false, "details": {} },
  "request_id": "b3f1c2d4-query-0002"
}

返回 HTTP 404，retryable 必须为 false。

404 只表示商户这里还没有这笔交易。原请求可能还在路上，所以平台仍会按同一个 ID 继续恢复，不会把它当成失败。