Skip to main content
Debit
POST /debit
This operation is idempotent.

Headers


Request Parameters

Transaction Types: Enum representing the type of transaction.
  • DEBIT_SPIN: A regular spin-based transaction.
  • DEBIT_JACKPOT: A transaction where the player receives a jackpot payout.
  • FREEBET_DEBIT_SPIN: A free bet spin transaction.

Response Parameters


Error

If an error occurs while processing a request, the API must return a response with HTTP Status Code: 400 Bad Request

Responsibility of the wallet platform
The wallet platform must verify that the incoming playerId and roundId correspond to a previously placed wager. If this validation fails, the debit request must be refused with INVALID_TRANSACTION. A negative amount must be refused with BET_NOT_ALLOWED. A zero amount is a valid request (a lost round) and must return HTTP 200 with the current balance. If promotionExternalId is present, the wallet platform must validate that it belongs to the active promotion session for the player and use it as the promo wallet context. If the roundFinished has been marked as true, the platform must close the round, ensuring that no new Credit, Debit or Rollback operations can be performed on it.