Credit or settle a bet result
Wuzzlo to Operator. Verify the Wuzzlo signature and settle the original debit atomically. A new settlement returns OP_SUCCESS. The same reqId returns OP_DUPLICATE_REQUEST. A new reqId for an already-settled transaction returns OP_DUPLICATE_TRANSACTION. Credit after rollback returns OP_TRANSACTION_ROLLED_BACK. A missing debit returns OP_TRANSACTION_DOES_NOT_EXIST. All rejected or duplicate scenarios leave balance unchanged.
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.
operatorId
sessionToken
Operator session token validated through /auth/login.
userId
reqId
Durable idempotency key. An exact replay must return OP_DUPLICATE_REQUEST without changing balance.
transactionId
Logical wallet transaction identifier shared by the debit lifecycle.
gameId
roundId
amount
Authoritative monetary amount. Use decimal-safe arithmetic.
token
creditAmount
settlementKind
settlementStatus
resultStatus
betType
Response
HTTP 200 settlement response. The body status MUST be the single exact value assigned to the matching scenario; statuses are not interchangeable.
balance
Balance returned for this response scenario. Successful mutations return the calculated post-transaction balance; duplicate and rejected scenarios return the unchanged balance.
status
Exact business status required by the matched endpoint scenario. A different status is a contract failure even when the returned balance is correct.