Skip to content

Flows & states

What isn't obvious at first glance on the screens: what triggers each state, what steps the interface follows, the exact message the player sees and where it appears. Each flow links to the real screen to reproduce it and states what the backend must provide.

Documented flows—
Quoted messages—
Domains—
Proposals not yet simulated—

How to read each flow

ToastTemporary notice at the bottom right; on mobile, above the pill. It closes by itself after 4 s, can be swiped away and there are at most 3 at a time.
AlertColored box inside the modal or screen. It stays until the state changes.
Field errorMessage below the field, which is highlighted in red. It clears when the player types again.
Result screenReplaces the wallet form with the final result.
Confirmation dialogGeneric modal before an irreversible action, with a primary or danger button.
Loading overlaySpinner with title and text over the modal while processing. The button shows its own loading text.
On-screen blockCard, notice or empty state that the page shows depending on the player's status.
For integrationWhat data, events or validations the backend must provide for the flow to actually work.
SuccessInfoWarningErrorSame color as the real component.

Prototype controls

?auth=in?auth=outForces the logged-in or logged-out state on any URL.
#login#register#forgot-password#deposit#withdraw#search#notificationsOpen the corresponding modal or panel.
Layers panelButton at the bottom right: session, KYC status and reset demo data.
?demo=0Hides the layers panel for screenshots or demos.
Preset linksThey prepare the demo data (KYC status, balance, V1 Coins or active currency) before opening the screen.
“Here” buttonsOpen the currency selector, the wallet or its settings on this same page, logged in.

Account

Login, sign-up, password recovery and actions that require an account. Everything happens in modals that open from any screen.

Successful login

Any username with a password of 6 or more characters logs in to the prototype.

SuccessLogin modal
Trigger

PlayerSubmits the login form from the header, a protected button or the #login hash.

Steps
  1. Fields are validated in the browser: both are required and the password needs at least 6 characters.
  2. The button changes to “Logging in…” and a loading overlay covers the modal for one second.
  3. The player is logged in, the modal closes, and name, balances and KYC status are repainted across the page.
  4. The welcome toast appears.
What the player sees
Field error · Email or username and password
Enter your email or username.Password must be at least 6 characters.
Loading overlay · Login modal

Logging in…

Verifying your login details.

Toast · Global
Welcome back, Valentina!You have 25 free spins waiting for you.
How to see itOpen login

For integrationLogin endpoint that returns the session token, the profile (name, ID, VIP level), the real and bonus balances, the KYC status and the pending free spins used in the greeting. The “Keep me logged in” checkbox sets the token lifetime.

Incorrect credentials

The password doesn't match the account.

ErrorLogin modal
Trigger

PlayerSubmits the login with an incorrect password.

Steps
  1. “Logging in…” loading overlay.
  2. The modal stays open and the player isn't logged in.
  3. The red alert appears above the form and the password field is highlighted in red.
What the player sees
Alert · Above the login form
Incorrect email or passwordCheck your details. You have 2 attempts left before a temporary lock.
Field error · Password
Incorrect password.
How to see itOpen loginPassword error123

For integrationA generic response that doesn't reveal whether the user exists, with the number of attempts left before the temporary lockout.

Account temporarily locked

After several failed attempts, the account is locked for a few minutes.

ErrorLogin modal
Trigger

SystemThe backend responds that the account is locked due to too many attempts.

Steps
  1. The player submits the login.
  2. “Logging in…” loading overlay.
  3. The lockout alert appears and the player isn't logged in.
What the player sees
Alert · Above the login form
Account temporarily lockedToo many failed attempts. Try again in 15 minutes or reset your password.
How to see itOpen loginUsername containing bloqueado

For integrationLockout error code with the minutes remaining. The message invites the player to reset their password, which must remain available during the lockout.

Log in with Google or Apple

Social login from the login modal.

SuccessLogin modal
Trigger

PlayerTaps Google or Apple under “or continue with”.

Steps
  1. The button shows “Connecting…”.
  2. The player is logged in and the modal closes.
  3. Welcome toast with the provider used.
What the player sees
Toast · Global
Welcome back, Valentina!You logged in with Google.
How to see itOpen login

For integrationOAuth flow for Google and Apple. If the email has no account, route to social sign-up, which asks for the missing legal details.

Reset password

Sending the link to create a new password.

InfoRecovery modal
Trigger

PlayerTaps “Forgot it?” next to the password field.

Steps
  1. Enters their email; the format is validated.
  2. The button shows “Sending…”.
  3. The form is replaced by the confirmation, whether or not the account exists.
What the player sees
Field error · Email
Enter a valid email.
Result screen · Recovery modal

Check your email

If an account exists with valentina.r@correo.com, you'll receive a link valid for 30 minutes.

For integrationAlways respond the same way, whether or not the account exists. Single-use token that expires after 30 minutes. The screen to create the new password isn't simulated (see proposals).

3-step sign-up

Email sign-up: access, personal details and confirmation.

SuccessSign-up modal
Trigger

PlayerTaps “Create your account”, “Sign up” or opens the #register hash.

Steps
  1. Access: email, password of at least 8 characters with a strength meter, country and currency.
  2. Details: first name, last name, date of birth and mobile phone.
  3. Confirm: welcome bonus (casino, sports or no bonus), promo code and acceptance of terms.
  4. Loading overlay while the account is created.
  5. Account created and logged in, $0 balance, verification pending and Bronze 1 level.
What the player sees
Field error · Validations for each step
Enter a valid email, e.g. name@domain.comPassword must be at least 8 characters.Enter a valid phone number.You must accept the terms to create your account.
Loading overlay · Sign-up modal

Creating your account…

This only takes a moment.

Result screen · Sign-up modal

Account created!

We've sent you a confirmation email. Make your first deposit to activate the 200% welcome bonus.

Deposit nowExplore the casino
Toast · Global
Welcome to BetV1!Your account is ready.

For integrationSign-up with country, currency, personal details and chosen bonus; confirmation email and SMS to verify the phone number. New accounts start with KYC “Unverified”, which blocks withdrawals until verification.

Email already registered

The email from step 1 already belongs to an account.

ErrorSign-up · step 1
Trigger

PlayerTaps “Continue” in step 1 with an email that's already registered.

Steps
  1. Email availability is checked.
  2. The step doesn't proceed and the email field is highlighted in red; the text invites the player to log in.
What the player sees
Field error · Email
This email is already registered. Want to log in?
How to see itOpen sign-upEmail existe@correo.com

For integrationEmail availability endpoint called when leaving step 1, before asking for more details.

Underage

The date of birth indicates the player is under 18.

ErrorSign-up · step 2
Trigger

PlayerTaps “Continue” in step 2 with a date less than 18 years ago.

Steps
  1. Before the error, the field shows the hint “You must be 18 or older to play.”.
  2. Age validation fails and the step doesn't proceed.
What the player sees
Field error · Date of birth
You must be at least 18 to sign up.
How to see itOpen sign-upDate of birth 2012-05-01

For integrationValidate age on the server too and block account creation. The minimum age may vary by market.

Promo code at sign-up

Validation of the optional code in step 3.

SuccessErrorSign-up · step 3
Trigger

PlayerEnters a code and taps “Apply”.

Steps
  1. The code is validated without leaving the step.
  2. Valid: the field turns green with the reward.
  3. Invalid: the field turns red; sign-up can continue without a code.
What the player sees
Field message · Valid code
Code applied: +25 free spins on Sweet Bonanza 1000.
Field error · Invalid code
This code doesn't exist or has expired.
How to see itOpen sign-upValid BETV1Invalid: any other

For integrationCode validation with the reward it grants and the reason when it's invalid (nonexistent or expired).

Sign up with Google or Apple

Data from the social account fills in the form, but age and phone are still required.

SuccessSign-up · steps 1 and 2
Trigger

PlayerTaps Google or Apple in step 1 of sign-up.

Steps
  1. The button shows “Connecting…”.
  2. Email, technical password, first name and last name are filled in.
  3. Goes straight to step 2 with a green notice to complete the legally required details.
What the player sees
Alert · Sign-up step 2
Connected with Googlevalentina.ramirez@gmail.com · Complete these details: the law requires us to verify your age and phone number.
How to see itOpen sign-up

For integrationOAuth with email and name. Even if the account comes from a social network, date of birth and phone number are required before it's created.

Actions that require login

Real money, wallet, missions and account pages without being logged in.

InfoGlobal
Trigger

PlayerWhile logged out, taps a protected button or opens one of their account pages.

Steps
  1. Protected buttons (play for real money, claim a mission, VIP rooms): the login opens instead of the action.
  2. Wallet: the login opens instead of the wallet.
  3. Account pages: the content is replaced by a lock screen with login and sign-up.
What the player sees
Toast · Protected buttons
Log in to play with real moneyYou can also try the demo without an account.
Toast · Wallet, logged out
Log inYou need an account to use the wallet.
On-screen block · Account pages

Log in to continue

This section is part of your account. Log in or create a new account in under a minute.

Log inCreate account

For integrationEvery protected endpoint must return 401 so the front end opens the login. Currently “Claim” in missions reuses the generic real-money toast (see proposals).

Account and verification

Identity verification (KYC) statuses and their effect on each screen, personal details, phone, security, settings and notifications.

Verification statuses (KYC)

Four statuses that change the user menu, the verification page and withdrawals.

WarningVerification · Withdrawal · Wallet · Menu
What changes on each screen
StatusUser menuVerification pageWithdraw pageWallet · Withdraw
UnverifiedPendingVerify your identityForm hidden; card prompting verificationAlert and disabled button
Under reviewUnder reviewDocuments under review; submission disabledForm hidden; review noticeAlert and disabled button
VerifiedVerifiedVerified account · Level 2Withdrawal form enabledWithdrawal enabled
RejectedRejectedRejection reasons and steps flagged for correctionForm hidden; card prompting verificationAlert and disabled button
Trigger

SystemThe status changes on sign-up (unverified), on document submission (under review) and when compliance approves or rejects.

Steps
  1. Sign-up: the account starts unverified.
  2. Document submission: moves to under review.
  3. Approval: verified, level 2, withdrawals up to $10,000 per day.
  4. Rejection: the reasons and the steps to repeat are shown.
What the player sees
On-screen block · Verification, unverified

Verify your identity

We need your ID document, a selfie and proof of address. We review everything in under 24 hours and your data is stored encrypted.

On-screen block · Verification, under review

Documents under review

We received your documents on Nov 12 at 10:42. We'll let you know by email and notification as soon as we're done. Estimated time: under 24 hours.

On-screen block · Verification, verified

Verified account · Level 2

You verified your identity on Nov 12, 2026. You can withdraw up to $10,000 a day. Upload proof of address to move up to level 3 and remove the limits.

On-screen block · Verification, rejected

We couldn't verify your documents

We reviewed your Nov 12 submission and found these issues:

  • The photo of the back of the document is blurry and the details can't be read.
  • The selfie doesn't match the document photo because of the lighting.
Toast · When the status is changed from the layers panel
KYC status: Under reviewApplies to withdrawals and verification.

For integrationKYC status (none, pending, ok, rejected), verification level (1 to 3), submission date, rejection reasons per document and withdrawal limit for each level. KYC provider webhook to update the status and send the “Identity verified” notification.

Document submission

Document front and back, selfie with liveness check and consent.

SuccessErrorVerification
Trigger

PlayerCompletes the steps and taps “Submit for review”.

Steps
  1. Uploads the front and back of the document: JPG, PNG or PDF up to 10 MB, with a progress bar.
  2. Does the liveness check with the camera: looks straight ahead, turns their head to each side and smiles.
  3. Ticks the consent checkbox and submits.
  4. The status changes to “Under review” and the button is disabled.
What the player sees
Toast · After the liveness check
Selfie verifiedMatches the photo on your document.
Alert · Above the submit button
Required steps missingMissing: front, back, selfie.
Alert · Variants of the same notice
Required steps missingTick the authorization box to continue.
Toast · Successful submission
Documents submittedWe'll review them in under 24 hours.
How to see itVerification, unverified“Use sample file” button in each upload area

For integrationServer-validated file upload, liveness check session from the KYC provider and a submission endpoint that returns the new status. Once the account is verified, level 3 asks for proof of address: “Upload proof of address to move up to level 3.”.

File upload error

Unsupported format, file too large or document rejected.

ErrorVerification · upload area
Trigger

PlayerChooses or drags in a file that doesn't meet the requirements.

Steps
  1. Type and size are checked before uploading.
  2. The upload area is highlighted in red with the reason and the step doesn't count as completed.
What the player sees
Upload area error · Format and size
Unsupported format (DOCX). Use JPG, PNG or PDF.The file is 14.6 MB. The maximum is 10 MB.
Upload area error · Verification rejected
Rejected: the image is blurry. Upload a sharp photo.
How to see itVerification, unverified“Simulate error” button in each upload areaRejected document

For integrationThe same limits server-side (file types and 10 MB) and the rejection reason per document, to show it in its own upload area.

Verify phone by SMS

6-digit code with timed resend.

SuccessErrorMy details · code modal
Trigger

PlayerTaps “Verify” next to their phone number in My details.

Steps
  1. The modal opens with 6 boxes and the SMS is sent.
  2. The resend link becomes active after 30 seconds.
  3. Enters the code and taps verify; the button shows “Verifying…”.
  4. The phone number is marked as verified.
What the player sees
Field error · Code
Enter all 6 digits of the code.Incorrect code. You have 2 attempts left.
Toast · Resend
Code resentCheck the SMS messages on +57 300 ••• 4567
Toast · Phone verified
Phone verified+57 300 123 4567
How to see itMy detailsError 000000Success: any other 6-digit code

For integrationOTP sent by SMS with a resend cooldown (30 s) and an attempt limit; the error response includes the remaining attempts.

Personal details, address and email

Card-based editing in My details.

SuccessInfoMy details
Trigger

PlayerEdits a card (personal details, address or email) and saves.

Steps
  1. The card switches to edit mode with per-field validation.
  2. The button shows “Saving…”.
  3. The card returns to read mode with the new details; the name updates across the page.
  4. The new email isn't applied until the link is confirmed.
What the player sees
Toast · Personal details
Details updatedYour personal details have been saved.
Alert · Address card
If you change your address, we'll ask for a new proof of address.
Toast · Address
Address updatedWe'll ask you for proof in Verification.
Toast · Email change
Check your new emailWe sent a confirmation link to nuevo@correo.com
How to see itMy details

For integrationChanging the address invalidates the level 3 proof of address. Changing the email sends a confirmation link and keeps the previous email until it's confirmed.

Password change

From Security, with the current password.

SuccessErrorSecurity
Trigger

PlayerSubmits the form with the current and new passwords.

Steps
  1. The button shows “Updating…”.
  2. If the current password is wrong, the field is flagged.
  3. If it's correct, the form is cleared and all other sessions are closed.
What the player sees
Field error · Current password
Your current password is incorrect.
Toast · Global
Password updatedWe've logged you out of your other devices.
How to see itSecurityCurrent password error123

For integrationWhen the password changes, invalidate all other sessions, as the message promises.

Two-step verification (2FA)

Activation with an authenticator app, backup codes and deactivation.

SuccessWarningSecurity · 2FA modal
Trigger

PlayerTaps to turn 2FA on or off in Security.

Steps
  1. Activate: the modal shows the QR code for the authenticator app.
  2. Enters the 6-digit code; the button shows “Checking…”.
  3. It's enabled and the modal shows the backup codes.
  4. Deactivating asks for confirmation and leaves the account protected by password only.
What the player sees
Field error · 2FA code
Enter all 6 digits.Incorrect or expired code. Wait for the next code.
Result screen · 2FA modal

2FA enabled

Keep these backup codes somewhere safe. Each one works only once if you lose your phone.

Toast · Activation
Two-step verification enabledYour account is now more secure.
Confirmation dialog · Disable

Disable 2FA?

Your account will be protected by your password only. We don't recommend this.

CancelDisable
Toast · Deactivation
2FA disabledYou can turn it back on anytime.
How to see itSecurityError 000000

For integrationTOTP secret, code verification and single-use backup codes. Login doesn't ask for the second factor yet (see proposals).

Active sessions

Log out one device or all except the current one.

InfoSecurity
Trigger

PlayerTaps “Close” on a device or closes all other sessions.

Steps
  1. Confirmation dialog with the device or the number of sessions.
  2. Closed sessions disappear from the list.
  3. If there are no other sessions, a notice is shown without asking for confirmation.
What the player sees
Confirmation dialog · One device

Log out on BetV1 app · iPhone 16?

That device will need to log in again.

CancelLog out
Confirmation dialog · All others

Log out of other sessions?

2 sessions will be closed. This one will stay open.

CancelLog out of all
Toast · Result
Sessions closedOnly this device's session remains open.
Toast · No other sessions
No other sessionsYou're only logged in on this device.
How to see itSecurity

For integrationSession list with device, location and last activity; revoke one or all except the current one. The Spanish and Portuguese copy uses the feminine “conectada” from the demo profile: prefer a neutral form or the player's gender.

Settings, data export and account closure

Preferences with an unsaved-changes bar, data export and permanent account closure.

SuccessWarningSettings
Trigger

PlayerChanges a preference, requests their data or closes the account.

Steps
  1. When something changes, a bar appears to save or discard.
  2. Export data: the button shows “Preparing…” and it's confirmed by email.
  3. Close account: a notice reminds the player of the currencies with a balance and their estimated total, and confirmation is requested.
  4. The account is closed and the confirmation is sent by email.
What the player sees
Toast · Save or discard
Settings savedApplies on all your devices.
Changes discarded
Toast · Export data
Request receivedWe'll send the file to valentina.r@correo.com within 24 h.
Alert · Account closure area
6 coins with a balance in your wallet, for an estimated total of ≈ $4,925.90. We recommend withdrawing it before closing your account.
Confirmation dialog · Close account

Close your account permanently?

You won't be able to recover your history, bonuses or V1 Coins. This can't be undone.

CancelClose account
Toast · Account closed
Account closedWe've sent you a confirmation by email.
How to see itSettings

For integrationPreferences synced across devices, asynchronous data export by email and a closure policy for accounts with a balance (block until withdrawn or transferred). In the prototype, closing the account doesn't end the session.

Notifications

Side panel, notification center and preferences.

InfoSide panel · Notifications
Trigger

SystemAn account event (deposit, verification, new login, tournament, mission, level) generates a notification.

Steps
  1. The header bell shows the unread counter.
  2. The side panel groups them into All, Promotions and Account.
  3. “Mark all as read” resets the counter to zero; a filter with no results shows the empty state.
What the player sees
Sample notifications · Side panel
Deposit confirmed$100.00 via Visa ···· 4242.
Identity verifiedYou can now withdraw without limits.
New loginChrome on macOS · Bogotá, CO. Wasn't you? Change your password.
Toast · Mark all as read
All caught upYou marked all notifications as read.
On-screen block · Empty filter

All caught up

No notifications in this filter. We'll let you know when something important happens.

Toast · Preferences
Preferences savedThey apply from now on.

For integrationFeed with type, title, text, date and read status; unread counter (currently fixed at 3) and an endpoint to mark as read. Minimum events: deposit confirmed, identity verified, new login, free spins, tournament position, new mission and level-up.

Multi-currency wallet

One balance per currency, with 10 cryptocurrencies and 10 local currencies. The wallet brings deposits and withdrawals together in four tabs: Summary, Deposit, Withdraw and Buy crypto. It opens from the header, the user menu, the game and the bet slip (or with #deposit and #withdraw) and is the same panel as on the Deposit and Withdraw pages. Game, sports bet slip and account use the active currency.

Wallet data the backend provides

What the prototype simulates in the browser and in production must come from the API.

InfoGlobal
Data and where it lives today
DataWhat it includesIn the prototype
CurrenciesCode, name, type (crypto or local currency), decimals, minimum deposit and USD rate; for crypto, its networks and whether a destination tag is required; for local currencies, the symbol and deposit methods.BV.wallet.CUR
NetworksName, required confirmations, estimated deposit time and withdrawal fee.BV.wallet.NETS · NET_FEE · NET_ETA
Local methodsPer currency and country: type (card, Apple Pay or Google Pay, QR, transfer, cash or redirect), processing time, minimum and maximum. Withdrawal methods are a separate list.BV.wallet.METHODS · WD_METHODS
Balances and preferencesBalance of each currency, bonus balance in USD, active currency and wallet settings (hide zero balances, crypto in fiat and display currency).BV.wallet.bal() · active() · settings()
Deposit addressesOne per player, currency and network; previous ones stay active when a new one is generated. For XRP, the player's destination tag.BV.wallet.address() · memo()
TransactionsDeposits, withdrawals and purchases with currency, amount, method or network, status and date; for crypto, also the transaction hash.BV.store("walletTx") · bv:wallet-tx
Crypto purchaseProviders with their fee, payment methods and rate.PROVS
Account holder's IDThe document each local currency requires, saved in the player's profile.BV.store("walletDocs")

For integrationToday this data is fixed in app.js (BV.wallet) and wallet.js, and balances and transactions are stored in the browser. When the API is connected, balances are updated through BV.wallet, which emits the bv:wallet event so the header, menu, wallet and game re-render at once.

Change the active currency

The active currency is the one used by games and bets.

SuccessHeader · Wallet · Game · Account
Trigger

PlayerOpens the header currency selector (also from “Play with” in a game or “Currency to play” in Settings) and picks another currency.

Steps
  1. The selector shows a search box, the currencies in two groups (Crypto and Local currency) sorted by value, and the estimated total.
  2. Each row shows the balance in its currency; with “Display crypto in fiat”, crypto is shown converted.
  3. On selection, the header, user menu, account, bet slip and game switch to the new currency.
  4. It can also be changed with “Use” in the account wallet or with “Play with” after a deposit.
What the player sees
Menu · Header currency selector
Search currency
Crypto
BTC0.01482301
USDT1,248.55
ETH0.21540000
Local currency
MXNMX$2,500.00
Estimated total ≈ $4,925.90Settings
Toast · On choosing another currency
Currency changedYou're now playing with BTC · Bitcoin.
On-screen block · Search with no matches

No results

How to see itBalances by currencyCurrency to play

For integrationActive currency saved in the player profile (currently only in the browser) and up-to-date rates to sort the currencies and calculate the estimated total. With a game open, changing currency opens a new game session with the provider.

Wallet settings

Hide zero balances and display crypto in fiat.

InfoModal · Account › Settings
Trigger

PlayerTaps “Settings” in the currency selector or in the wallet, or opens Account › Settings › Wallet.

Steps
  1. “Hide zero balances”: the selector and balances only show currencies with a balance, plus the active one.
  2. “Display crypto in fiat”: crypto balances, bets and bet slip are shown converted to the display currency, chosen from the 10 local currencies.
  3. Changes apply instantly across the site; if it was opened from the wallet, closing it returns to the summary.
  4. What is charged and paid is still in the real currency: the conversion is only visual and approximate.
What the player sees
Modal · Wallet settings

Wallet settings

How your balances are shown across the site.

  • Hide zero balancesThe currency selector only shows the currencies you hold.
  • Display crypto in fiatCrypto balances and bets are shown converted. Values are approximate.
  • Display currency
Notices · Wallet summary

14 currencies with a zero balance hidden.

Crypto amounts across the site are shown converted to USD.

Toast · Account › Settings
Display currencyTotals are now shown in EUR.
On-screen block · Account › Wallet, with a filter matching no currencies

You have no balance in these currencies

Turn off “Hide zero balances” to see them all, or make a deposit.

For integrationDisplay preferences saved in the profile. Conversion uses real-time rates (currently fixed in BV.wallet) and must be presented as approximate; bets, payouts and payments are always recorded in the native currency.

Wallet summary

Estimated total, split between crypto and local currency, and each currency's balance.

InfoWallet · Summary
Trigger

PlayerOpens the wallet from the header and chooses “Summary”, or goes to Account › Wallet.

Steps
  1. Estimated total in the display currency, with the split bar between crypto and local currency, and the bonus.
  2. One row per currency with its balance, approximate equivalent and the Deposit and Withdraw buttons; Withdraw is disabled when there's no balance.
  3. The active currency has the “In use” tag.
  4. Below, crypto deposits on their way and shortcuts to settings and history.
What the player sees
On-screen block · Total
Estimated total
$4,925.90
Crypto
97 %
Local currency
3 %
Bonus
$150.00
On-screen block · Balances by currency
BTCBitcoin0.01482301≈ $1,456.36
USDT In useTether1,248.55≈ $1,248.55
MXNMexican PesoMX$2,500.00≈ $137.36

For integrationPer-currency balances endpoint with the equivalent in the display currency and the amount held in withdrawals under review. Equivalents are indicative and recalculated with each rate update.

Open the wallet via URL

As on Stake: a link opens the wallet on a specific tab, currency and network.

InfoAny page
Trigger

PlayerOpens a link with ?modal=wallet (from an email, a notification, support or a banner).

Steps
  1. When the page loads, the wallet opens on the tab, currency and network from the link.
  2. The network accepts its code (trc20, erc20, bep20…) or an alias: tron, ethereum, bsc, solana, polygon.
  3. While it's open, the URL follows the tab, currency and network the player chooses; on close, it's cleared.
  4. tab=settings opens the wallet settings.
  5. When logged out, the login opens with a notice.
What the player sees
Toast · Link opened while logged out
Log inYou need an account to use the wallet.
Parameters
ParameterValuesExample
modalwallet?modal=wallet
taboverview · deposit · withdraw · buy · settings&tab=withdraw
currencyCurrency code, upper or lower case&currency=usdt
chainNetwork code or alias&chain=tron

For integrationDeep links for emails, push notifications, support and campaigns (“deposit USDT on Tron”). Server routes ignore these parameters; exclude them from the canonical URL and from page-view analytics.

Crypto deposit: network, address and confirmations

The player sends crypto to their own address; it's credited after the network confirmations.

PendingSuccessWallet · Deposit
Trigger

PlayerChooses a cryptocurrency in Deposit and sends funds to the address shown.

Steps
  1. At the top, a notice offers players without crypto the option to buy it by card or transfer; it leads to Buy crypto.
  2. Chooses the currency (shortcuts or search) and, if there are several, the network.
  3. Sees the QR, their address for that currency and network, the minimum, the required confirmations and the estimated time.
  4. “Generate new address” creates another one for the same currency and network; previous ones keep receiving deposits.
  5. Sends from their wallet or exchange and the site detects the transaction.
  6. Confirmations progress in “Recent deposits”.
  7. Once complete, the balance is credited, a notification arrives and the transaction appears in the history.
What the player sees
On-screen block · Purchase notice, above the crypto deposit

Buy crypto on BetV1

Pay by card or bank transfer, no crypto knowledge needed.

Buy crypto
On-screen block · USDT on Tron (TRC20)
Network
Tron
Minimum deposit
10 USDT
Confirmations
20
Arrives in
~2 min
Your USDT deposit address
TVL47fdaAW3TEHxdCQM7TvRbHCLiArv2A5
Toast and tag · Generate new address
New address generatedYour previous USDT addresses on Tron are still valid.
Address #2 · previous ones stay active
TTg2UY3sSR5wgToyc6FhSQKkuKH7PRvzUQ
Alert · Below the address
Send only USDT via Tron (TRC20). Credited after 20 confirmations. Minimum deposit: 10 USDT.
Toast · Transaction detected
Transaction detected75 USDT on the Tron network. Waiting for confirmations.
On-screen block · Recent deposits
+75 USDT · TronConfirmations 6/20
Pending
+75 USDT · TronCredited to your USDT balance
Completed
Toast and notification · On crediting
Deposit received+75 USDT credited to your wallet.
USDT deposit confirmed+75 USDT on the Tron network, after 20 confirmations.
Prototype cryptocurrencies
CurrencyNetworksMinimum depositSample rate
USDTTRC20 · ERC20 · BEP20 · SOL · POL10 USDT$1
BTCBTC0.0001 BTC$98,250
ETHERC20 · ARB · BASE0.003 ETH$3,610
USDCERC20 · SOL · BEP20 · POL10 USDC$1
SOLSOL0.05 SOL$212.40
LTCLTC0.1 LTC$96.80
DOGEDOGE25 DOGE$0.384
TRXTRC2040 TRX$0.243
XRPXRP · memo10 XRP$1.12
BNBBEP200.015 BNB$642
How to see itUSDT on TronBTC“Generate new address” and “Simulate received deposit” buttons

For integrationOne address per player, currency and network (currently derived from the player ID) and on-demand rotation: each new address is added to the watched ones and the previous ones keep crediting; monitoring of each network with its number of confirmations; webhooks for detected and confirmed transactions; crediting for the amount received. The minimum, network and notices must come from the backend, and the rates from a real-time service.

Deposit from your wallet (MetaMask, Trust, Coinbase, WalletConnect)

No need to copy the address: the wallet is connected and the transaction is approved in it.

PendingSuccessErrorWallet · Deposit
Trigger

PlayerTaps “Use your wallet” below the deposit address.

Steps
  1. The wallets appear; those that don't support the selected network are disabled.
  2. “Connect”: the connection is approved in the wallet, which then shows as connected with its address and balance.
  3. Enters the amount or taps “Max.”: the destination (their deposit address) and the network fee, paid in the wallet, are shown. On XRP, the tag is included automatically.
  4. “Confirm in MetaMask”: the transaction is approved in the wallet.
  5. “Transaction sent”: the deposit stays in “Recent deposits” and is credited after the confirmations.
What the player sees
On-screen block · Button below the address (USDT on Ethereum)

Use your wallet

Deposit from MetaMask, Trust Wallet and more

On-screen block · Wallet list
MetaMaskConnect
MetaMaskNot compatible with Tron
USDT · Tron

And 12 more wallets compatible with WalletConnect.

BetV1 will never ask for your recovery phrase or private keys.
Loading overlay and toast · Connection

Connecting to MetaMask…

Approve the connection in MetaMask.

Wallet connectedMetaMask · 0x8d2a4…dad85
On-screen block · Wallet connected
Balance in your wallet
1,072 USDT
Destination
0xa3f98…26ba1
Network fee (paid in your wallet)
≈ 3.5 USDT
Field error · Amount
Enter the amount you want to deposit.Use at most 2 decimal places.The minimum deposit is 10 USDT.You don't have enough balance in your wallet (1,072 USDT).
Loading overlay · Approval

Confirm in your wallet

Review and approve the transaction in MetaMask.

Result screen

Transaction sent

50 USDT is on its way from MetaMask. It's credited after 12 confirmations on the Ethereum network.

How to see itUSDT on EthereumUSDT on Tron (Trust only)Tap “Use your wallet”

For integrationConnection via WalletConnect v2 and injected providers (EIP-1193), with deep links on mobile to open the wallet app. The player signs the transaction in their wallet to their deposit address: check the network (chainId switch on EVM), never ask for keys, and track the deposit with the same on-chain monitoring.

XRP deposit with destination tag (memo)

XRP uses a shared address: the tag identifies the player.

ErrorWallet · Deposit
Trigger

PlayerChooses XRP in Deposit.

Steps
  1. Besides the address, the destination tag is shown, marked as required and with a copy button.
  2. A red alert reminds the player to include it.
  3. With “Use your wallet”, the tag is included in the transaction automatically.
  4. Without the tag, the deposit can't be assigned to the account.
What the player sees
On-screen block · Address and tag
Your XRP deposit address
r9ZdKykydCk2oBzhn989x5Pg9uqp1f44dB
Destination tag (memo)
114026039 Required
Alert · Below the tag
Always include the tagIf you send XRP without the destination tag 114026039, we won't be able to credit your deposit.
Help · Use your wallet

The destination tag 114026039 is included automatically.

How to see itDeposit XRP

For integrationA unique destination tag per player on networks with a shared address (XRP; also XLM, EOS or TON if added) and a support process for deposits that arrive without a tag. When withdrawing to an exchange, the tag is optional but recommended.

Local currency deposit: methods and amounts

Each local currency has its own methods, minimum and maximum.

SuccessErrorWallet · Deposit
Trigger

PlayerChooses a local currency in Deposit, for example BRL or MXN.

Steps
  1. That currency's methods appear, with converted quick amounts (equivalent to 10, 25, 50… USD).
  2. The 200% bonus is calculated in that currency, with a cap equivalent to $1.500.
  3. Below the amount, the account holder's ID document that currency requires (see the next flow).
  4. “Continue” validates the decimals, minimum, maximum and ID document, and opens the method screen.
  5. Each method type finishes differently (see the next two flows).
What the player sees
Field error · Amount in BRL
The minimum deposit is R$50.The maximum per transaction is R$54.500. Split your deposit or contact VIP support.Use at most 2 decimal places.
Field error · Amount in CLP or COP
This amount can't have decimals.
Help · Amount field

Try 666 to simulate a declined payment.

On-screen block · Bonus and summary with R$250
200% welcome bonus+R$500.00 in bonus balance
Deposit
R$250.00
Bonus
R$500.00
Total to play
R$750.00
Prototype local currencies
CurrencyDeposit withWithdraw toMinimumMax
USDCard, Apple Pay, Google Pay, Skrill, bank transferBank transfer, Skrill$10$10,000
EURCard, Apple Pay, Google Pay, Skrill, SEPASEPA, Skrill€10€9,200
GBPCard, Apple Pay, Google Pay, bank transferBank transfer£10£7,900
CADCard, InteracInteracCA$15CA$13,800
MXNSPEI, OXXO, cardSPEIMX$200MX$182,000
BRLPIX, cardPIXR$50R$54,500
ARSCVU transfer, Mercado PagoCVU, Mercado PagoAR$10,000AR$9,850,000
CLPKhipu, WebpayBank transferCLP$10,000CLP$9,450,000
COPPSE, NequiBank transfer, NequiCOL$40,000COL$41,200,000
PENYape, PagoEfectivoBank transfer, YapeS/40S/37,600
How to see itDeposit BRLDeposit MXNDeposit CLPDecline: 666, o 66600 in ARS, CLP and COP

For integrationMethods per country and currency from the processor, with minimum and maximum in the local currency (currently a fixed minimum per currency and a maximum equivalent to $10,000). Decimals and rounding per currency: CLP and COP with no decimals, the rest with 2. The bonus is calculated in USD and shown converted.

Account holder's ID in local currency deposits

Like the CPF for PIX: each currency asks for the ID document its payment method requires.

SuccessErrorWallet · Deposit
Trigger

PlayerDeposits in BRL, MXN, ARS, CLP, COP or PEN.

Steps
  1. Below the amount, that currency's ID document appears with the “Account holder's” label, prefilled with the last one used or the one from the profile.
  2. The input mask formats as you type: dots, hyphen or capitals.
  3. On continue, it's validated: CPF, RUT and CUIT by their check digit; CURP, DNI and cédula by format and length.
  4. If invalid, the field is highlighted in red and receives focus; the deposit doesn't proceed.
  5. If valid, it's remembered for that currency in future deposits. USD, EUR, GBP and CAD don't require an ID document.
What the player sees
Help · CPF field (BRL)

Try 111.111.111-11 to see the error.

Field error · Some examples
Invalid CPF: check the 11 digits.Invalid RUT: check the verification digit.Invalid CURP: it has 18 characters.
ID document by currency
CurrencyID documentFormatTest value that failsMessage
BRLCPF000.000.000-00111.111.111-11Invalid CPF: check the 11 digits.
MXNCURPAAAA000000HAAAAA00RAMV900215Invalid CURP: it has 18 characters.
ARSDNI or CUIT30.123.456123Enter a 7- or 8-digit DNI or a valid CUIT.
CLPRUT12.345.678-512.345.678-9Invalid RUT: check the verification digit.
COPCitizenship ID card1.023.456.789123The ID number must have 6 to 10 digits.
PENDNI456789121234The DNI must have 8 digits.
USD · EUR · GBP · CADNo ID document———

For integrationID document validation on the backend too (check digits for CPF, RUT and CUIT; format for CURP, DNI and cédula) and matching against the KYC-verified account holder, because the processor rejects third-party payments. Store the document in the profile per country, not just in the browser; the field and whether it's required depend on the method.

Local currency: QR, card, e-wallets and redirect

Methods confirmed on the spot: credited or declined.

SuccessErrorWallet · Deposit
Trigger

PlayerConfirms the payment on the method's screen.

Steps
  1. QR (PIX, Yape): QR code, copy-and-paste code and a 10-minute countdown; “I've paid” button. If the code expires, a new one is generated.
  2. Card: saved or new, with number, cardholder, expiry date and CVV. Apple Pay and Google Pay show the payment sheet and are confirmed on the device.
  3. Redirect (PSE, Nequi, Mercado Pago, Khipu, Webpay, Skrill, Interac): the payment is made on the provider's page.
  4. Approved: credited instantly to that currency's balance, with the option to play with it.
  5. Test amount or declined card: payment declined screen.
What the player sees
Loading overlay · QR

Verifying the payment…

This usually takes a few seconds.

Alert · Expired QR code
The code has expiredFor security, each payment code is valid for 10 minutes. Generate a new one to continue.
Generate a new code
Alert · Card screen
Your bank may ask you to confirm the payment with 3-D Secure.
Field error · New card
Enter the 16-digit card number.The card has expired or the date is invalid.3 or 4 digits.
Loading overlay · Card, Apple Pay or Google Pay

Processing payment…

Confirming with your bank (3-D Secure).

Waiting for authorization…

Confirm the payment on your device.

On-screen block · Redirect (COP · PSE)

Taking you to PSE

Authorize the COL$200,000 payment in PSE and you'll come back here automatically.

You enter your payment details on the PSE page. BetV1 doesn't see or store them.
Result screen · Approved (BRL · PIX)

Deposit confirmed!

R$250.00 is now in your BRL balance.

Play with BRLStart playingMake another deposit
Deposit confirmedR$250.00 added to your BRL balance
Result screen · Declined (with a card: “Your bank declined…”)

Payment declined

PIX declined the transaction (code 05). You haven't been charged. Try another method or contact your bank.

Try another methodContact support
Toast · Contact support
Live supportAn agent will reply in under 1 minute.
How to see itPIX in BRLPSE in COPNew card 4000 0000 0000 0002

For integrationProcessor response with the status (approved, declined with code, pending), a return URL for redirects and a webhook for payments confirmed outside the page. The balance is credited in the deposit currency, with no conversion. Tokenized card (never the full number) with 3-D Secure; QR codes with an expiry; and each decline code (05 not authorized, 51 insufficient funds…) mapped to a message for the player.

Local currency: transfer or cash payment

The deposit stays pending until the payment arrives.

PendingWallet · Deposit
Trigger

PlayerChooses a transfer (bank, SEPA, SPEI or CVU) or a cash payment (OXXO or PagoEfectivo).

Steps
  1. Transfer: bank details for each currency (CLABE, CVU and alias, IBAN or account number) with a mandatory reference and copy buttons.
  2. Cash: payment slip with barcode, reference and a 48-hour expiry.
  3. “I've made the transfer” or “I have my payment slip” records the deposit.
  4. It stays pending in the history and a notification is sent when it arrives.
What the player sees
Alert · Transfer details
Transfer from an account in your name and include the reference, or the deposit will take longer to be credited.
Result screen · Transfer in USD

Awaiting confirmation

Pending

We'll credit $50.00 to your USD balance as soon as we receive the transfer (1–2 business days). We'll send you a notification.

Loading overlay · Payment slip

Registering your slip…

We'll let you know as soon as it's paid.

Result screen · OXXO in MXN

Waiting for your payment

Pending

Pay MX$1,000.00 with your OXXO slip before Nov 18, 23:59. We'll credit it to your MXN balance and send you a notification.

For integrationA unique reference per player and transaction for reconciliation, slip expiry, a webhook from the bank or cash payment network, and expiry of payments that never arrive. The later confirmation isn't simulated (see proposals).

Crypto withdrawal

Network, validated address, network fee, confirmation and security review.

SuccessErrorWarningWallet · Withdraw
Trigger

PlayerChooses a cryptocurrency with a balance in Withdraw.

Steps
  1. Without a verified identity, an alert says so and the withdrawal button is disabled.
  2. Shortcuts for the currencies with a balance; the available amount and its equivalent are shown.
  3. Chooses the network and pastes the address (“Paste” button or by hand): the format is validated while typing. “Use a sample one” fills in a valid one.
  4. Enters the amount or taps “Max.”: the network fee, estimated time and what they'll receive are shown.
  5. Confirmation screen with all the details.
  6. The balance is debited and the withdrawal stays “Under review” before it's sent.
What the player sees
Alert · Identity unverified or under review
Your verification is under reviewYou'll be able to withdraw as soon as we approve it. It usually takes less than 24 h.
View status

Withdrawals are enabled once you verify your identity.

Field messages · Destination address
Paste the destination address.This address isn't valid for the Tron network.
Valid address for Tron
Toast · “Paste” without clipboard permission
We couldn't read the clipboardLong-press the field and choose Paste, or use Ctrl+V.
Field error · Amount
Enter the amount you want to withdraw.The minimum withdrawal is 10 USDT.The amount exceeds your available balance (1,248.55 USDT).
Confirmation screen

Confirm your withdrawal

Check the details: withdrawals can't be cancelled once sent.

Confirm withdrawal of 50 USDTEdit
We review every withdrawal for security before sending it. We'll let you know when it's sent.
Result screen · Withdrawal under review

Withdrawal requested

Under review

50 USDT will be sent to TX2JnTr…LEgUD (TRC20) as soon as we finish the security review. It usually takes less than 15 minutes.

Withdrawal requested50 USDT · under review
Prototype networks
NetworkDeposit confirmationsDeposit arrives inWithdrawal fee
BTC · Bitcoin2~20 min$2.50
LTC · Litecoin6~10 min$0.05
DOGE · Dogecoin40~10 min$0.80
XRP · XRP Ledger1~1 min$0.25
ERC20 · Ethereum12~3 min$3.50
ARB · Arbitrum One12~1 min$0.30
BASE · Base12~1 min$0.15
TRC20 · Tron20~2 min$1.00
BEP20 · BNB Smart Chain15~1 min$0.30
SOL · Solana32~1 min$0.05
POL · Polygon128~5 min$0.10

The fee is charged in the withdrawn currency, at the exchange rate. The minimum withdrawal is the higher of the currency's minimum and twice the fee, and the withdrawal takes about 10 minutes longer than a deposit on that network.

For integrationServer-side address validation per network (format and checksum), enabled networks per currency, up-to-date network fee, withdrawal minimum, balance hold on request, security review and the transaction hash once sent. Optional destination tag for XRP. The server must also reject withdrawals without approved KYC and apply the daily maximum of each verification level. The “Paste” button uses the Clipboard API, which requires HTTPS and browser permission.

Local currency withdrawal

Withdrawal methods per currency, with no fee, to an account in the holder's name.

SuccessErrorWallet · Withdraw
Trigger

PlayerChooses a local currency with a balance in Withdraw, for example MXN.

Steps
  1. That currency's withdrawal methods appear, fee-free and with their processing time.
  2. Asks for the method's payout details: CLABE, CVU or alias, IBAN, PIX key, email, mobile number, or bank and account number.
  3. The account must be in the account holder's name; each field is validated.
  4. Confirmation, then the withdrawal goes “Under review”, as with crypto.
What the player sees
Field error · Payout details and amount
The CLABE must have 18 digits.Enter your PIX key (CPF, email, mobile or random key).The minimum withdrawal is MX$200,00.
Help · Below the payout details

The account must be in the account holder's name: Valentina Ramírez.

Result screen · SPEI in MXN

Withdrawal requested

Under review

MX$1,000.00 will be sent to SPEI ···· 7890 as soon as we finish the security review. It usually takes less than 15 minutes.

Withdrawal requestedMX$1,000.00 · under review

For integrationPayout details validated per country (CLABE with check digit, CVU, IBAN, PIX key), ownership verification and withdrawal methods specific to each currency, different from the deposit ones (see the local currencies table).

Withdrawals in progress and cancellation

The Withdraw page lists withdrawals in progress, each in its currency; those not yet sent can be cancelled.

InfoWithdraw page
Trigger

PlayerTaps “Cancel” on a withdrawal in “Withdrawals in progress”.

Steps
  1. Each withdrawal shows the amount, currency, method or network, reference and status: “Pending”, “Processing” or “Under review”.
  2. Withdrawals just requested in the wallet go through their security review and can't be cancelled from here.
  3. Confirmation dialog with the amount in its currency.
  4. The withdrawal disappears from the list and the amount returns to that currency's balance.
  5. If no withdrawals remain, the empty state is shown.
What the player sees
Confirmation dialog

Cancel this withdrawal?

MX$1,200.00 will return to your MXN balance instantly.

CancelCancel withdrawal
Toast · Global
Withdrawal canceledMX$1,200.00 returned to your balance
On-screen block · Empty list

You have no withdrawals in progress

When you request a withdrawal, you can track it here.

How to see itWithdraw page

For integrationList of withdrawals in progress with currency, amount, method or network, reference (WD-…) and status. Cancellable only until the payment has been sent: the server decides and returns the updated balance of that currency.

Buy crypto through a provider

Purchase with local currency through MoonPay, Banxa or Transak.

SuccessPendingWallet · Buy crypto
Trigger

PlayerOpens “Buy crypto” in the wallet or taps “Buy with a card” in a crypto deposit.

Steps
  1. Reached from the tab, from the “Buy crypto on BetV1” notice in the crypto deposit, or via URL.
  2. Chooses how much to pay in local currency and which crypto to receive.
  3. Compares providers and their fees; the one that gives the most crypto gets “Best price”.
  4. The summary shows price, provider fee, network fee and what they'll receive.
  5. Redirect to the provider and wait for its confirmation.
  6. The crypto arrives at their deposit address and is credited after the network confirmations.
What the player sees
Field error · Amount in USD
The minimum purchase is $30.The maximum purchase is $20.000.
Summary · $100 with MoonPay
Price
1 USDT ≈ $1.00
MoonPay fee
$4.50
Network fee
$1.00
You'll receive
≈ 94.5 USDT
Best price

The crypto arrives at your BetV1 deposit address on the Tron network. The provider may ask you to verify your identity.

Loading overlay · Two stages

Redirecting to MoonPay…

Complete the payment in MoonPay. You'll come back here automatically.

Waiting for confirmation from MoonPay…

This usually takes a few seconds.

Result screen · Purchase on its way

Purchase on its way

MoonPay confirmed your payment of $100.00. You'll receive 94.5 USDT in your wallet in a few minutes.

Transaction detected94.5 USDT on the Tron network. Waiting for confirmations.

For integrationOn-ramp integration (widget or redirect) with real-time quotes, provider KYC, an order-completed webhook and delivery to the player's deposit address; then the crypto deposit flow continues. The prototype's fees are examples.

Playing with a currency

Currency you play with and currency the game is shown in.

InfoGame page · Iframe
Trigger

PlayerOpens a game while logged in.

Steps
  1. The landing screen shows “Play with” (the active currency, which opens the selector) and the available balance with its equivalent.
  2. With crypto, “Show game in” appears: balance and bets can be shown in a local currency; by default, the one from the wallet settings.
  3. The game loads with those two currencies and converted bets, about $1 by default; the bar shows “Real money · BTC”.
  4. If the player changes currency or display currency with the game open, the game reloads when the current spin ends (see Game bar).
What the player sees
Game landing screen · With BTC active
Play withBTCShow game inUSD

Available balance: 0.01482301 BTC ≈ $1,456.36

Tag · Game and iframe bar
Real money · BTCShown in USD
Loading overlay · Change with the game open

Switching to BTC · shown in USD

Loading graphics and sound

For integrationThe game provider receives the session currency and, if it's crypto, the display currency (today &cur and &display in the iframe URL). Many providers only accept fiat: convert at a fixed rate for the session, with each currency's decimals and converted minimum bets.

Game bar and “In game” balance

As on Stake: controls below the game, and the header balance moves into the game.

InfoWarningGame page · Header
Trigger

PlayerOpens a game and uses the bar below it.

Steps
  1. Below the game there's a bar with full screen, theater mode and exit (exit only with a game open); on mobile, inside the full-screen layer.
  2. “Playing currency” opens the currency selector; “Show in”, only with crypto, picks the display currency.
  3. “Fun | Real play” switches mode: with no game open, it opens one; with a game open, it reloads it in the other mode. Real play while logged out opens the login.
  4. With real money open, the header shows “(In game) BTC” instead of the balance, because the balance lives inside the game.
  5. A currency or mode change during a spin waits for the result; exiting mid-spin settles the result immediately.
What the player sees
Game bar · Controls
Full screenTheater modeExitBTCShow inUSD
FunReal play
Header · With a real-money game open
(In game)BTC
Loading overlay · Currency change after the spin

Switching to USDT

Loading graphics and sound

How to see itReal play with BTCLanding screen with the barSpin and change currency in the bar during the spin

For integrationOne game session per currency with the provider; the game must signal the start and end of each round (here, {type:"bv:spin", on}) so it doesn't reload mid-round, and the provider must close or settle the round if the player exits. While a real-money game is open, the header balance is hidden because the game manages it.

No balance in the game currency

In-game notice with three options.

ErrorGame (iframe)
Trigger

PlayerSpins with a bet higher than their balance in the active currency.

Steps
  1. The game doesn't spin and shows the notice inside the game itself.
  2. “Deposit” opens the wallet; “Change currency” opens the page's selector.
  3. “Lower the bet” only appears if there's a smaller bet the balance can cover.
What the player sees
In-game notice · LTC with no balance

Insufficient balance

Your LTC balance (0.00 LTC) isn't enough for a 0.01 LTC bet.

DepositChange currencyLower the bet
How to see itPlay with LTC, no balanceSpin with the initial bet

For integrationAn “insufficient funds” response from the wallet in the session currency. The game asks the page to open the wallet or the selector with the {type:"bv:open"} and {type:"bv:curmenu"} messages.

Bet slip and My bets in the active currency

The bet is charged in the active currency and keeps its currency.

InfoErrorBet slip · My bets
Trigger

PlayerBets with an active currency other than the dollar.

Steps
  1. The stake uses the active currency, with its icon and converted quick amounts (equivalent to 5, 10, 25 and 50 USD).
  2. If the active currency is crypto and it's displayed in fiat, the amount is entered in that currency and the amount charged in crypto is shown.
  3. The minimum (equivalent to $1) and the active currency's balance are validated.
  4. The bet keeps its currency: in My bets, stake, cash out and payout are shown in it.
What the player sees
Help · Bet slip with BTC shown in USD

Charged in BTC: 0.00010178 BTC

Field error · Stake
The minimum stake is 1.00 USDT.Insufficient balance: you have 0.00 LTC.
Toast · Bet placed
Bet placedBet slip BV-26114807 · 10.00 USDT
My bets · Currency of each bet
USDTBTCMXN

Cash out available: 0.00059

Value updated based on the score.

For integrationPlacement, cash out and settlement in the bet's currency; per-market bet limits converted from USD and rounded to each currency's decimals.

Account pages

Wallet, Deposit, Withdraw, History, Settings and Bonuses.

InfoAccount
Trigger

PlayerOpens their account pages.

Steps
  1. Wallet: balances by currency with a filter (All, Crypto, Local currency), breakdown and buttons to use, deposit and withdraw each currency.
  2. Deposit and Withdraw: the wallet panel on the page and, beside it, the networks or methods of the selected currency with minimums and fees.
  3. History: filter by currency; for crypto, the hash opens a simulated block explorer.
  4. Settings: currency to play, display currency and the two wallet settings.
  5. Bonuses: the wagering requirement is calculated in USD.
What the player sees
Note · Withdraw, crypto side panel

The network fee is deducted from the amount. Check the network before withdrawing: funds sent to another network can't be recovered.

Toast · History, on tapping a hash
Block explorerPrototype: tronscan.org would open here with transaction 9f2c4a…71be.
Note · Bonuses

The bonus is calculated in USD. When you play in crypto or local currency, each bet counts toward the wagering requirement at its USD value at that moment.

Alert · Settings › Close account
6 coins with a balance in your wallet, for an estimated total of ≈ $4,925.90. We recommend withdrawing it before closing your account.

For integrationHistory with currency, network, hash and status for each transaction; account totals in the display currency; the same minimum, fee and network rules as in the wallet; and USD conversion of each bet for the bonus requirement.

Bonuses and balance

Real balance vs. bonus balance, wagering requirement, bonus cancellation, offers and promo codes.

Balance per currency and bonus balance

What moves each balance and what can be withdrawn.

InfoHeader · Menu · Wallet
Trigger

SystemEvery deposit, bonus, bet, prize or withdrawal moves one of the two balances.

Prototype rules
  1. There's one balance per currency (see Wallet summary). The bonus is held in USD and shown converted; each bet counts toward the requirement based on its USD value.
  2. The deposit adds to the balance of its currency; the deposit bonus, to the bonus balance.
  3. Real-money games, bets and cash out debit and credit the balance of the currency used to play or bet.
  4. Mini game prizes go to the balance the prize indicates (real, bonus, coins or XP).
  5. Only each currency's balance is withdrawable; the bonus isn't.
What the player sees
On-screen block · User menu
Active currency
1,248.55 USDT
Total with bonus
≈ $5,075.90
On-screen block · Wallet · Withdraw
Available to withdraw
1,248.55 USDT

For integrationEndpoint for balances per currency, bonus balance, V1 Coins and amount held in withdrawals, plus an update event to re-render all views at once (on the front end, the bv:wallet event and the elements with data-user and data-wallet-active).

Wagering requirement (rollover)

Active bonus progress, contribution per game and expiry.

WarningBonuses · Wallet
Trigger

SystemEach bet with an active bonus counts toward the requirement based on the game type.

Steps
  1. Ring and bar with the percentage wagered (41% in the demo).
  2. Contribution: slots 100%, table games and roulette 10%, live casino 0%.
  3. Countdown to the bonus expiry.
What the player sees
On-screen block · Active bonus
Bonus balance
$150.00
Wagered
$2,150.00
Wagering requirement
$5,250.00
Expires in 5d 2h 00m
Note · Bonus rules
Max bet with an active bonus: $5 per spin. If you withdraw before meeting the wagering requirement, you lose the bonus and its winnings.
How to see itBonusesWallet

For integrationWagering progress (wagered vs. requirement), contribution by game type, max bet, expiry date and the forfeit-on-withdrawal rule. The completed and expired bonus states are missing (see proposals).

Cancel the active bonus

The bonus balance is forfeited and withdrawals are possible without requirements.

WarningBonuses
Trigger

PlayerTaps “Cancel bonus” on the active bonus.

Steps
  1. Confirmation dialog with the bonus balance that will be forfeited.
  2. The bonus balance goes to $0; the real balance doesn't change.
  3. The bonus block is replaced by the empty state.
What the player sees
Confirmation dialog

Cancel the welcome bonus?

You'll lose $150.00 in bonus balance and the related winnings. Your real balance won't change.

CancelCancel bonus
Toast · Global
Bonus canceledYou can now withdraw with no wagering requirements.
On-screen block · No active bonus

You have no active deposit bonuses

Activate an available offer or make a deposit to get your next bonus.

How to see itBonusesTo get the bonus back: “Reset demo data” in the layers panel

For integrationBonus cancellation with the forfeited associated winnings calculated server-side and logged in the bonus history.

Activate offers and promotions

Available offers in Bonuses and Promotions, with opt-in.

SuccessBonuses · Promotions
Trigger

PlayerTaps “Activate” on an offer or joins a promotion.

Steps
  1. The button shows “Activating…”.
  2. The button is replaced by the “Activated” tag.
What the player sees
Toast · Bonuses · Available
Offer activatedReload Friday · 50% up to $300
Toast · Promotions
Promotion activatedFriday reload will apply to your next eligible deposit.

For integrationOffer enrollment with its conditions (minimum deposit, days, rollover) and each offer's status per player.

Redeem a promo code

Valid, expired or nonexistent code.

SuccessErrorBonuses
Trigger

PlayerEnters a code and taps redeem.

Steps
  1. The button shows “Validating…”.
  2. Valid: the field turns green and a toast shows the reward.
  3. Expired or nonexistent: the field shows the reason.
What the player sees
Toast · Valid code
Code redeemed25 free spins on Sweet Bonanza 1000
Field error · Code
Enter a promo code.This code expired on Oct 31, 2026.Code “HOLA” doesn't exist. Check capital letters and hyphens.
How to see itBonusesValid BETV1Expired CADUCADO

For integrationCode validation with its reward or the error reason (expired with date, nonexistent, already used, not eligible).

Game

The game loads in an iframe (casino/launch), just as with a real provider, and communicates with the page via postMessage.

Open a game while logged out

The demo is open to everyone; real money and VIP rooms require logging in.

InfoGame page · Live casino
Trigger

PlayerOpens a game page or the live casino while logged out.

Steps
  1. The landing screen offers “Play for real money” and “Try the free demo”.
  2. “Try the free demo” starts the demo without an account.
  3. “Play for real money” opens the login with a toast; with ?mode=real in the URL, the login opens on load.
What the player sees
Help · Game landing screen

Log in to play for real money. The demo doesn't require an account.

Toast · On tapping real money
Log in to play with real moneyYou can also try the demo without an account.
Alert · Live casino, VIP tables
Exclusive rooms for VIP playersLog in to see your level and access limits of up to $25,000 per hand.
Log in

For integrationReal-money launch requires a session; demo launch can be public using the provider's demo URL.

Demo and real money

Game loading, with mode and balance visible in the game bar.

SuccessGame page
Trigger

PlayerTaps “Play for real money” (logged in) or “Try the free demo”.

Steps
  1. The landing screen adds “Play with” and, with crypto, “Show game in”; the bar shows the currency (see Playing with a currency).
  2. Three-phase loading bar while the iframe loads in the background.
  3. The game opens on the stage; on mobile, in full screen with a balance bar and deposit button.
  4. The bar shows the mode: real money with the account balance, or demo with its own $1.000.
  5. The game is added to “Recently played”.
What the player sees
Loading overlay · Bar stages

Connecting to the Pragmatic Play server

Loading graphics and sound

Preparing your secure session

Tags · Game bar
Demo modeReal money
Help · Landing screen, logged in

Available balance: 1,248.55 USDT ≈ $1,248.55

For integrationLaunch endpoint that returns the provider URL for the player and mode (game session token). If real money is requested without a session, the iframe starts in demo.

Insufficient balance or demo balance used up

The spin bet exceeds the available balance.

ErrorInfoGame (iframe)
Trigger

PlayerSpins with a bet higher than their balance.

Steps
  1. The game doesn't spin.
  2. Real money: the game shows its own notice with “Deposit”, “Change currency” and “Lower the bet” (see No balance in the game currency).
  3. Demo: the demo balance resets to $1,000 automatically.
What the player sees
Toast · Demo
Demo balance topped upYou have $1,000.00 again to try the game.
How to see itPlay with LTC, no balanceSpin with the initial betDirect demo

For integrationThe provider or wallet responds “insufficient funds” in the session currency; the game asks the page to open the wallet without closing (see Balance sync with the iframe).

Balance sync with the iframe

Messages between the game and the page so the balance is the same everywhere.

InfoGame page · Header
Trigger

SystemEvery spin, prize or deposit during the session changes the balance.

Steps
  1. Real money: the iframe receives the currency (&cur) and the display currency (&display) and uses the page's wallet, from the same origin; the menu, wallet and game bar are re-rendered with the bv:wallet event, and the header shows “(In game)” while the game is open.
  2. Demo: the iframe reports its own balance and only the game bar changes.
  3. If the player deposits in the wallet while playing, the game uses the new balance on the next spin.
  4. A win of x20 or more is announced with a toast on the page.
What the player sees
Toast · Big win
Big win!$250.00 on Gates of Olympus 1000 · x250
In the game · Result of each spin
WinBig win!No win this time
postMessage messages from the iframe to the page
MessageWhenEffect on the page
{type:"bv:demo", balance}Demo balance changeUpdates the demo balance in the bar
{type:"bv:open", id:"wallet", tab:"deposit"}“Deposit” in the no-balance noticeOpens the wallet on Deposit
{type:"bv:toast", title, text, kind}Game noticesShows the toast on the page
{type:"bv:curmenu"}“Change currency” in the no-balance noticeOpens the currency selector from the game bar
{type:"bv:spin", on}Start and end of each real-money spinA currency or mode change waits for the end of the spin
{type:"bv:esc"}Escape key inside the gameCloses the full-screen game on mobile
How to see itGame, logged inPlay with real money and watch the balance in the user menu

For integrationWith a real provider, the authoritative balance comes from the backend wallet: listen to the provider's events (or query the balance) and validate the origin of every postMessage, which today is sent to any origin.

Full screen and closing the game

Theater mode, full screen, and closing when the session ends.

WarningGame page
Trigger

PlayerTaps full screen, theater mode or close, or logs out with the game open.

Steps
  1. Full screen uses the browser API; if it isn't allowed, a notice is shown.
  2. On mobile, Back or Escape closes the game layer.
  3. If the session ends during a real-money game, the game stops and returns to the landing screen.
What the player sees
Toast · Browser without permission
Full screen unavailableYour browser didn't allow full-screen mode.
Toast · Browser without the feature
Full screen unavailableUse theater mode on this device.
How to see itDirect demo

For integrationOn logout, also invalidate the provider's game session token.

Favorites and recently played

Heart icon on each game, lists and empty states.

SuccessInfoCards · Favorites · Recent
Trigger

PlayerTaps a game's heart, opens their lists or clears them.

Steps
  1. The heart is filled on every card of the same game.
  2. Logged out, Favorites invites the player to log in; logged in with no games, it suggests popular ones.
  3. Clearing the list asks for confirmation.
What the player sees
Toast · Heart
Added to favoritesGates of Olympus 1000
Removed from favoritesGates of Olympus 1000
On-screen block · Favorites, logged out

Save your favorite games

Log in to see your list on any device and get alerts when your games have tournaments or free spins.

On-screen block · Empty favorites

You don't have any favorites yet

Hover over a game and tap the heart. Here are some of the most played to get you started.

Confirmation dialog · Clear favorites

Remove all your favorites?

Your list will be empty. You can add games again anytime.

CancelRemove all

For integrationFavorites and recent games are currently stored only on the device (localStorage): persist them to the account so they're visible on any device, as the message promises.

Search and filters with no results

Quick search, search page and filtered listings.

InfoSearch · Categories · Live
Trigger

PlayerSearches for a term with no matches or combines filters that return no games.

Steps
  1. Search starts filtering from 2 characters and ignores accents.
  2. With no search term, it shows popular searches and trends.
  3. With no matches, it shows the empty state with suggestions or “Clear filters”.
What the player sees
On-screen block · Search

No results for «zzzz»

Check the spelling or try a provider name, e.g. Pragmatic or Evolution.

On-screen block · Live casino with filters

No tables match these filters

Try another category or clear the search to see all 81 tables.

Clear filters

For integrationServer-side search across games and providers with accent normalization and pagination; today it filters the local catalog.

Sports

Bet slip (side panel on desktop, bottom sheet on mobile), changing odds, bet placement and cash out.

Bet slip: singles and accumulator

How selections are added and which combinations are allowed.

InfoWarningBet slip
Trigger

PlayerTaps odds in sports, live or on a match, or adds a suggested accumulator.

Steps
  1. Each tapped odds button is added to the bet slip; another one from the same market replaces it.
  2. With 2 or more selections it switches to accumulator automatically, unless the player chose Single.
  3. With 3 or more selections in an accumulator, a 10% boost is added.
  4. If two selections are from the same match, the accumulator can't be placed.
What the player sees
On-screen block · Empty bet slip

Your bet slip is empty

Tap any odds to add them. Combine 3 or more selections and win 10% extra.

Alert · Accumulator with one selection
Add another selectionAn accumulator needs at least 2 selections from different matches.
Alert · Same match, button disabled
Related selectionsTwo selections are from the same match. Use “Build your bet” on the event or bet them as Singles.
Toast · Suggested accumulator
Accumulator addedChampions League Night · odds 5.53

For integrationAccumulator rules (related selections, minimum selections, bonus by number of selections), also validated on the server.

Odds changed

Odds on the bet slip change before the bet is placed.

WarningBet slip
Trigger

SystemThe odds feed changes a selection that is in the bet slip.

Steps
  1. If the odds rise and “Automatically accept higher odds” is ticked, the change is accepted without notice.
  2. Otherwise, the selection is marked with an up or down arrow and the alert appears.
  3. The bet button changes to “Accept changes”.
  4. Once accepted, the bet slip allows betting again.
What the player sees
Toast · On change
Odds changedReal Madrid: 2.65
Alert · Bet slip
The odds have changedReview the highlighted selections and accept the changes to continue.
Toast · On accept
Odds updatedYou can now confirm your bet.
How to see itBet slip with changed odds“simulate an odds change” link inside the bet slip

For integrationReal-time odds feed (WebSocket) and an “odds changed” placement response with the new odds; player preference to accept increases.

Invalid stake or insufficient balance

Stake validation when placing a bet.

ErrorBet slip
Trigger

PlayerTaps bet with a stake below the minimum or above their balance, or while logged out.

Steps
  1. When logged out, the button reads “Log in to bet” and opens the login.
  2. Logged in, the total stake is validated (per selection for singles).
  3. The minimum and balance are those of the active currency, for example “Insufficient balance: you have 0.00 LTC.” (see Bet slip and My bets in the active currency).
  4. The stake field shows the error and, if the balance is short, the alert with “Deposit” appears.
What the player sees
Field error · Stake
The minimum stake is $1,00.Insufficient balance: you have $5,00.
Alert · Bet slip
Insufficient balanceYou need $5.00 more for this bet.
Deposit

For integrationMinimum and maximum stake per market and a balance check at placement, returning the missing amount for the message.

Bet placed

The bet is placed, the balance is debited and the bet slip is issued.

SuccessBet slip · My bets
Trigger

PlayerTaps “Place bet” with a valid stake.

Steps
  1. The button shows “Placing bet…”.
  2. The amount is deducted from the real balance.
  3. The bet slip shows the confirmation with the bet slip number, which can be copied.
  4. The bet appears in My bets as open; the bet slip can be reused or a new one started.
What the player sees
Result screen · Bet slip, by bet type

Bet placed!

Your 3-selection accumulator is in play. We'll let you know as each result comes in.

Your single bet is in play. We'll let you know the result.

3 single bets placed. We'll let you know as each result comes in.

Toast · Global
Bet placedBet slip BV-26114807 · $10.00

For integrationPlacement response with bet slip ID, final odds and status (accepted, rejected or pending operator approval). Rejection isn't simulated (see proposals).

Cash out

Cash out an open bet before it ends.

SuccessWarningMy bets
Trigger

PlayerTaps “Cash out” on an open bet with cash out available.

Steps
  1. The bet shows the cash out value, which updates with the score.
  2. Confirmation dialog with the amount and potential winnings.
  3. The button shows “Cashing out…”; the bet closes with the “Cash out” tag.
  4. Amounts are shown in each bet's currency, for example “Cash out 61.30 USDT”.
  5. The amount is added to the balance of the bet's currency.
What the player sees
On-screen block · Open bet

Cash out available: $61.30

Value updated based on the score.

Confirmation dialog

Cash out $61.30 now?

The bet will be closed and the amount added to your real balance instantly. Current potential winnings: $174,80.

CancelCash out $61.30
Toast · Global
Cashed out$61.30 added to your balance
Alert · Market under review
Cash out temporarily suspendedThe market is under review after a play. Try again in a few seconds.
How to see itMy bets

For integrationReal-time cash out value, suspension per market and confirmation with the final amount, which may change between the offer and acceptance.

Bet statuses

Tags for the bet slip and each selection in My bets.

InfoMy bets
Trigger

SystemMatches progress and selections are settled.

Steps
  1. Open and settled tabs.
  2. Each selection shows its own status within the bet slip.
  3. With no bets in the tab, the empty state is shown.
What the player sees
Tags · Bet slip
OpenWonLostCash out
Tags · Selection
In playPendingWonLostCashed out
On-screen block · No bets

You have no open bets

How to see itMy betsLogged out

For integrationSettlement per selection and per bet slip, with events to notify each result, as the bet confirmation promises.

Club

Missions, tournaments, V1 Coins store and mini games. When logged out, each screen shows a prompt to log in or sign up.

Missions: claim the reward

New, active, completed, locked and expired missions.

SuccessMissions
Trigger

PlayerTaps “Claim” on a completed mission.

Steps
  1. Missions progress automatically during play; locked ones show the “Locked” tag.
  2. Once completed, “Claim” appears; when logged out, it opens the login.
  3. The XP or coins are added, with confetti, and the mission becomes “Claimed”.
What the player sees
Toast · Global
Reward claimed+500 XP added to your account
Alert · Missions, logged out
Log in to track your progressMissions activate automatically when you play with your account.
Log in
Tags · Mission
LockedClaimed

For integrationMission progress from game events, an idempotent claim endpoint and unlock conditions (level or previous mission).

Tournaments: join or get notified

Active, upcoming and finished tournaments.

SuccessInfoTournaments
Trigger

PlayerTaps join on an active tournament or asks to be notified about an upcoming one.

Steps
  1. When logged out, the login opens with a toast.
  2. The button shows “Joining…” or “Saving…”.
  3. The card is marked as joined.
What the player sees
Toast · Logged out
Log in to take partJoining a tournament is free.
Toast · Join
You're in!Aurora Slots Race · your bets now earn points.
Toast · Upcoming tournament
We'll let you knowVIP Olympus · you'll get a notification when it starts.

For integrationTournament enrollment and subscription to the start alert (push or in-panel notification).

Tournament details: in progress, not joined and finished

Leaderboard, player position and prize.

InfoTournament details
Trigger

SystemThe tournament status and the player's enrollment change what the page shows.

Steps
  1. Logged out: invites the player to create an account.
  2. Logged in and not joined: “Join for free” button, with confetti on joining.
  3. Joined: highlighted position on the leaderboard and points to the next tier.
  4. Finished: end date and prize credited.
What the player sees
On-screen block · Not joined

You haven't joined yet

Join for free and your next bets on participating games will earn points.

Join for free
On-screen block · Logged out

Compete for $50,000

Create your account, join the tournament and earn points from your very first spin.

On-screen block · Your position, in progress and finished

Your position

You're 1,120 pts away from the Top 10 ($1,000).

Prize credited to your real balance on Nov 14.

Ended on Nov 14

For integrationReal-time leaderboard with the player's position, current prize, points to the next tier and automatic prize settlement at the end.

Store: redeem with V1 Coins

Redemption, insufficient coins and sold-out prizes.

SuccessErrorStore
Trigger

PlayerTaps Redeem on a store prize.

Steps
  1. Prizes the player can't afford appear dimmed; sold-out ones have the button disabled.
  2. Without enough coins, the card shakes and an error toast appears.
  3. With enough coins, a confirmation dialog with the remaining balance.
  4. The coins are deducted, the redemption goes into the history and there's confetti.
What the player sees
Toast · Not enough coins
Not enough coinsYou need 3,050 more coins for “$100 bonus”.
Confirmation dialog

Redeem this prize?

$25 bonus for 1,500 V1 Coins. You'll have 950 left.

CancelRedeem 1,500
Toast · Redemption
Redeemed!$25 bonus is now in your account.
Alert · Store, logged out
Earn V1 Coins as you playCreate your account and get 200 welcome coins for your first redemption.
Create account
Sold out
How to see itStoreNot enough coins: “$100 bonus” (5,500)Logged out

For integrationCatalog with price, stock and availability; redemption with an atomic coin deduction and delivery of the prize to the corresponding balance or spins.

Mini games: wheel, scratch & win and mystery box

Daily prizes with prize modal and confetti.

SuccessErrorMini games
Trigger

PlayerSpins the wheel, scratches a card or opens a box.

Steps
  1. Aurora Wheel: one free spin every 24 hours; after that it shows the countdown.
  2. Scratch & Win: scratching reveals the prize; another card costs 100 V1 Coins.
  3. Mystery Box: one free box per day; when logged out, it opens the login.
  4. The prize is credited and the prize modal is shown.
What the player sees
Tags · Wheel status
1 spin availableNo spins available

Next free spin in 23:59:59

Prize modal · Wheel and box
Aurora Wheel

You won 50 free spins!

They're already in your account. Use them within 48 hours.

Toast · Scratch & Win, logged in and out
Prize revealed!300 V1 Coins for the store · credited
Prize revealed!25 free spins on Fortune Ox · create your account to collect it
Toast · Another card
Not enough coinsYou need 100 V1 Coins for another card.
New card ready100 V1 Coins were deducted.
Toast · Mystery Box, logged out
Log in to open the boxOne free box a day from VIP Silver.

For integrationThe server decides the prize, never the front end, with daily eligibility, coin cost and crediting to the corresponding balance. After spinning, “Reload spin” repeats the wheel only in the prototype.

Responsible gaming

Deposit, loss and session limits, reality check, time-out and self-exclusion, on the account's Responsible gaming page.

Deposit limits

Lowering a limit applies instantly; raising it takes 24 hours.

SuccessWarningResponsible gaming
Trigger

PlayerTaps “Change limit” on the daily, weekly or monthly limit and saves.

Steps
  1. The amount is validated (greater than 0 and up to $100,000); the button shows “Saving…”.
  2. Decrease: applies immediately, with the usage bar updated and the “Active” tag.
  3. Raising: it stays pending for 24 hours with the “Change pending” label.
  4. The wallet doesn't check the limit on deposit yet (see proposals).
What the player sees
Field error · Limit amount
Enter an amount greater than 0.The maximum allowed is $100.000.
Toast · Lowering
Daily limit updatedApplies from now: $300.
Toast · Raising
Increase scheduledDaily limit of $800 takes effect in 24 hours.
ActiveChange pending
How to see itLimitsCurrent daily limit $500: try 300 and 800

For integrationPer-period limits with the amount used, a 24-hour cooling-off period for increases, immediate application of decreases and blocking of any deposit that exceeds them.

Loss and session limits and reality check

Setting up additional limits and in-game alerts.

SuccessInfoResponsible gaming
Trigger

PlayerAdds a loss or wager limit, or chooses the session length and reminder frequency.

Steps
  1. Net loss or total wagered, daily, weekly or monthly: added to the list as “Active”.
  2. Session limit: 30 min, 1 h, 2 h, 4 h or no limit.
  3. Reminder: every 15, 30 or 60 min, or off.
What the player sees
Toast · Limit added
Limit addedNet loss · weekly: $200
Toast · Session
Session limit: 1 hWe'll warn you 5 minutes before it ends.
Toast · Reminder
Reminder every 30 minYou'll see your time played and your session result.

For integrationThe 5-minute warning, the closure when the limit is reached and the reminder itself are not simulated (see proposals).

Time-out

Temporary time-out from 24 hours to 6 weeks.

WarningResponsible gaming
Trigger

PlayerChooses a duration and taps pause.

Steps
  1. Confirmation dialog with the end date.
  2. The “Account on time-out” status block appears.
  3. During the time-out the player can't deposit or play, but can withdraw the real balance.
What the player sees
Confirmation dialog

Pause your account for 24 hours?

You won't be able to deposit or play until Nov 13, 2026, 15:00. You can still withdraw your real balance.

CancelPause account
On-screen block · Status

Account on time-out · 24 hours

You won't be able to deposit or play until Nov 13, 2026, 15:00. Withdrawals remain available.

Toast · Global
Time-out activatedUntil Nov 13, 2026, 15:00
How to see itTime-out“Undo (prototype only)” restores the initial state

For integrationTime-out status with an end date that blocks deposits and gameplay across the whole site. In the prototype only the notice is shown (see proposals).

Self-exclusion

Irreversible closure for 6 months to 5 years, with double confirmation.

ErrorResponsible gaming
Trigger

PlayerChooses the duration, types SELF-EXCLUDE, ticks the checkbox and confirms.

Steps
  1. The player must type the exact word and tick the box confirming they understand.
  2. Danger confirmation dialog with the end date.
  3. The account is closed until the end date and the real balance is sent to the player's bank account.
What the player sees
Field error · Confirmation word
Type SELF-EXCLUDE in capitals, exactly as shown.
Toast · Box not ticked
Confirm that you understandTick the box before continuing.
Confirmation dialog

Self-exclude for 6 months

Your account will be closed until May 12, 2027. We won't be able to reopen it sooner, even if you ask.

CancelYes, self-exclude me
On-screen block · Status

Self-exclusion active · 6 months

Your account is closed until May 12, 2027. We'll send your real balance to Bancolombia ···· 4821 within the next 24 hours.

Toast · Global
Self-exclusion activatedUntil May 12, 2027
How to see itSelf-exclusionWord SELF-EXCLUDE

For integrationIrreversible closure until the end date, payout of the real balance, opt-out from marketing communications and registration in the regulator's self-exclusion system where applicable. In the prototype the account stays active (see proposals).

System

Logout, page not found, maintenance and global messages that appear on any screen.

Logout

The site returns to the logged-out view.

InfoUser menu · Global
Trigger

PlayerTaps “Log out” in the user menu or the sidebar.

Steps
  1. Open modals and menus close.
  2. Header, pill and sidebar switch to the logged-out view; account pages show the access block.
  3. An open real-money game stops and returns to the landing screen.
  4. Favorites are kept on the device.
What the player sees
Toast · Global
Logged outCome back soon. Your favorites are saved.
How to see itWallet, logged inUser menu → “Log out”

For integrationInvalidate the token server-side (and the game provider's token). Inactivity expiry isn't simulated (see proposals).

Page not found

Nonexistent route or old link.

Warning404
Trigger

SystemThe server can't find the requested route.

Steps
  1. The 404 page is shown with the full shell.
  2. Offers going back home, searching for a game, sports, quick links and a row of popular games.
What the player sees
Screen · 404

This table has closed

The page you're looking for doesn't exist or has moved. Check the link or head back to the lobby: over 5,000 games are waiting for you.

Back to homeSearch for a game
How to see it404 page

For integrationRespond with a real HTTP 404 status and redirect (301) the prototype's old routes to the new ones.

Scheduled maintenance

Screen without navigation, with countdown and progress.

WarningMaintenance
Trigger

SystemThe operator turns on maintenance mode.

Steps
  1. The screen with a countdown and the progress of each task is shown.
  2. “Retry” warns if it isn't finished yet; the support email can be copied.
  3. Live betting is suspended; open bets are settled as normal.
What the player sees
Screen · Maintenance
Scheduled maintenance

We'll be back in a few minutes

We're upgrading our payment systems to make your withdrawals even faster. Your funds and open bets are safe.

Live betting temporarily suspended · Open bets will be settled as normal

Toast · Retry
We're still working on itPlease try again in a few minutes.
How to see itMaintenance

For integrationMaintenance switch with an estimated end time and task status; respond 503 with Retry-After and redirect all routes to this screen while it lasts.

Global messages: copy, support and loading

Notices that repeat across many screens.

InfoGlobal
Trigger

PlayerCopies a value, asks for support or starts an action that takes time.

Steps
  1. Copy buttons (address, CLABE, reference, PIX code, bet slip): toast with the copied text, truncated to 42 characters.
  2. Live support (sidebar, payment declined, history) and help center chat.
  3. Loading buttons: spinner and their own text, “Processing…” by default.
What the player sees
Toast · Copy
Copied to clipboardBV28074179
Toast · Support
Live supportAn agent will reply in under 1 minute.
Live chatConnecting you to an agent… estimated wait: 45 s

For integrationConnect “Live support” and “Live chat” to the real chat provider with the player's context (and the transaction's, from the history).

Recommended states not yet simulated

Proposal: situations a real casino needs that the prototype doesn't show yet. The copy is a suggestion to validate with product and legal, not existing messages.

Proposal

Create the new password from the link

After “Reset password” there's no screen for the link.

ProposalAccount

Screen with new password and confirmation, plus two states: expired or already used link (“This link is no longer valid. Request a new one.”) and success with automatic login.

For integrationToken validation (expired, used, invalid) and closing all other sessions when it's changed.

Second factor at login

2FA is enabled in Security, but the login doesn't ask for it.

ProposalAccount

Extra step in the login modal: “Enter the code from your authenticator app”, with the option to use a backup code and an error for an incorrect or expired code.

For integrationA “2FA required” login response with a temporary token and a code verification endpoint.

Unconfirmed email

Sign-up sends a confirmation email, but there's no pending state.

ProposalAccount

Persistent notice in the account (“Confirm your email to protect your account”) with resend, plus a confirmed or expired link screen.

For integrationEmail confirmation status in the profile and a rate-limited resend endpoint.

Session expired due to inactivity

Today the session only ends when the player logs out manually.

ProposalSystem

Login modal with the notice “Your session expired for security reasons. Log in again to continue.”, which returns the player to the same screen after logging in.

For integrationA 401 response for an expired token that differs from the 401 for no session, and silent token renewal while there's activity.

Pending deposit that is confirmed, fails or expires

Transfers and cash payments stay “pending” in the prototype.

ProposalDeposit

Toast and notification when a transfer or payment slip is credited (“Deposit confirmed”), an unpaid expired slip and a declined or returned bank payment, also visible in the history and in the transaction status.

For integrationProcessor webhooks with the final status and a real-time channel (WebSocket or push) to notify the player even if they've closed the wallet.

Deposit limit in the wallet

Responsible gaming limits aren't checked on deposit.

ProposalWallet · Responsible gaming

Check the amount against the daily, weekly or monthly limit, converted to the deposit currency, with the error on the field (“This exceeds your daily limit of $500 (you've already deposited $100). You can change it in Responsible gaming.”) and the remaining limit next to the amount.

For integrationA single server-side limit validation, in USD, for all currencies and methods. Crypto deposits reach the address without going through the form: decide whether to hold or return them when they exceed the limit.

Withdrawal under review, paid or rejected

Once requested, the withdrawal stays “Pending”.

ProposalWithdrawal

Notifications and the statuses “Under security review”, “Paid” (for crypto, with the hash and a link to the explorer) and “Rejected”, with the reason and the amount returned to the balance (“Your withdrawal was rejected: the destination account isn't in your name. We returned $300.00 to your balance.”).

For integrationWithdrawal state machine, normalized rejection reasons and an event for every change.

Bet rejected or market suspended at placement

Every valid bet is accepted in the prototype.

ProposalSports

Bet slip alerts for a suspended market (“Market suspended. Remove the selection or wait for it to reopen.”), a stake above the maximum showing the maximum allowed amount, and a bet pending operator approval.

For integrationPlacement rejection codes (suspended, maximum exceeded, odds changed, player limit) with the data for each message.

Bonus completed or expired

The rollover progresses, but there's no final state.

ProposalBonuses

Toast and notification when the requirement is met (“Wagering complete: $150.00 moves to your real balance.”) and when the bonus expires, moving it to the history.

For integrationEvents for bonus conversion to real balance and for expiry, with the amounts.

Limits, time-out and self-exclusion enforced site-wide

Today the notices are only shown on the responsible gaming page.

ProposalResponsible gaming

Modal when the session limit is reached, with a warning 5 minutes before; reality check with time played and result; deposits and play blocked during the time-out; and login blocked for self-excluded accounts, showing the end date.

For integrationResponsible gaming status included in the session and checked on every deposit, game launch and bet.

Restricted country, offline or provider down

There are no network or geolocation error screens.

ProposalSystem · Game

Country-unavailable screen, connection lost and restored toasts, and a “This game isn't available right now” state on the game's landing screen with alternatives.

For integrationIP geolocation at the edge, health status for each game provider and generic API error codes.

Context-specific login message

“Claim” in missions shows the generic real-money toast.

ProposalAccess · Club

Use one message per action, for example “Log in to claim your reward”, as tournaments and mini games already do.

For integrationFront end only: one message per protected button instead of the shared data-need-auth toast.

ProposalMulti-currency wallet

Notices in “Recent deposits” and by notification for an amount below the minimum (“We received 4 USDT, below the 10 USDT minimum. Contact support.”), an unsupported network or an XRP deposit without a tag, with a hand-off to support.

For integrationNetwork monitoring that detects insufficient amounts and deposits without a tag, with a manual review queue.

Exchange rate that changes during a transaction

The prototype's exchange rates are fixed.

ProposalMulti-currency wallet

When buying crypto, withdrawing or viewing converted amounts, warn if the rate has changed (“The exchange rate has changed. Check what you'll receive before confirming.”) and show the time of the last update.

For integrationRates service with timestamps, per-transaction variation tolerance and a rate lock for a few seconds on confirmation.