Skip to content
0:00

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 cashier or page 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, country, KYC status and reset demo data.
?market=BR?market=GBChanges the site's country (17 markets): currency, payments, documents, regulator and gaming rules. Also available in Site countries, which works on mobile.
?demo=0Hides the layers panel for screenshots or demos.
Preset linksThey set up the demo data (KYC status, balance or V1 Coins) before opening the screen.

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, a password of at least 8 characters with a strength meter, and the site's country (currency and document are fixed).
  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 the site's country, personal details and chosen bonus; a confirmation email and an SMS to verify the phone. The new account starts with KYC "Unverified", which blocks withdrawals until verified.

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, cashier, 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. Cashier: the login opens instead of the cashier.
  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 · Cashier, logged out
Log inYou need an account to use the cashier.
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 · Cashier · Menu
What changes on each screen
StatusUser menuVerification pageWithdraw pageCashier · 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 their real balance 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
You have $2,847.50 in real balance. 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.

Deposit

Two entry points: the cashier (#deposit modal, from any screen) and the Deposit page. They share the results, but in the prototype they have different methods, limits and bonuses. The methods, minimum and maximum amounts, taxes and bonus depend on the site's country (see Markets and countries).

Deposit from the cashier

Two steps inside the modal: method and amount, then the method details.

SuccessCashier
Trigger

PlayerTaps “Deposit” in the header, user menu, game, bet slip or after signing up.

Steps
  1. Step 1: chooses method and amount (shortcuts from $10 to $2,500), turns the bonus on or off and sees the “Total to play” summary.
  2. “Continue” shows “Preparing payment…” and opens step 2 with the method screen.
  3. Confirms the payment: loading overlay with the method's own status.
  4. Result: confirmed, declined or pending. A confirmed deposit adds to the real balance and the bonus to the bonus balance.
What the player sees
On-screen block · Bonus toggle, on and off
200% welcome bonus+$100.00 in bonus balance
200% welcome bonusBonus turned off for this deposit
Toast · Cashier coupon (any text)
Coupon applied+10% extra on this deposit
Loading overlay · By method

Processing payment…

Confirming with your bank (3-D Secure).

How to see itOpen the cashier

For integrationAvailable methods per country with minimum, maximum and processing time; server-side bonus calculation (the cashier simulates 200% up to $1,500); and a single payment response with status, reference and new balance.

Amount out of limits

Minimum, maximum per transaction or responsible gaming daily limit.

ErrorCashier · Deposit page
Trigger

PlayerTaps continue or deposit with an amount outside the limits.

Steps
  1. The amount is validated before calling the payment.
  2. Cashier and page: the country's minimum and maximum (see the table); the maximum drops to whatever remains of the LUGAS monthly limit in Germany.
  3. Also, the daily deposit limit the player has set in Responsible gaming.
  4. The amount field shows the error and the flow doesn't proceed.
What the player sees
Field error · Amount in the cashier
The minimum deposit is $10.The maximum per transaction is $10.000. Split your deposit or contact VIP support.
Field error · Amount on the Deposit page
The minimum deposit with International transfer is $100.The maximum per transaction with Apple Pay is $5.000.This exceeds your daily limit of $500 (you've already deposited $100). You can change it in Responsible gaming.
Limits by country (local currency)
CountryCurrencyDeposit (min. – max.)Withdrawal (min. – max.)Amount shortcuts
BrazilBRL10 – 50,00020 – 50,00020 · 50 · 100 · 200 · 500 · 1,000
ArgentinaARS1,000 – 5,000,0005,000 – 5,000,0005,000 · 10,000 · 20,000 · 50,000 · 100,000 · 250,000
ChileCLP5,000 – 5,000,00010,000 – 5,000,0005,000 · 10,000 · 20,000 · 50,000 · 100,000 · 200,000
ColombiaCOP20,000 – 40,000,00040,000 – 40,000,00020,000 · 50,000 · 100,000 · 200,000 · 500,000 · 1,000,000
MexicoMXN100 – 200,000200 – 200,000100 · 200 · 500 · 1,000 · 2,000 · 5,000
PeruPEN10 – 40,00020 – 40,00020 · 50 · 100 · 200 · 500 · 1,000
United States (New Jersey)USD10 – 10,00020 – 25,00020 · 50 · 100 · 200 · 500 · 1,000
Canada (Ontario)CAD10 – 10,00020 – 25,00020 · 50 · 100 · 200 · 500 · 1,000
United KingdomGBP10 – 5,00010 – 25,00010 · 20 · 50 · 100 · 250 · 500
SpainEUR10 – 3,00010 – 30,00010 · 20 · 50 · 100 · 200 · 500
PortugalEUR10 – 5,00010 – 30,00010 · 20 · 50 · 100 · 200 · 500
GermanyEUR10 – 1,00010 – 30,00010 · 20 · 50 · 100 · 200 · 500
NigeriaNGN100 – 5,000,0001,000 – 5,000,0001,000 · 2,000 · 5,000 · 10,000 · 20,000 · 50,000
KenyaKES10 – 300,00050 – 300,000100 · 200 · 500 · 1,000 · 2,000 · 5,000
South AfricaZAR10 – 100,00050 – 100,00050 · 100 · 200 · 500 · 1,000 · 2,000
GhanaGHS1 – 50,00010 – 50,00010 · 20 · 50 · 100 · 200 · 500
PhilippinesPHP100 – 500,000500 – 500,000200 · 500 · 1,000 · 2,000 · 5,000 · 10,000
How to see itCashierAmounts 5 or 20000Deposit pageAmount 450

For integrationLimits per method, per transaction and per period (including the player's responsible gaming limits) with the amount already used to build the message. The cashier doesn't currently check the daily limit (see proposals).

Saved or new card

Card payment and instant confirmation.

SuccessCashier · Deposit page
Trigger

PlayerChooses Card (or Visa / Mastercard on the page) and pays.

Steps
  1. Chooses a saved card (···· 4242 or ···· 5100) or “New card”.
  2. With a new card, they fill in number, cardholder, expiry date and CVV with a card preview.
  3. Taps “Pay $50.00”: loading overlay while it confirms with the bank.
  4. Balance credited instantly, confirmation screen and toast.
What the player sees
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.
Result screen · Cashier

Deposit confirmed!

$50.00 is now in your balance. Your new balance is $2,897.50.

Start playingClose
Deposit confirmed$50.00 added to your balance
Result screen · Deposit page, with new balance, method and reference

Deposit complete!

$100.00 is now in your real balance and $50.00 in bonus balance.

Deposit complete$100.00 added to your balance

For integrationCard tokenization (never store the full number), 3-D Secure with challenge or redirect, and a response with status, reference (DP-…), masked method and new balance.

Payment declined

The bank or processor doesn't authorize the payment. The balance doesn't move.

ErrorCashier · Deposit page
Trigger

SystemThe processor responds with a decline after the payment is confirmed.

Steps
  1. The method's loading overlay.
  2. The decline screen replaces the form, showing the reason.
  3. “Try another method” goes back to step 1; “Contact support” opens the chat.
What the player sees
Result screen · Cashier

Payment declined

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

Try another methodContact support
Result screen · Deposit page, reason depending on the case

Payment declined

Your bank declined the transaction (code 05 · not authorized). You haven't been charged.

The card ending in 0002 was declined for insufficient funds (code 51). You haven't been charged.

Try another method, check your card limits or contact your bank to authorize online payments.
Toast · Deposit page
Payment declinedYou haven't been charged.
Toast · Contact support
Live supportAn agent will reply in under 1 minute.
How to see itCashierAmount 666New card 4000 0000 0000 0002Page · declined

For integrationProcessor decline code (05 not authorized, 51 insufficient funds…) translated into a message for the player. In the cashier, the test amount (666 in local currency, or 6,660… if the minimum is higher) declines card, wallets, Pix and the other instant methods; transfers and cash payments always stay pending.

Apple Pay, Google Pay and e-wallets

Device payment sheet or redirect to PayPal, Skrill or Mercado Pago, depending on the country.

SuccessCashier · Deposit page
Trigger

PlayerChooses a wallet and confirms.

Steps
  1. Apple Pay and Google Pay show the payment sheet with the card and total.
  2. E-wallets ask for the account email and warn about the redirect.
  3. Loading overlay while authorizing or returning from the wallet.
  4. It's credited as a confirmed deposit.
What the player sees
Loading overlay · Apple Pay or Google Pay

Waiting for authorization…

Confirm the payment on your device.

Alert · E-wallet
We'll take you to Skrill to authorize the payment, and you'll return here automatically.
Field error · Wallet email
Enter a valid email.
Loading overlay · Redirect

Redirecting to Skrill…

Authorize the payment and you'll be brought back automatically.

How to see itCashierDeposit page

For integrationApple Pay and Google Pay through the processor (device token). Wallets: redirect and return URLs with the status; if the player doesn't come back, the payment must remain pending or be cancelled.

Deposit bonus and coupons

The bonus is calculated on the amount and credited to the bonus balance.

SuccessErrorCashier · Deposit page
Trigger

PlayerTurns the bonus on or off, or applies a coupon before paying.

Steps
  1. The bonus toggle is on by default and adds the bonus to the summary.
  2. Cashier: 200% up to $1.500. Deposit page: 50% up to $300.
  3. Page: the BETV1DEP coupon adds an extra 10% and the field turns green.
  4. On confirmation, the deposit goes to the real balance and the bonus to the bonus balance.
What the player sees
Field error · Coupon on the Deposit page
Enter a coupon to apply it.Coupon “HOLA” doesn't exist or has already been used.
Summary · Deposit page with $100 and bonus
Deposit
$100.00
Bonus
$50.00
Fee
$0.00
How to see itDeposit pageValid coupon BETV1DEP

For integrationEligible bonuses per deposit with their rules (percentage, cap, rollover) and server-side coupon validation. Today the cashier and the page calculate different bonuses on the front end: the backend must be the single source of truth.

Withdrawal

Withdrawal from the cashier (#withdraw modal) and from the Withdraw page. Only real balance can be withdrawn, and only with a verified identity. The links open the single-currency wallet; in multi-currency, withdrawals go per currency (see Crypto withdrawal and Local currency withdrawal).

Withdrawal blocked by verification

Any KYC status other than “Verified” blocks withdrawals.

WarningCashier · Withdraw page
Trigger

SystemThe player opens Withdraw without a verified identity.

Steps
  1. Cashier: alert above the form and the “Request withdrawal” button disabled.
  2. Page: the form is replaced by a card with the status and a link to Verification.
  3. They can keep depositing and playing in the meantime.
What the player sees
Alert · Cashier · Withdraw
Verify your identity to withdrawFor security, we need your ID document before your first withdrawal. It takes about 5 minutes.
Verify
On-screen block · Withdraw page, unverified or rejected

Verify your identity to withdraw

The law requires us to confirm the account is yours before your first withdrawal. You only need your ID document and a selfie; it takes about 5 minutes.

In the meantime, you can keep depositing and playing.

On-screen block · Withdraw page, under review

Your verification is under review

We received your documents on Nov 12 at 10:42. We'll enable withdrawals as soon as our team approves them, usually in under 24 hours.

For integrationThe server must also reject withdrawals without approved KYC and return the reason. If the form is submitted anyway, the page shows the “Verification required” toast.

Invalid withdrawal amount

Below the minimum, above the real balance or above the daily maximum.

ErrorCashier · Withdraw page
Trigger

PlayerTaps “Request withdrawal” with an amount that isn't allowed.

Steps
  1. Enters the amount or taps “Max”, which fills in the whole real balance.
  2. It's validated against the minimum, the real balance and the daily maximum.
  3. The field shows the error and the order isn't sent.
What the player sees
Field error · Amount
The minimum withdrawal is $20.The amount exceeds your available balance ($2,847.50).The daily maximum is $10.000. Upgrade to verification level 3 to withdraw more.
How to see itCashier · WithdrawAmounts 10 or 5000Withdraw page

For integrationMinimum, daily maximum per KYC level and withdrawable balance (real balance only, excluding bonus and amounts in pending withdrawals). The daily maximum is only validated on the page.

Withdrawal requested

The order is created, the real balance is debited and the withdrawal is pending.

SuccessCashier · Withdraw page · History
Trigger

PlayerRequests a valid withdrawal with a verified identity.

Steps
  1. Choose the country's destination (for example Pix, SPEI, SEPA, M-Pesa or PayPal) and enter the account details.
  2. Loading overlay while the order is sent; on the page, the button shows “Requesting withdrawal…”.
  3. The real balance is debited instantly.
  4. The withdrawal appears as pending in “Withdrawals in progress” and in the history.
What the player sees
Loading overlay · Cashier

Processing withdrawal…

We're sending the order to your bank.

Result screen · Cashier

Withdrawal requested

$300.00 will reach your account in about 15 minutes. You can track the status in your history.

View historyDone
Withdrawal requested$300.00 · arrives in about 15 minutes
Toast · Withdraw page
Withdrawal requested$300.00 to Bancolombia ···· 4821 · arrives in about 15 minutes
Status tags · Withdrawals in progress and history
PendingProcessingCompletedRejected

For integrationWithdrawal order with reference (WD-…), status (pending, processing, completed, rejected) and rejection reason; the amount is held on request and a notification is sent on every status change. Changes after “Pending” aren't simulated live (see proposals).

Cancel a pending withdrawal

The amount returns to the real balance instantly.

InfoWithdraw page
Trigger

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

Steps
  1. Confirmation dialog with the amount.
  2. The withdrawal disappears from the list and the real balance is restored.
  3. If no withdrawals remain, the empty state is shown.
What the player sees
Confirmation dialog

Cancel this withdrawal?

$300.00 will go straight back to your real balance.

CancelCancel withdrawal
Toast · Global
Withdrawal canceled$300.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 integrationOnly cancellable until the payment has been sent to the bank: the server decides and returns the updated balance.

Add a bank account

The new account is pending validation via a micro-deposit.

SuccessWithdraw page
Trigger

PlayerTaps “Add account”, picks bank, type and number, and saves.

Steps
  1. Fields are validated; the button shows “Saving…”.
  2. The account appears selected with the “New” tag and pending validation.
What the player sees
Toast · Global
Account addedBancolombia ···· 1234 · we'll verify it with a $0.01 deposit
Help · Cashier · Destination account

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

How to see itWithdraw page

For integrationOwnership validation (a $0.01 micro-deposit or banking service) before allowing withdrawals to that account.

Markets and countries

The prototype is a single-country, single-currency site (17 markets). Each country changes the payment methods, documents, regulator, responsible gaming, taxes and gaming rules. This explains what the backend must provide by payment type and by country.

Change country

Each site is for a single country and a single currency; the selector changes currency, payments, documents, regulator, rules and language.

InfoPrototype panel · Site countries · ?market=XX
Trigger

PrototypeA country is chosen in the prototype panel (desktop), on the Site countries page (also on mobile) or with ?market=XX in the URL.

Steps
  1. The country is saved in the browser and the language switches to that market's.
  2. The same page reloads with the country's currency, payment methods, regulator, footer seals and rules.
  3. Each country has its own demo player, with her balance, transactions and limits stored separately.
  4. A notice confirms the change and reminds you that this is a design prototype.
What the player sees
Toast · After the change
Country changedYou are now viewing the Kenya site: KES, M-Pesa and GRA.
How to see itSite countriesBrazilUnited KingdomKenyaParameter ?market=XX with BR, AR, CL, CO, MX, PE, US, CA, GB, ES, PT, DE, NG, KE, ZA, GH or PH

For integrationIn production the country comes from the site's domain or license (betv1.com.br, betv1.co.uk…), not from a selector, and does not change during the session. The backend defines per market: currency, payment providers, accepted documents, regulator, legal texts, limits and bonus rules. There is a single currency per player, with no conversion or balances in other currencies.

Deposit by card or debit

Card form with 3-D Secure; the payment is confirmed instantly or declined without moving the balance.

SuccessCashier · Deposit page
Trigger

PlayerChoose Card (or Debit card where credit cards are banned), enter the amount and the card details.

Steps
  1. Amount within the limits of the country and payment method.
  2. Number, expiry date, CVV and cardholder name with field validation.
  3. Loading layer: "Processing payment…" and 3-D Secure with the bank.
  4. “Deposit confirmed” result; the balance goes up instantly.
  5. Test amount or test card: “Payment declined” and the balance does not change.
What the player sees
Loading overlay · Cashier

Processing payment…

Your bank may ask you to confirm the payment with 3-D Secure.

Result screen · Cashier

Deposit confirmed!

The funds are already in your balance.

Result screen · Cashier

Payment declined

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

How to see itMexico · cardUnited Kingdom · debitSpain · debitTest amount: 666 in local currency (or 6,660, 66,600… if the country's minimum is higher) or card 4000 0000 0000 0002 = declined

For integrationCharge through the country's processor (3-D Secure mandatory in GB, ES, PT, DE and recommended elsewhere). Translate the decline code (05 not authorized, 51 insufficient funds…) into a message for the player. Only cards in the account holder's name. The test amount changes by country because the minimum deposit differs: the cashier shows it under the amount field.

Credit card blocked

In Brazil, the United Kingdom, Spain and Germany only debit cards are accepted.

ErrorCashier · Deposit page
Trigger

PlayerEnters a credit card in a market where it is prohibited.

Steps
  1. The method is called "Debit card" and the form warns about the restriction.
  2. The card type is detected from the BIN once the number is typed.
  3. The pay button is disabled and the field shows the error.
What the player sees
Alert · Card form
Only debit cards in your name are accepted: credit cards are prohibited by regulation.
Field error · Card number
This is a credit card: in the United Kingdom only debit cards are accepted.
How to see itUnited KingdomBrazilSpainGermanyTest credit card 5555 5555 5555 4444 (Mastercard credit): blocked only in those four markets

For integrationCheck the card type (debit, credit, prepaid) with the processor before charging and decline credit cards; the UKGC has banned them since April 2020, and so do DGOJ, the GlüStV and Brazil's SPA/MF. Record the reason for the decline for support.

Pix and other QR payments

QR and “copia e cola” code that expire after 10 minutes; the bank confirms and the balance is credited.

PendingCashier · Deposit page
Trigger

PlayerChoose Pix (BR), CoDi (MX), Yape or Plin (PE) or SnapScan (ZA) and enter the amount.

Steps
  1. The backend creates a charge and returns a QR code, a copy-and-paste code and an expiry date.
  2. The player opens their bank app, scans or pastes the code and confirms.
  3. The PSP notifies via callback (webhook) and the balance is credited.
  4. After 10 minutes the code expires and you need to generate a new one.
What the player sees
Alert · Pix · Brazil
The payment must come from an account with your CPF: if it doesn't match, we'll refund it.
Result screen · Cashier

Waiting for your payment

Scan the QR code or paste the Pix copy-and-paste code.

Alert · Expired code
For security, each payment code is valid for 10 minutes. Generate a new one to continue.
How to see itBrazil · PixMexico · CoDiPeru · YapeSouth Africa · SnapScanAmount 666 in local currency = declined

For integrationPSP with Pix (or CoDi/Yape/SnapScan): create the charge with the holder's CPF, store the txid, receive the payment callback and reconcile by exact amount. If the payer does not match the account's CPF, refund the payment. Make the webhook idempotent and set the status to "expired" after 10 minutes.

Bank transfer

Operator details for the transfer (SPEI, CVU/CBU, EFT, PesaLink, Nigeria virtual account); the deposit stays pending until the bank confirms.

PendingCashier · Deposit page
Trigger

PlayerChoose Transfer, see the beneficiary details and press "I've made the transfer".

Steps
  1. Bank, account or CLABE, beneficiary and a unique reference are shown, with a copy button.
  2. The player transfers from an account in their name and includes the reference.
  3. Loading layer: "Verifying the transfer…".
  4. Pending screen with the method's deadline; the balance arrives when the bank confirms.
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 · Cashier

Awaiting confirmation

We'll credit the amount as soon as we receive the transfer. We'll let you know with a notification.

For integrationA virtual account or unique reference per player (dynamic CLABE in Mexico, virtual NUBAN account in Nigeria) for automatic reconciliation. Timing: SPEI and CVU immediate, PesaLink 1 h, South African EFT 24 h, SEPA 1 business day. Notify on credit and mark as failed if the bank returns the transfer.

Cash payment with slip

Slip with a reference and barcode to pay at a store or bank (OXXO, Rapipago, Pago Fácil, Efecty, PagoEfectivo, Multibanco, PayNearMe).

PendingCashier · Deposit page
Trigger

PlayerChoose a cash method and press "I have my payment slip".

Steps
  1. Loading layer: "Registering your slip…" while the payment order is generated.
  2. Slip with a reference or CIP code, barcode, amount and due date.
  3. The player pays at the counter; the collection network notifies the PSP.
  4. The balance is credited in under 1 h (30 min with PayNearMe); if the slip expires, you need to generate another.
What the player sees
Loading overlay · Cashier

Registering your slip…

We're registering the payment order.

Alert · Payment slip
Go to any OXXO store and say you want to make an OXXO Pay payment.
Result screen · Cashier

Waiting for your payment

Pay the amount with your slip before the due date. We'll credit it to your balance and let you know with a notification.

How to see itMexico · OXXOArgentina · RapipagoColombia · EfectyPortugal · MultibancoBrazil does not support boleto or cash: the method does not appear

For integrationGenerate the payment order with the aggregator (Multibanco entity and reference, PagoEfectivo CIP, Efecty agreement…), with an expiry date and the exact amount; confirm via callback and record the deposit as "pending" until then. Cash deposits get no bonus until credited.

External gateway (redirect)

PSE, Webpay, Khipu, Interac, Trustly, Klarna, Pay by Bank, PayPal, Skrill, Ozow and similar: the player authorizes on the bank's page or app.

InfoCashier · Deposit page
Trigger

PlayerChoose the method and press "Continue to {método}".

Steps
  1. If the method requires it, the player chooses their bank before leaving.
  2. Loading layer: "Redirecting to {método}…" and exit to the bank's page.
  3. The player authorizes and returns to the site with a status in the return URL.
  4. Result depending on the status: confirmed, pending, cancelled or declined.
  5. If the player doesn't return, the deposit stays pending until the callback.
What the player sees
Alert · Before leaving
You enter your payment details on the PSE page. BetV1 doesn't see or store them.
Loading overlay · Cashier

Taking you to PSE

Authorize the payment and you'll be brought back automatically.

For integrationReturn URL per method with the status and a server-to-server callback URL (the return URL is not reliable). In open banking (Trustly, Pay by Bank, Klarna) the bank account holder's name must match the account's; if it doesn't match, refund the payment.

Approval on mobile (push)

M-Pesa, Airtel Money, MB WAY, Bizum, Nequi, Daviplata, OPay, PalmPay, PayShap, DEBIN, MACH and Wero: the player approves the payment in their app.

PendingCashier · Deposit page
Trigger

PlayerChoose the method, confirm the account's phone number and press "Send request".

Steps
  1. The phone must be registered in the player's name; it is declared at sign-up.
  2. The backend sends the request (STK push, app notification) and the screen waits.
  3. The player enters their PIN or uses their fingerprint on the phone.
  4. The callback confirms and the balance goes up instantly; with no response, the payment expires.
What the player sees
Result screen · Cashier · M-Pesa

Waiting for your approval…

You'll receive a payment request on your phone to confirm with your PIN.

Alert · Kenya
Prefer to pay via Paybill? Use the Paybill and account number shown.
Field error · Phone
Enter a valid phone number.
How to see itKenya · M-PesaPortugal · MB WAYSpain · BizumNigeria · OPayColombia · NequiAmount 666 = declined; in Kenya the 5% excise tax on the deposit is also shown

For integrationRequest to the mobile operator (Daraja STK push in Kenya, SIBS in Portugal, Bizum from Spanish banks…) and a result callback with a maximum time. Verify that the number belongs to the holder (M-Pesa in the player's name). In Kenya, the cashier shows the special tax breakdown (see “Taxes on deposits and withdrawals”).

USSD in Nigeria

The player dials a code on their phone, without internet, with the bank of their choice.

PendingCashier · Deposit page
Trigger

PlayerIn Nigeria, choose USSD, the amount and your bank.

Steps
  1. The screen shows the bank code with the amount and reference already filled in (for example *737*50*{monto}*{ref}# in GTBank).
  2. The player dials it from the phone registered with their bank and chooses the source account.
  3. Tap “I dialed the code”: loading layer and pending screen.
  4. The bank confirms and the balance is credited.
What the player sees
Alert · USSD
Dial this code from the phone registered with your bank, then come back here and tap “I dialed the code”.
Loading overlay · Cashier

Verifying the payment…

This usually takes a few seconds.

How to see itNigeria · USSDSample banks: GTBank, Access Bank, Zenith Bank, First Bank and UBA

For integrationAn aggregator (Paystack, Flutterwave…) that generates the USSD code per bank with a transaction reference and notifies via webhook. Each bank uses a different code; the list of banks and templates must come from configuration.

Prepaid voucher with PIN

paysafecard (16 digits), 1Voucher (16 digits) and OTT Voucher (12 digits): you pay with the voucher code.

SuccessCashier · Deposit page
Trigger

PlayerChoose the voucher, enter the code and the amount.

Steps
  1. The field validates the length of the voucher code.
  2. Loading layer: "Checking the voucher balance."
  3. If the voucher is worth more than the deposit, the rest stays on the voucher for next time.
  4. Invalid or already used voucher: error in the field.
What the player sees
Field error · Voucher code
The voucher is invalid or has already been used.
Loading overlay · Cashier

Redeeming the voucher…

Checking the voucher balance.

Alert · Notice
Vouchers can only be used to deposit: to withdraw you need an account in your name.
How to see itSouth Africa · 1VoucherGermany · paysafecardUnited Kingdom · paysafecardInvalid voucher code: any code with the wrong length or 0000…

For integrationRedemption call to the issuer (paysafecard, Blue Label/1Voucher) that returns the value and the remaining balance. Vouchers do not support withdrawals: offer another method in the player's name. In the United Kingdom and Germany they count toward the deposit limit.

Withdrawal to your own account with the country's details

Each country asks for different destination details; the withdrawal always goes to an account or wallet in the verified player's name.

SuccessCashier · Withdraw page
Trigger

PlayerWith your identity verified, choose the country's withdrawal method and enter the destination details.

Steps
  1. Only the country's withdrawal methods appear (shorter than the deposit ones).
  2. The form changes depending on the method: Pix key, CLABE, CVU, CCI, IBAN, sort code, NUBAN, phone…
  3. The format is validated in the field and, when available, the holder's name is resolved with the bank.
  4. The breakdown with taxes is shown and the withdrawal is confirmed.
  5. The request is set to “under review” and is released after the security review; the balance is deducted when it is requested.
What the player sees
Field error · Pix key
The Pix account must be under your CPF; if it doesn't match, the withdrawal is rejected.
Field error · CLABE
The CLABE must have 18 digits.
Field error · NUBAN
Name verified with your BVN.
Result screen · Cashier

Withdrawal requested

We review every withdrawal for security before sending it. We'll let you know when it's sent.

CountryMethodWithdrawal detailsValidation
BrazilPix · TEDPix key (CPF, email, phone or random) · bank, branch and accountThe Pix key must belong to the player's CPF
MexicoSPEI18-digit interbank CLABECLABE check digit
ArgentinaCVU / CBU · Mercado Pago22-digit CVU or CBU, or aliasHolder with the DNI or CUIL
ChileTransfer · MACHBank, account type and number · phoneAccount with the player's RUT
ColombiaBank account · NequiBank and account · mobileAccount in the account holder's name
PeruInterbank transfer · Yape20-digit CCI · mobileThe CCI must have 20 digits
Spain · GermanySEPAIBANIBAN check digits
United KingdomFaster Payments6-digit sort code and 8-digit account numberThe sort code has 6 digits
USACH · check9-digit routing number (ABA) and account · address for the checkThe routing number has 9 digits
CanadaInterac · EFTInterac email · transit, institution and accountEmail or account in the account holder's name
NigeriaTransfer · OPay10-digit NUBAN numberName resolution: “Name verified with your BVN.”
KenyaM-Pesa · PesaLinkM-Pesa phone registered in their nameName of the number's holder
South AfricaEFT · PayShapBank, account and branch code · phoneThe bank account must be in your name
Ghana · PhilippinesMoMo · InstaPayWallet phone · bank accountWallet in the account holder's name
How to see itBrazilMexicoUnited KingdomNigeriaKenyaValid test data for each country: preloaded by the demo account (see Site countries)

For integrationValidate the format of each destination detail (check digit of CLABE and IBAN, length of CCI/NUBAN/sort code) and confirm with the bank or PSP that the holder matches the name and document in the KYC (Pix with the CPF, NUBAN with the BVN). Never pay third parties. Withdrawals go out via the same method as the deposit when the regulator requires it.

Taxes on deposits and withdrawals

In Kenya, the cashier shows the 5% excise tax on deposit and the 5% withholding on withdrawal; in other countries there is only an informational text about winnings.

WarningCashier · Deposit page · Withdraw page
Trigger

PlayerIn Kenya, enter a deposit or withdrawal amount.

Steps
  1. Below the amount you'll see the breakdown: amount, excise tax (5%) and the total that reaches your balance.
  2. On withdrawal, the 5% withholding and the amount the player will receive are shown.
  3. Promotional credits also pay the special tax.
  4. Without taxes on transactions, the breakdown does not appear.
What the player sees
Alert · Deposit · Kenya
Special tax (5%): added to the deposit amount.
Alert · Withdrawal · Kenya
Withholding on withdrawals (5%): deducted from the amount you receive.
Alert · Tax information
20% withholding on winnings (Finance Act 2026).
How to see itDeposit in KenyaWithdrawal in KenyaMexico (no breakdown)Tax text for each country: tax.win on the Site countries card

For integrationCalculate the tax in the backend and return it itemized (base, rate, tax, total) to display it and record it in the history. The percentages and their name come from the market configuration and are reported to the tax authority (KRA in Kenya). Taxed winnings (Colombia, Mexico, US, Brazil) are disclosed to the player, but the operator withholds only where the law requires it.

Germany: LUGAS monthly limit

The maximum combined deposit is €1,000 per month across all German-licensed operators.

WarningCashier · Deposit page
Trigger

PlayerIn Germany, open the deposit cashier or enter an amount higher than what remains for the month.

Steps
  1. The cashier shows a bar with “LUGAS monthly limit” and what is available for the month.
  2. The maximum of the amount field drops to what remains available.
  3. If the amount exceeds it, the field shows the error and you can't continue.
  4. The counter resets on the first day of each month.
What the player sees
Alert · Cashier · Germany
LUGAS monthly limit: 1,000 € available of 1,000 €.
Field error · Amount
The GlüStV limits deposits to €1,000 per month across all licensed operators.
Field error · Amount
You exceed your LUGAS monthly limit: you have 200 € left this month.
How to see itGermany · cashierResponsible gamingConfirmed deposits for the month are counted in this browser

For integrationQuery LUGAS (the federal cross-operator limits system) before each deposit and report the deposited amount; the operator cannot accept more than €1,000 per month per player, and raising your own limit requires a waiting period. OASIS (blocks) is also queried at login and on every deposit.

Mandatory deposit limits at sign-up

Spain, Portugal, Germany and Canada (Ontario) require the player to set their limits before playing.

WarningSign-up · step 3
Trigger

PlayerSigns up from a market with mandatory limits.

Steps
  1. Step 3 adds the "Your deposit limits" block with three fields: daily, weekly and monthly.
  2. The suggested values come from the regulator (in Spain 600 / 1,500 / 3,000, in Portugal 250 / 750 / 2,000).
  3. In Germany the only required field is the monthly one, with a cap of €1.000.
  4. Without at least one valid limit, sign-up does not advance.
  5. In all other countries limits are offered but not mandatory.
What the player sees
Suggested text · Sign-up · step 3
By regulation you must set your deposit limits before playing. Lowering them applies instantly; raising them has a waiting period.
Field error · Monthly limit
Enter a monthly deposit limit.

For integrationStore the limits at sign-up with date and value, apply them on every deposit and enforce the waiting period when raising them. Sign-up must not create the account if the mandatory limits are missing; the regulator may ask for the change history.

Mandatory geolocation

In New Jersey, Ontario and Buenos Aires (CABA) you can only play with the device inside the licensed territory.

WarningFooter · Casino · Sports · Cashier
Trigger

PlayerThe player enters or plays in a market with a geographic restriction.

Steps
  1. The footer and the terms say "Only with geolocation within {territorio}".
  2. Before playing or betting with real money, the browser asks for location permission and the service checks your position.
  3. Outside the territory, real money is blocked and the player can only browse the site.
  4. Deposits and withdrawals remain available as the regulator allows.
What the player sees
Alert · Footer · United States
Only with geolocation inside New Jersey.
Suggested text · Outside the territory
We can't confirm that you are in New Jersey. Turn on location or connect from inside the state to play for real money.
How to see itNew JerseyOntarioBuenos AiresCountry sheet: field geo; there is no simulated block in the prototype

For integrationCertified geolocation provider (GeoComply or another) on the device, checked at login, on every bet or spin and on deposit, with the position logged. Distinguish VPN, proxy and spoofed location.

ID document by country

Sign-up and verification ask for the country's document, with a mask and validation in the field.

ErrorSign-up · My details · Verification
Trigger

PlayerEnter the ID document at sign-up, in My details or in verification.

Steps
  1. The label, placeholder and mask change with the country (for example 000.000.000-00 in Brazil).
  2. When you leave the field, the format and check digit are validated.
  3. An invalid document marks the field with the country's message.
  4. In the United Kingdom, Germany and Canada there is no national ID field in the form: verification is done with documents and external databases.
What the player sees
Field error · CPF · Brazil
Invalid CPF: check the digits.
Field error · ID number · South Africa
Invalid ID number: check the 13 digits.
Field error · BVN · Nigeria
The BVN has 11 digits.
Field error · Ghana Card
The Ghana Card uses the format GHA-000000000-0.
CountryID documentValidationValid example
BrazilCPF11 digits with two check digits529.982.247-25
ChileRUTModulus 11 with check digit (0-9 or K)12.345.678-5
MexicoCURP18 characters with date of birth and stateRAMV900215MDFMRL09
ArgentinaDNI or CUIL8 digits or 11 with check digit30.123.456
SpainDNI / NIE8 digits or X/Y/Z plus control letter12345678Z
PortugalNIF9 digits with check digit250 123 452
South AfricaID number13 digits with Luhn check8001015009087
NigeriaBVN11 digits; the name must match the account22123456789
GhanaGhana CardFormat GHA-000000000-0GHA-123456789-0
KenyaNational ID and KRA PIN7 or 8 digits · format A000000000Z27845612
How to see itBrazil · CPFSouth Africa · IDNigeria · BVNSpain · DNI/NIEInvalid value by country: see “Test values” in Site countries (field idn.bad)

For integrationValidate on the client (format) and on the server (check digit and official lookup: Receita Federal for the CPF, SAT/RENAPO for the CURP, Registro Civil for the RUT, NIBSS for the BVN, Home Affairs for the South African ID, NIA for the Ghana Card). The withdrawal account must match the holder.

National self-exclusion registers

Each market has its own register, which the site checks at login and sign-up.

ErrorSign-up · Log in · Responsible gaming
Trigger

PlayerA self-excluded person tries to sign up, log in or play.

Steps
  1. The Responsible gaming screen shows the country's register with a link to the authority.
  2. The country's register is checked at sign-up and at every login.
  3. If there is an active exclusion, the account can't log in and the reason is explained.
  4. The player can self-exclude on the site with double confirmation; in Germany the panic button blocks for 24 h.
What the player sees
Alert · Responsible gaming
OASIS · Spielersperrsystem: nationwide block across all operators and venues (minimum 3 months); the panic button blocks you for 24 h.
Suggested text · Access attempt
Your account is self-excluded. You can't play until the exclusion period ends.
CountryRegister or systemWhat happens when you self-exclude
United KingdomGAMSTOPBlock on all licensed operators
SpainRGIAJRegistro General de Interdicciones de Acceso al Juego
GermanyOASISNationwide block of at least 3 months; the panic button blocks for 24 h
PortugalSRIJSelf-exclusion on the centralized portal
BrazilPlataforma Centralizada de Autoexclusão (gov.br)Block on all authorized operators
ArgentinaReVANational voluntary register
PeruRegister of banned persons (MINCETUR)Access ban
USNJ DGE Internet Self-Exclusion ListState list
KenyaGRA National Gambling RegisterAn operator that accepts bets from an excluded person is accountable to the GRA
South AfricaNRGP / provincial registerReferral to the NRGP
Chile, Colombia, Mexico, Canada, Nigeria, GhanaSelf-exclusion on BetV1Operator only: there is no national register yet

For integrationIntegrate the country's register API (GAMSTOP, OASIS, RGIAJ…) and check it at sign-up, at every login and before marketing campaigns. Record the player's own exclusion and apply it across the whole site, with no option to cancel it before the end of the period.

Session clock and reality check

Where the regulator requires it, the header shows the session time and a reminder appears at intervals.

InfoHeader · Play
Trigger

PlayerPlaying from Brazil, the United States, Canada, the United Kingdom, Spain, Portugal or Germany.

Steps
  1. The header shows a clock with the current session time (from 768 px).
  2. In Germany the notice appears every 60 minutes; elsewhere, according to the reminder the player chooses.
  3. The notice shows the time played and the session balance and offers to continue or leave.
What the player sees
Suggested text · Session notice
You've been playing for 60 minutes. Take a break if you need one: you can set limits or take a time-out.
How to see itUnited KingdomGermanyMexico (no clock)In countries without a clock, the element is hidden entirely

For integrationThe clock is driven by the backend (login session, not just the browser) and must send the notice with the time played and net winnings or losses. The minimum interval and the text are set by each regulator.

Maximum bet and slot speed (United Kingdom and Germany)

The regulator limits the bet per spin, the minimum speed and autoplay features.

WarningGame · Casino
Trigger

PlayerA slot is opened in the United Kingdom or Germany.

Steps
  1. United Kingdom: maximum bet of £5 per spin (£2 for ages 18 to 24), minimum cycle of 2.5 s, no autoplay or turbo.
  2. Germany: maximum bet of €1 per spin, 5 seconds per spin, no autoplay or jackpots.
  3. Spain: no fast autoplay and with RTP visible.
  4. The notice appears below the game and the bet selector does not exceed the cap.
  5. Jackpots and prohibited features are hidden from the lobby.
What the player sees
Alert · Below the game · United Kingdom
Slots: maximum bet of £5 per spin (£2 for ages 18 to 24), minimum cycle of 2.5 s, no autoplay or turbo.
Alert · Below the game · Germany
Virtual slots: maximum bet of 1 € per spin, minimum 5 seconds per spin, no autoplay or jackpots.

For integrationPass the market parameters to the game provider (maximum bet by age, minimum speed, autoplay disabled) when opening the session and verify the player's age. The age is taken from the verified date of birth.

South Africa: sports betting only

Online casino is illegal in South Africa: the site only offers sports and racing.

WarningNavigation · Casino · Home
Trigger

PlayerAny casino screen is opened in the South African market.

Steps
  1. The menu, home page and search remove casino, live casino, crash, slots and table games.
  2. A market notice explains that online casino is not authorized.
  3. Casino routes redirect to Sports.
  4. Bonuses are for sports betting only.
What the player sees
Alert · South African market
Online casino is illegal in South Africa: this market only offers sports betting and racing.

For integrationDisable all casino products (games, providers, jackpots, casino tournaments) through the market configuration, including in the game launch API, and limit promotions to sports.

Brazil: no welcome bonus

In Brazil the site offers no welcome bonus or initial bonus balance.

InfoSign-up · Promotions · Account
Trigger

PlayerSigns up or opens the account in the Brazilian market.

Steps
  1. Sign-up does not show a welcome promo code or the 200% offer.
  2. The promotional texts on the home page, the header and the welcome page hide the offer.
  3. The account's bonus balance starts at zero.
  4. Recurring promotions that comply with SPA/MF regulation are kept.
What the player sees
Suggested text · Promotions · Brazil
There is no welcome bonus in this market.
How to see itBrazilBonuses in BrazilMexico (with bonus)Country sheet: bonus.welcome = false

For integrationThe market configuration decides whether a welcome bonus exists, its wagering requirement and whether casino and sports can be combined. Hide it in the CMS and in acquisition campaigns, not only in the front end.

Odds format by country

Decimal by default; fractional in the United Kingdom and American in the United States and Canada.

InfoSports · Bet slip · My bets
Trigger

PlayerThe bet slip or an event is opened in the corresponding market.

Steps
  1. United Kingdom: fractional odds (5/2).
  2. United States and Canada: American odds (+150 / -110).
  3. All other countries use decimal odds (2.50).
  4. Potential winnings are always calculated on the underlying odds.
What the player sees
Suggested text · Voucher · United Kingdom
Odds 5/2: for every £2 staked you win £5 plus your stake.

For integrationThe odds feed arrives in decimal format and is converted for display; the format is a display preference and does not change the amount paid.

Test values by country

Amounts, cards and documents that trigger specific states in the cashier and sign-up.

InfoCashier · Sign-up
Trigger

PrototypeError cases are tested in each market.

Steps
  1. Payment declined: amount 666 in local currency (or 6,660, 66,600… if the minimum deposit is higher, for example in Chile and Colombia).
  2. Card 4000 0000 0000 0002: declined by the bank.
  3. Credit card 5555 5555 5555 4444: blocked where only debit is accepted (BR, GB, ES, DE).
  4. Invalid document: see the field idn.bad on each country's card (for example 8001015009088 in South Africa).
  5. Invalid prepaid voucher: a code with the wrong length.
What the player sees
Result screen · Cashier

Payment declined

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

How to see itCountry sheetCashier · BrazilCashier · ChileThe cashier shows that market's test value below the amount field

For integrationPrototype only. In the PSP sandbox, each provider's test cards and amounts are used; this map serves as a guide for QA.

Bonuses and balance

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

Real balance and bonus balance

What moves each balance and what can be withdrawn.

InfoHeader · Menu · Wallet · Cashier
Trigger

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

Prototype rules
  1. The deposit adds to the real balance; the deposit bonus, to the bonus balance.
  2. Real-money games, bets and cash out debit and credit the real balance.
  3. Mini game prizes go to the balance the prize indicates (real, bonus, coins or XP).
  4. Only the real balance is withdrawable; the cashier shows the bonus as not withdrawable.
What the player sees
On-screen block · User menu and cashier
Real balance
$2,847.50
Bonus (non-withdrawable)
$150.00
Available to withdraw
$2,847.50

For integrationBalances endpoint with real, bonus, V1 Coins and amount held in withdrawals, plus an update event to re-render all views at once (on the front end, the elements with data-user).

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. Three-phase loading bar while the iframe loads in the background.
  2. The game opens on the stage; on mobile, in full screen with a balance bar and deposit button.
  3. The bar shows the mode: real money with the account balance, or demo with its own $1.000.
  4. 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: $2,847.50 · Bonus: $150.00

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: error toast and the page opens the cashier on Deposit.
  3. Demo: the demo balance resets to $1,000 automatically.
What the player sees
Toast · Real money, and the cashier opens
Insufficient balanceDeposit to keep playing or lower your bet.
Toast · Demo
Demo balance topped upYou have $1,000.00 again to try the game.
How to see itWith a balance of $0.50Spin with the $1.00 betDirect demo

For integrationThe provider or wallet responds “insufficient funds”; the page listens for that event to open the cashier without closing the game.

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 updates the balance and notifies the page, which re-renders the header, menu and game bar.
  2. Demo: the iframe reports its own balance and only the game bar changes.
  3. If the player deposits in the cashier while playing, the iframe re-reads the balance before 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:user"}Real-money balance changeReloads the user and repaints all balances
{type:"bv:demo", balance}Demo balance changeUpdates the demo balance in the bar
{type:"bv:open", id:"cashier", tab:"deposit"}Insufficient balanceOpens the cashier on Deposit
{type:"bv:toast", title, text, kind}Game noticesShows the toast on the page
{type:"bv:spin", on}Start and end of each real-money spinA change of country or mode waits until 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 header balance

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 $1 or above their real 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 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. The amount is added to the real balance.
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. Deposits respect the limit (see “Amount out of limits”).
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

SPEI, PSE, Pix and cash payments stay “pending” in the prototype.

ProposalDeposit

Toast and notification on credit (“Deposit confirmed”), expired Pix code status (“The code has expired. Generate a new one to continue.”) and rejected or returned bank payment, also visible in the history.

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 cashier.

Daily limit in the cashier too

The Deposit page respects the $500 daily limit; the cashier doesn't.

ProposalDeposit · Responsible gaming

Show the same error in the cashier as on the page (“This exceeds your daily limit…”) and the remaining limit next to the amount.

For integrationA single server-side limit validation for all deposit entry points.

Withdrawal under review, paid or rejected

Once requested, the withdrawal stays “Pending”.

ProposalWithdrawal

Notifications and the statuses “Under security review”, “Paid” 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.