Get player balance

View as Markdown

Wuzzlo to Operator. Verify the Wuzzlo signature and return the current balance without mutation. Return exactly OP_SUCCESS for a valid user, OP_USER_NOT_FOUND for a missing user, or OP_INVALID_OPERATOR for an invalid operator.

Authentication

Signaturestring

Wuzzlo-to-Operator: Base64 RSA-SHA256 PKCS#1 v1.5 signature of the exact UTF-8 JSON body, verified with the Wuzzlo public key.

Request

This endpoint expects an object.
operatorIdstringRequired
tokenstringRequired

Operator session token validated through /auth/login.

userIdstringRequired

Response

HTTP 200 wallet response. The body status MUST match exactly one documented scenario requirement; statuses are not interchangeable.

balancedouble

Balance returned for this response scenario. Successful mutations return the calculated post-transaction balance; duplicate and rejected scenarios return the unchanged balance.

statusenum
Exact business status required by the matched endpoint scenario. A different status is a contract failure even when the returned balance is correct.