llms.txt API v1 · 2026-11-02
Wallet API钱包回调接口

Balance查余额

Read the player's balance (table entry, reconnect, refresh). Read only.查玩家余额(进桌、断线重连、刷新),只读。

POST{callbackUrl}/balance

Implemented by the merchant · called by the platform商户实现 · 平台调用 · timeout超时 3 s

Request: common fields. Read only.

请求:公共字段。只读,不动钱。

balancestring
Latest committed balance.最新已提交的余额。

Result codes结果码

In addition to the common codes listed in另可能返回通用结果码,见 Result codes结果码.

Test cases测试用例

The conformance test sends the following 12 requests to /balance. Each response must match the expected result exactly.接口对接测试会向 /balance 发送以下 12 个请求,每个响应都必须与期望结果完全一致。 All test cases全部测试用例

BAL-01 blocking阻断级 Balance query余额查询 Expected期望 OK
/balance {P, C}
balance equals the balance returned by AUTH-01 and is recorded as B0. A failure aborts the test.balance 与 AUTH-01 返回的余额一致,记为 B0。失败则测试中止。
BAL-02 blocking阻断级 Balance query for an unknown player不存在玩家的余额查询 Expected期望 PLAYER_NOT_FOUND
/balance {zz_<random>, C}
BAL-03 blocking阻断级 Balance query with a mismatched currency币种不符的余额查询 Expected期望 CURRENCY_MISMATCH
/balance {P, C'}
SIG-01 blocking阻断级 Invalid signature签名错误 Expected期望 INVALID_SIGNATURE
/balance, last char of X-Signature changed
SIG-02 blocking阻断级 Body altered after signing签名后正文被篡改 Expected期望 INVALID_SIGNATURE
/balance, currency lower-cased after signing
SIG-03 blocking阻断级 Expired timestamp时间戳过期 Expected期望 TIMESTAMP_EXPIRED
/balance, X-Timestamp = now − 10 min (correctly signed)
SIG-04 blocking阻断级 Future timestamp时间戳超前 Expected期望 TIMESTAMP_EXPIRED
/balance, X-Timestamp = now + 10 min
SIG-05 blocking阻断级 Missing signature header缺少签名头 Expected期望 INVALID_SIGNATURE
/balance without X-Signature
SIG-06 warning警告级 Invalid merchant code商户编码错误 Expected期望 INVALID_SIGNATURE
/balance, random X-Merchant-Code
SIG-07 blocking阻断级 Tolerance of unknown fields未知字段兼容 Expected期望 OK
/balance with extra "zzUnknown": 1
BND-08 blocking阻断级 Inner edge of the signature time window签名时间窗口内侧边界 Expected期望 OK ×2
/balance with X-Timestamp = now − 290 s; /balance with a 64-character X-Request-Id
Both requests are accepted.两个请求均被接受。
END-01 blocking阻断级 Closing balance reconciliation期末余额核对 Expected期望 OK
/balance {P, C}
balance = B0. A difference indicates a duplicated or missing fund movement.balance = B0。存在差额表明有重复或缺失的资金变动。