Lo que no se ve a primera vista en las pantallas: qué dispara cada estado, qué pasos sigue la interfaz, qué mensaje exacto ve el jugador y dónde aparece. Cada flujo enlaza a la pantalla real para reproducirlo e indica qué debe aportar el backend.
ToastAviso temporal abajo a la derecha; en móvil, sobre la píldora. Se cierra solo a los 4 s, se puede deslizar y hay como máximo 3 a la vez.
AlertaCaja de color dentro del modal o de la pantalla. Se queda hasta que cambia el estado.
Error en campoMensaje bajo el campo, que se marca en rojo. Se limpia al volver a escribir.
Pantalla de resultadoSustituye al formulario de la caja o de la página con el resultado final.
Diálogo de confirmaciónModal genérico antes de una acción irreversible, con botón principal o de peligro.
Capa de cargaSpinner con título y texto sobre el modal mientras se procesa. El botón muestra su propio texto de carga.
Bloque en pantallaTarjeta, aviso o estado vacío que la página muestra según el estado del jugador.
Para integraciónQué datos, eventos o validaciones debe aportar el backend para que el flujo funcione de verdad.
ÉxitoInformativoAvisoErrorMismo color que el componente real.
Controles del prototipo
?auth=in?auth=outFuerza la sesión iniciada o cerrada en cualquier URL.
#login#register#forgot-password#deposit#withdraw#search#notificationsAbren el modal o el panel correspondiente.
Panel de capasBotón abajo a la derecha: sesión, país, estado KYC y restablecer datos de demo.
?market=BR?market=GBCambia el país del sitio (17 mercados): moneda, pagos, documentos, regulador y reglas de juego. También en Países del sitio, que funciona en móvil.
?demo=0Oculta el panel de capas para capturas o demos.
Enlaces con ajustePreparan los datos de demo (estado KYC, saldo o monedas V1) antes de abrir la pantalla.
Ningún flujo coincide con la búsqueda
Prueba con otra palabra, por ejemplo depósito, KYC, cash out o 666.
Acceso
Inicio de sesión, registro, recuperación de contraseña y acciones que exigen cuenta. Todo ocurre en modales que se abren desde cualquier pantalla.
Para integraciónEndpoint de login que devuelva el token de sesión, el perfil (nombre, ID, nivel VIP), el saldo real y de bono, el estado KYC y los giros gratis pendientes que usa el saludo. La casilla «Mantener la sesión iniciada» define la duración del token.
Tras varios intentos fallidos, la cuenta queda bloqueada unos minutos.
ErrorModal de login
Disparador
SistemaEl backend responde que la cuenta está bloqueada por demasiados intentos.
Pasos
El jugador envía el login.
Capa de carga «Entrando…».
Aparece la alerta de bloqueo y no se inicia sesión.
Lo que ve el jugador
Alerta · Arriba del formulario de login
Cuenta bloqueada temporalmenteDemasiados intentos fallidos. Inténtalo de nuevo en 15 minutos o restablece tu contraseña.
Cómo verloAbrir loginUsuario que contenga bloqueado
Para integraciónCódigo de error de bloqueo con los minutos restantes. El mensaje invita a recuperar la contraseña, que debe seguir disponible durante el bloqueo.
Para integraciónResponder siempre igual, exista o no la cuenta. Token de un solo uso que caduca a los 30 minutos. La pantalla para crear la contraseña nueva no está simulada (ver propuestas).
Alta con correo: acceso, datos personales y confirmación.
ÉxitoModal de registro
Disparador
JugadorPulsa «Crea tu cuenta», «Registrarme» o abre el hash #register.
Pasos
Acceso: correo, contraseña de al menos 8 caracteres con medidor de fuerza y el país del sitio (moneda y documento fijos).
Datos: nombre, apellido, fecha de nacimiento y teléfono móvil.
Confirmar: bono de bienvenida (casino, deportes o sin bono), código promocional y aceptación de términos.
Capa de carga mientras se crea la cuenta.
Cuenta creada con sesión iniciada, saldo $0, verificación pendiente y nivel Bronce 1.
Lo que ve el jugador
Error en campo · Validaciones de cada paso
Introduce un correo válido, por ejemplo nombre@dominio.comLa contraseña debe tener al menos 8 caracteres.Introduce un número de teléfono válido.Debes aceptar los términos para crear tu cuenta.
Capa de carga · Modal de registro
Creando tu cuenta…
Esto tarda solo un momento.
Pantalla de resultado · Modal de registro
¡Cuenta creada!
Te enviamos un correo de confirmación. Haz tu primer depósito para activar el 200% de bienvenida.
Para integraciónAlta con el país del sitio, datos personales y bono elegido; correo de confirmación y SMS para verificar el teléfono. La cuenta nueva nace con KYC «Sin verificar», lo que bloquea el retiro hasta verificar.
Para integraciónOAuth con correo y nombre. Aunque la cuenta venga de una red social, la fecha de nacimiento y el teléfono son obligatorios antes de crearla.
Para integraciónTodo endpoint protegido debe responder 401 para que el front abra el login. Hoy «Reclamar» en misiones reutiliza el toast genérico de dinero real (ver propuestas).
Cuenta y verificación
Estados de verificación de identidad (KYC) y su efecto en cada pantalla, datos personales, teléfono, seguridad, configuración y notificaciones.
Cuatro estados que cambian el menú de usuario, la página de verificación y el retiro.
AvisoVerificación · Retiro · Caja · Menú
Qué cambia en cada pantalla
Estado
Menú de usuario
Página Verificación
Página Retirar
Caja · Retirar
Sin verificar
Pendiente
Verifica tu identidad
Formulario oculto; tarjeta para verificar
Alerta y botón deshabilitado
En revisión
En revisión
Documentos en revisión; envío deshabilitado
Formulario oculto; aviso de revisión
Alerta y botón deshabilitado
Verificada
Verificada
Cuenta verificada · Nivel 2
Formulario de retiro activo
Retiro habilitado
Rechazada
Rechazada
Motivos del rechazo y pasos marcados para corregir
Formulario oculto; tarjeta para verificar
Alerta y botón deshabilitado
Disparador
SistemaEl estado cambia al registrarse (sin verificar), al enviar documentos (en revisión) y cuando cumplimiento aprueba o rechaza.
Pasos
Registro: la cuenta nace sin verificar.
Envío de documentos: pasa a en revisión.
Aprobación: verificada, nivel 2, retiros hasta $10.000 al día.
Rechazo: se muestran los motivos y los pasos que hay que repetir.
Lo que ve el jugador
Bloque en pantalla · Verificación, sin verificar
Verifica tu identidad
Necesitamos tu documento, una selfie y un comprobante de domicilio. Lo revisamos en menos de 24 horas y tus datos se guardan cifrados.
Bloque en pantalla · Verificación, en revisión
Documentos en revisión
Recibimos tus documentos el 12 nov a las 10:42. Te avisaremos por correo y notificación en cuanto terminemos. Tiempo estimado: menos de 24 horas.
Bloque en pantalla · Verificación, verificada
Cuenta verificada · Nivel 2
Verificaste tu identidad el 12 nov 2026. Puedes retirar hasta $10.000 al día. Sube un comprobante de domicilio para pasar al nivel 3 y eliminar los límites.
Bloque en pantalla · Verificación, rechazada
No pudimos verificar tus documentos
Revisamos tu solicitud del 12 nov y encontramos estos problemas:
La foto del reverso del documento está borrosa y no se leen los datos.
La selfie no coincide con la foto del documento por la iluminación.
Toast · Al cambiar el estado desde el panel de capas
Estado KYC: En revisiónSe aplica a retiro y verificación.
Para integraciónEstado KYC (none, pending, ok, rejected), nivel de verificación (1 a 3), fecha de envío, motivos de rechazo por documento y límite de retiro de cada nivel. Webhook del proveedor KYC para actualizar el estado y enviar la notificación «Identidad verificada».
Para integraciónSubida de archivos validada en servidor, sesión de prueba de vida del proveedor KYC y endpoint de envío que devuelva el estado nuevo. Con la cuenta verificada, el nivel 3 pide el comprobante de domicilio: «Sube el comprobante de domicilio para pasar al nivel 3.».
Para integraciónLos mismos límites en servidor (tipos de archivo y 10 MB) y el motivo de rechazo por documento, para mostrarlo en su propia zona de carga.
Para integraciónCambiar la dirección invalida el comprobante de domicilio del nivel 3. El cambio de correo envía un enlace de confirmación y mantiene el correo anterior hasta confirmarlo.
Para integraciónSecreto TOTP, verificación del código y códigos de respaldo de un solo uso. El login todavía no pide el segundo factor (ver propuestas).
Para integraciónLista de sesiones con dispositivo, ubicación y última actividad; revocar una o todas menos la actual. El texto «conectada» usa el género del perfil de demo: conviene una forma neutra o con el género del jugador.
Para integraciónPreferencias sincronizadas entre dispositivos, exportación de datos asíncrona por correo y política de cierre con saldo (bloquear hasta retirar o transferir). En el prototipo, cerrar la cuenta no cierra la sesión.
Para integraciónFeed con tipo, título, texto, fecha y estado leído; contador de no leídas (hoy fijo en 3) y endpoint para marcar como leídas. Eventos mínimos: depósito confirmado, identidad verificada, nuevo inicio de sesión, giros gratis, posición en torneo, misión nueva y subida de nivel.
Depósito
Dos entradas: la caja (modal #deposit, desde cualquier pantalla) y la página Depositar. Comparten los resultados, pero en el prototipo tienen métodos, límites y bonos distintos. Los métodos, los montos mínimos y máximos, los impuestos y el bono dependen del país del sitio (ver Mercados y países).
Para integraciónMétodos disponibles por país con mínimo, máximo y plazo; cálculo del bono en servidor (la caja simula 200% hasta $1.500) y una sola respuesta de pago con estado, referencia y saldo nuevo.
Mínimo, máximo por operación o límite diario de juego responsable.
ErrorCaja · Página Depositar
Disparador
JugadorPulsa continuar o depositar con un monto fuera de los límites.
Pasos
Se valida el monto antes de llamar al pago.
Caja y página: mínimo y máximo del país (ver la tabla); el máximo baja a lo que queda del límite mensual LUGAS en Alemania.
Además, el límite diario de depósito que haya fijado el jugador en Juego responsable.
El campo de monto muestra el error y el flujo no avanza.
Lo que ve el jugador
Error en campo · Monto en la caja
El depósito mínimo es de $10.El máximo por operación es de $10.000. Divide el depósito o contacta con soporte VIP.
Error en campo · Monto en la página Depositar
El depósito mínimo con Transferencia internacional es de $100.El máximo por operación con Apple Pay es de $5.000.Superas tu límite diario de $500 (ya depositaste $100). Puedes cambiarlo en Juego responsable.
Para integraciónLímites por método, por operación y por periodo (incluidos los de juego responsable del jugador) con el importe ya consumido para construir el mensaje. La caja no comprueba hoy el límite diario (ver propuestas).
Para integraciónTokenización de la tarjeta (nunca guardar el número completo), 3-D Secure con desafío o redirección y respuesta con estado, referencia (DP-…), método enmascarado y saldo nuevo.
Para integraciónCódigo de rechazo del procesador (05 no autorizada, 51 fondos insuficientes…) traducido a un texto para el jugador. En la caja, el monto de prueba (666 en moneda local, o 6.660… si el mínimo es mayor) rechaza tarjeta, billeteras, Pix y los demás métodos instantáneos; las transferencias y los pagos en efectivo siempre quedan pendientes.
Para integraciónApple Pay y Google Pay a través del procesador (token del dispositivo). Billeteras: URL de redirección y de retorno con el estado; si el jugador no vuelve, el pago debe quedar pendiente o cancelado.
Para integraciónBonos elegibles por depósito con sus reglas (porcentaje, tope, rollover) y validación de cupones en servidor. Hoy la caja y la página calculan bonos distintos en el front: el backend debe ser la única fuente.
Retiro
Retiro desde la caja (modal #withdraw) y desde la página Retirar. Solo se retira saldo real y solo con la identidad verificada. Los enlaces abren la billetera de moneda única; en multimoneda, el retiro va por moneda (ver Retiro cripto y Retiro en moneda local).
Para integraciónEl servidor también debe rechazar retiros sin KYC aprobado y devolver el motivo. Si el formulario se envía igualmente, la página avisa con el toast «Verificación requerida».
Por debajo del mínimo, por encima del saldo real o del máximo diario.
ErrorCaja · Página Retirar
Disparador
JugadorPulsa «Solicitar retiro» con un monto no permitido.
Pasos
Escribe el monto o pulsa «Máximo», que rellena todo el saldo real.
Se valida contra el mínimo, el saldo real y el máximo diario.
El campo muestra el error y no se envía la orden.
Lo que ve el jugador
Error en campo · Monto
El retiro mínimo es de $20.El monto supera tu saldo disponible ($2.847,50).El máximo diario es de $10.000. Sube a nivel 3 de verificación para retirar más.
Para integraciónMínimo, máximo diario por nivel KYC y saldo retirable (solo saldo real, sin bono ni importes en retiros pendientes). El máximo diario solo se valida en la página.
Para integraciónOrden de retiro con referencia (WD-…), estado (pendiente, en proceso, completado, rechazado) y motivo de rechazo; bloqueo del importe al solicitar y notificación en cada cambio de estado. Los cambios posteriores a «Pendiente» no están simulados en vivo (ver propuestas).
Para integraciónValidación de titularidad (microdepósito de $0,01 o servicio bancario) antes de permitir retiros a esa cuenta.
Mercados y países
El prototipo es un sitio de un solo país y una sola moneda (17 mercados). Cada país cambia los métodos de pago, los documentos, el regulador, el juego responsable, los impuestos y las reglas de juego. Aquí se explica qué debe aportar el backend por tipo de pago y por país.
Para integraciónEn producción el país sale del dominio o de la licencia del sitio (betv1.com.br, betv1.co.uk…), no de un selector, y no se cambia en la sesión. El backend define por mercado: moneda, proveedores de pago, documentos aceptados, regulador, textos legales, límites y reglas de bono. La moneda es una sola por jugador y no hay conversión ni saldo en otras monedas.
Para integraciónCobro con el procesador del país (3-D Secure obligatorio en GB, ES, PT, DE y recomendado en el resto). Traducir el código de rechazo (05 no autorizada, 51 fondos insuficientes…) a un texto para el jugador. Solo tarjetas a nombre del titular. El monto de prueba cambia por país porque el mínimo de depósito es distinto: la caja lo muestra bajo el campo de monto.
En Brasil, Reino Unido, España y Alemania solo se aceptan tarjetas de débito.
ErrorCaja · Página Depositar
Disparador
JugadorIntroduce una tarjeta de crédito en un mercado donde está prohibida.
Pasos
El método se llama «Tarjeta de débito» y el formulario avisa de la restricción.
Se detecta el tipo de tarjeta por el BIN al terminar de escribir el número.
El botón de pagar se bloquea y el campo muestra el error.
Lo que ve el jugador
Alerta · Formulario de tarjeta
Solo se admiten tarjetas de débito a tu nombre: las de crédito están prohibidas por la regulación.
Error en campo · Número de tarjeta
Es una tarjeta de crédito: en Reino Unido solo se admiten tarjetas de débito.
Cómo verloReino UnidoBrasilEspañaAlemaniaTarjeta de crédito de prueba 5555 5555 5555 4444 (Mastercard crédito): se bloquea solo en esos cuatro mercados
Para integraciónConsultar el tipo de tarjeta (débito, crédito, prepago) con el procesador antes de cobrar y rechazar las de crédito; el UKGC lo prohíbe desde abril de 2020, y también DGOJ, el GlüStV y el SPA/MF de Brasil. Registrar el motivo del rechazo para soporte.
Para integraciónPSP con Pix (o CoDi/Yape/SnapScan): crear el cobro con el CPF del titular, guardar el txid, recibir el callback de pago y conciliar por importe exacto. Si el pagador no coincide con el CPF de la cuenta, devolver el pago. Idempotencia en el webhook y estado «caducado» a los 10 minutos.
Para integraciónCuenta virtual o referencia única por jugador (CLABE dinámica en México, cuenta NUBAN virtual en Nigeria) para conciliar de forma automática. Plazos: SPEI y CVU inmediatos, PesaLink 1 h, EFT sudafricana 24 h, SEPA 1 día hábil. Notificar al acreditar y marcar como fallido si el banco devuelve la transferencia.
Para integraciónGenerar la orden de pago con el agregador (entidad y referencia de Multibanco, CIP de PagoEfectivo, convenio de Efecty…), con vencimiento y monto exacto; confirmar por callback y registrar el depósito como «pendiente» hasta entonces. Los depósitos en efectivo no llevan bono hasta acreditarse.
Para integraciónURL de retorno por método con el estado y una URL de callback servidor a servidor (la de retorno no es fiable). En open banking (Trustly, Pay by Bank, Klarna) el nombre del titular del banco debe coincidir con el de la cuenta; si no coincide, devolver el pago.
Para integraciónSolicitud al operador móvil (Daraja STK push en Kenia, SIBS en Portugal, Bizum de la banca española…) y callback de resultado con tiempo máximo. Verificar que el número pertenece al titular (M-Pesa a nombre del jugador). En Kenia, la caja muestra el desglose del impuesto especial (ver «Impuestos sobre depósitos y retiros»).
El jugador marca un código en su móvil, sin internet, con el banco de su elección.
PendienteCaja · Página Depositar
Disparador
JugadorEn Nigeria elige USSD, el monto y su banco.
Pasos
La pantalla muestra el código del banco con el monto y la referencia ya rellenos (por ejemplo *737*50*{monto}*{ref}# en GTBank).
El jugador lo marca desde el móvil registrado en su banco y elige la cuenta de origen.
Pulsa «Ya marqué el código»: capa de carga y pantalla de pendiente.
El banco confirma y el saldo se acredita.
Lo que ve el jugador
Alerta · USSD
Marca este código desde el móvil registrado en tu banco y vuelve aquí y toca «Ya marqué el código».
Capa de carga · Caja
Verificando el pago…
Normalmente tarda unos segundos.
Cómo verloNigeria · USSDBancos de ejemplo: GTBank, Access Bank, Zenith Bank, First Bank y UBA
Para integraciónAgregador (Paystack, Flutterwave…) que genere el código USSD por banco con referencia de transacción y avise por webhook. Cada banco usa un código distinto; la lista de bancos y plantillas debe venir de configuración.
Para integraciónLlamada de canje al emisor (paysafecard, Blue Label/1Voucher) que devuelva el valor y el saldo restante. Los cupones no admiten retiros: ofrecer otro método a nombre del jugador. En Reino Unido y Alemania cuentan para el límite de depósito.
Cada país pide otros datos de destino; el retiro siempre va a una cuenta o billetera a nombre del jugador verificado.
ÉxitoCaja · Página Retirar
Disparador
JugadorCon identidad verificada, elige el método de retiro del país e introduce los datos de destino.
Pasos
Solo aparecen los métodos de retiro del país (más cortos que los de depósito).
El formulario cambia según el método: clave Pix, CLABE, CVU, CCI, IBAN, sort code, NUBAN, teléfono…
Se valida el formato en el campo y, cuando existe, se resuelve el nombre del titular con el banco.
Se muestra el desglose con impuestos y se confirma el retiro.
La orden queda «en revisión» y sale tras la revisión de seguridad; el saldo se descuenta al solicitarla.
Lo que ve el jugador
Error en campo · Clave Pix
La cuenta del Pix tiene que estar a tu CPF; si no coincide, el retiro se rechaza.
Error en campo · CLABE
La CLABE debe tener 18 dígitos.
Error en campo · NUBAN
Nombre verificado con tu BVN.
Pantalla de resultado · Caja
Retiro solicitado
Revisamos cada retiro por seguridad antes de enviarlo. Te avisaremos cuando salga.
País
Método
Datos del retiro
Validación
Brasil
Pix · TED
Clave Pix (CPF, correo, teléfono o aleatoria) · banco, agencia y cuenta
La clave Pix debe ser del CPF del jugador
México
SPEI
CLABE interbancaria de 18 dígitos
Dígito verificador de la CLABE
Argentina
CVU / CBU · Mercado Pago
CVU o CBU de 22 dígitos, o alias
Titular con el DNI o CUIL
Chile
Transferencia · MACH
Banco, tipo y número de cuenta · teléfono
Cuenta con el RUT del jugador
Colombia
Cuenta bancaria · Nequi
Banco y cuenta · celular
Cuenta a nombre del titular
Perú
Interbancaria · Yape
CCI de 20 dígitos · celular
El CCI debe tener 20 dígitos
España · Alemania
SEPA
IBAN
Dígitos de control del IBAN
Reino Unido
Faster Payments
Sort code de 6 dígitos y número de cuenta de 8
El sort code tiene 6 dígitos
EE. UU.
ACH · cheque
Routing number (ABA) de 9 dígitos y cuenta · domicilio para el cheque
El routing number tiene 9 dígitos
Canadá
Interac · EFT
Correo de Interac · tránsito, institución y cuenta
Correo o cuenta a nombre del titular
Nigeria
Transferencia · OPay
Número NUBAN de 10 dígitos
Resolución de nombre: «Nombre verificado con tu BVN.»
Kenia
M-Pesa · PesaLink
Teléfono M-Pesa registrado a su nombre
Nombre del titular del número
Sudáfrica
EFT · PayShap
Banco, cuenta y código de sucursal · teléfono
La cuenta bancaria debe estar a tu nombre
Ghana · Filipinas
MoMo · InstaPay
Teléfono de la billetera · cuenta bancaria
Billetera a nombre del titular
Cómo verloBrasilMéxicoReino UnidoNigeriaKeniaDatos válidos de prueba en cada país: los precarga la cuenta de demostración (ver Países del sitio)
Para integraciónValidar el formato de cada dato de destino (dígito verificador de CLABE e IBAN, longitud de CCI/NUBAN/sort code) y comprobar con el banco o el PSP que el titular coincide con el nombre y el documento del KYC (Pix con el CPF, NUBAN con el BVN). Nunca pagar a terceros. Los retiros salen por el mismo método del depósito cuando el regulador lo exige.
En Kenia, la caja muestra el impuesto especial del 5% al depositar y la retención del 5% al retirar; en el resto de países solo hay un texto informativo sobre las ganancias.
AvisoCaja · Página Depositar · Página Retirar
Disparador
JugadorEn Kenia introduce un monto de depósito o de retiro.
Pasos
Bajo el monto se desglosa: importe, impuesto especial (5%) y total que llega al saldo.
En el retiro se muestra la retención del 5% y lo que recibirá el jugador.
Los créditos promocionales también pagan el impuesto especial.
Sin impuestos sobre movimientos, el desglose no aparece.
Lo que ve el jugador
Alerta · Depósito · Kenia
Impuesto especial (5%): se suma al importe del depósito.
Alerta · Retiro · Kenia
Retención sobre retiros (5%): se descuenta del importe que recibes.
Alerta · Información fiscal
Retención del 20% sobre las ganancias (Finance Act 2026).
Para integraciónCalcular el impuesto en el backend y devolverlo desglosado (base, tasa, impuesto, total) para mostrarlo y registrarlo en el historial. Los porcentajes y su nombre vienen de la configuración del mercado y se publican a la autoridad fiscal (KRA en Kenia). Los premios gravados (Colombia, México, EE. UU., Brasil) se informan al jugador pero retiene el operador solo donde la ley lo exige.
Para integraciónConsultar LUGAS (el sistema federal de límites entre operadores) antes de cada depósito y comunicar el importe depositado; el operador no puede aceptar más de 1.000 € al mes por jugador, y subir el límite propio requiere esperar. También se consulta OASIS (bloqueos) al iniciar sesión y en cada depósito.
Para integraciónGuardar los límites en el alta con fecha y valor, aplicarlos en cada depósito y exigir el periodo de espera al subirlos. El registro no debe crear la cuenta si faltan los límites obligatorios; el regulador puede pedir el histórico de cambios.
Para integraciónProveedor de geolocalización certificado (GeoComply u otro) en el dispositivo, comprobación en el inicio de sesión, en cada apuesta o giro y en el depósito, con registro de la posición. Distinguir VPN, proxy y ubicación simulada.
Para integraciónValidar en cliente (formato) y en servidor (dígito verificador y consulta oficial: Receita Federal para el CPF, SAT/RENAPO para la CURP, Registro Civil del RUT, NIBSS para el BVN, Home Affairs para el ID sudafricano, NIA para la Ghana Card). La cuenta de retiro debe coincidir con el titular.
Para integraciónIntegrar la API del registro del país (GAMSTOP, OASIS, RGIAJ…) con consulta en el alta, en cada login y antes de campañas de marketing. Registrar la exclusión propia y aplicarla en todo el sitio, sin posibilidad de cancelarla antes del plazo.
Para integraciónEl reloj lo gobierna el backend (inicio de sesión, no solo el navegador) y debe enviar el aviso con el tiempo jugado y las ganancias o pérdidas netas. El intervalo mínimo y el texto lo fija cada regulador.
Para integraciónPasar al proveedor del juego los parámetros del mercado (apuesta máxima por edad, velocidad mínima, autoplay desactivado) al abrir la sesión y verificar la edad del jugador. La edad se toma de la fecha de nacimiento verificada.
Para integraciónDesactivar por configuración del mercado todos los productos de casino (juegos, proveedores, jackpots, torneos de casino), incluido en la API de lanzamiento de juegos, y limitar las promociones a deportes.
Para integraciónLa configuración del mercado decide si existe bono de bienvenida, su requisito de apuesta y si se permite combinar casino y deportes. Ocultarlo en el CMS y en las campañas de captación, no solo en el front.
Para integraciónEl feed de cuotas llega en formato decimal y se convierte para mostrar; el formato es una preferencia de presentación y no cambia el importe pagado.
Para integraciónSolo para el prototipo. En el sandbox del PSP se usan las tarjetas y montos de prueba de cada proveedor; este mapa sirve como guía para QA.
Bonos y saldo
Saldo real frente a saldo de bono, requisito de apuesta, cancelación del bono, ofertas y códigos promocionales.
Para integraciónEndpoint de saldos con real, bono, monedas V1 e importe bloqueado en retiros, y un evento de actualización para repintar todas las vistas a la vez (en el front, los elementos con data-user).
Para integraciónProgreso del rollover (apostado y requisito), contribución por tipo de juego, apuesta máxima, fecha de caducidad y regla de pérdida al retirar. Faltan los estados de bono completado y caducado (ver propuestas).
Para integraciónEndpoint de lanzamiento que devuelva la URL del proveedor para el jugador y el modo (token de sesión de juego). Si se pide dinero real sin sesión, el iframe arranca en demo.
Mensajes entre el juego y la página para que el saldo sea el mismo en todas partes.
InformativoPágina de juego · Header
Disparador
SistemaCada giro, premio o depósito durante la partida cambia el saldo.
Pasos
Dinero real: el iframe actualiza el saldo y avisa a la página, que repinta header, menú y barra del juego.
Demo: el iframe informa de su saldo propio y solo cambia la barra del juego.
Si el jugador deposita en la caja mientras juega, el iframe relee el saldo antes del siguiente giro.
Un premio de x20 o más se anuncia con un toast en la página.
Lo que ve el jugador
Toast · Gran premio
¡Gran premio!$250,00 en Gates of Olympus 1000 · x250
En el juego · Resultado de cada giro
Ganancia¡Gran premio!Sin premio esta vez
Mensajes postMessage del iframe a la página
Mensaje
Cuándo
Efecto en la página
{type:"bv:user"}
Cambio de saldo con dinero real
Recarga el usuario y repinta todos los saldos
{type:"bv:demo", balance}
Cambio de saldo en demo
Actualiza el saldo demo de la barra
{type:"bv:open", id:"cashier", tab:"deposit"}
Saldo insuficiente
Abre la caja en Depositar
{type:"bv:toast", title, text, kind}
Avisos del juego
Muestra el toast en la página
{type:"bv:spin", on}
Inicio y fin de cada giro con dinero real
Un cambio de país o de modo espera al final del giro
{type:"bv:esc"}
Tecla Escape dentro del juego
Cierra el juego a pantalla completa en móvil
Cómo verloJuego con sesiónJuega con dinero real y mira el saldo del header
Para integraciónCon un proveedor real, el saldo autoritativo viene del wallet del backend: escuchar los eventos del proveedor (o consultar el saldo) y validar el origen de cada postMessage, que hoy se envía a cualquier origen.
Para integraciónFavoritos y recientes se guardan hoy solo en el dispositivo (localStorage): persistirlos en la cuenta para verlos en cualquier dispositivo, como promete el mensaje.
Para integraciónReglas de combinación (selecciones relacionadas, mínimo de selecciones, bonificación por número de selecciones) validadas también en servidor.
Para integraciónFeed de cuotas en tiempo real (WebSocket) y respuesta de colocación «cuota cambiada» con la cuota nueva; preferencia del jugador para aceptar subidas.
Para integraciónRespuesta de colocación con ID de cupón, cuota final y estado (aceptada, rechazada o pendiente de aprobación del operador). El rechazo no está simulado (ver propuestas).
Para integraciónValor de cash out en tiempo real, suspensión por mercado y confirmación con el importe final, que puede variar entre la oferta y la aceptación.
Para integraciónProgreso de misiones a partir de los eventos de juego, endpoint de reclamo idempotente y condiciones de desbloqueo (nivel o misión previa).
Para integraciónClasificación en tiempo real con la posición del jugador, premio actual, puntos para el siguiente tramo y liquidación automática del premio al finalizar.
Los premios que el jugador no puede pagar se ven atenuados; los agotados tienen el botón deshabilitado.
Sin monedas suficientes, la tarjeta tiembla y aparece un toast de error.
Con monedas suficientes, diálogo de confirmación con el saldo restante.
Se descuentan las monedas, el canje entra en el historial y hay confeti.
Lo que ve el jugador
Toast · Monedas insuficientes
Monedas insuficientesTe faltan 3.050 monedas para «Bono de $100».
Diálogo de confirmación
¿Canjear este premio?
Bono de $25 por 1.500 monedas V1. Te quedarán 950.
CancelarCanjear 1.500
Toast · Canje
¡Canje realizado!Bono de $25 ya está en tu cuenta.
Alerta · Tienda sin sesión
Gana monedas V1 jugandoCrea tu cuenta y recibe 200 monedas de bienvenida para tu primer canje.
Crear cuenta
Agotado
Cómo verloTiendaSin monedas suficientes: «Bono de $100» (5.500)Sin sesión
Para integraciónCatálogo con precio, stock y disponibilidad; canje con descuento atómico de monedas y entrega del premio en el saldo o los giros correspondientes.
Para integraciónEl premio lo decide el servidor, nunca el front, con elegibilidad diaria, coste en monedas y acreditación en el saldo correspondiente. Tras girar, «Recargar giro» repite la rueda solo en el prototipo.
Juego responsable
Límites de depósito, pérdida y sesión, recordatorio de realidad, pausa y autoexclusión, en la página Juego responsable de la cuenta.
Bajar un límite se aplica al instante; subirlo tarda 24 horas.
ÉxitoAvisoJuego responsable
Disparador
JugadorPulsa «Cambiar límite» en el límite diario, semanal o mensual y guarda.
Pasos
Se valida el monto (mayor que 0 y hasta $100.000); el botón muestra «Guardando…».
Bajada: se aplica desde ahora, con la barra de uso actualizada y la etiqueta «Activo».
Subida: queda pendiente 24 horas con la etiqueta «Cambio pendiente».
El depósito respeta el límite (ver «Monto fuera de límites»).
Lo que ve el jugador
Error en campo · Monto del límite
Introduce un monto mayor que 0.El máximo permitido es $100.000.
Toast · Bajada
Límite diario actualizadoSe aplica desde ahora: $300.
Toast · Subida
Aumento programadoLímite diario de $800 en 24 horas.
ActivoCambio pendiente
Cómo verloLímitesLímite diario actual $500: prueba 300 y 800
Para integraciónLímites por periodo con el importe usado, enfriamiento de 24 horas para las subidas, aplicación inmediata de las bajadas y bloqueo de cualquier depósito que los supere.
Durante la pausa no se puede depositar ni jugar, pero sí retirar el saldo real.
Lo que ve el jugador
Diálogo de confirmación
¿Pausar tu cuenta 24 horas?
No podrás depositar ni jugar hasta el 13 nov 2026, 15:00. Podrás retirar tu saldo real.
CancelarPausar cuenta
Bloque en pantalla · Estado
Cuenta en pausa · 24 horas
No podrás depositar ni jugar hasta el 13 nov 2026, 15:00. Tus retiros siguen disponibles.
Toast · Global
Pausa activadaHasta el 13 nov 2026, 15:00
Cómo verloPausa«Deshacer (solo prototipo)» vuelve al estado inicial
Para integraciónEstado de pausa con fecha de fin que bloquee el depósito y el juego en todo el sitio. En el prototipo solo se muestra el aviso (ver propuestas).
Para integraciónCierre irreversible hasta la fecha, devolución del saldo real, baja de comunicaciones comerciales y registro en el sistema de autoexclusión del regulador cuando aplique. En el prototipo la cuenta sigue activa (ver propuestas).
Sistema
Cierre de sesión, página no encontrada, mantenimiento y mensajes globales que aparecen en cualquier pantalla.
Para integraciónInterruptor de mantenimiento con hora estimada de fin y estado de las tareas; responder 503 con Retry-After y redirigir todas las rutas a esta pantalla mientras dure.
Para integraciónConectar «Soporte en vivo» y «Chat en vivo» al proveedor de chat real con el contexto del jugador (y del movimiento, desde el historial).
Estados recomendados que aún no están simulados
Propuesta: situaciones que un casino real necesita y que el prototipo todavía no muestra. Los textos son sugerencias para validar con producto y legal, no mensajes existentes.
Tras «Recuperar contraseña» no existe la pantalla del enlace.
PropuestaAcceso
Pantalla con contraseña nueva y repetición, más dos estados: enlace caducado o ya usado («Este enlace ya no es válido. Pide uno nuevo.») y éxito con inicio de sesión automático.
Para integraciónValidación del token (caducado, usado, inválido) y cierre de las demás sesiones al cambiarla.
El 2FA se activa en Seguridad, pero el login no lo pide.
PropuestaAcceso
Paso extra en el modal de login: «Introduce el código de tu app autenticadora», con opción de usar un código de respaldo y error de código incorrecto o caducado.
Para integraciónRespuesta de login «requiere 2FA» con token temporal y endpoint de verificación del código.
SPEI, PSE, Pix y los pagos en efectivo se quedan en «pendiente» en el prototipo.
PropuestaDepósito
Toast y notificación al acreditar («Depósito confirmado»), estado de código Pix vencido («El código expiró. Genera uno nuevo para continuar.») y pago bancario rechazado o devuelto, también visibles en el historial.
Para integraciónWebhooks del procesador con el estado final y un canal en tiempo real (WebSocket o push) para avisar al jugador aunque haya cerrado la caja.
Tras solicitarlo, el retiro se queda en «Pendiente».
PropuestaRetiro
Notificaciones y estados «En revisión de seguridad», «Pagado» y «Rechazado» con motivo y devolución del importe al saldo («Tu retiro fue rechazado: la cuenta de destino no está a tu nombre. Devolvimos $300,00 a tu saldo.»).
Para integraciónMáquina de estados del retiro, motivos de rechazo normalizados y evento por cada cambio.
Alertas en el cupón para mercado suspendido («Mercado suspendido. Quita la selección o espera a que se reabra.»), apuesta por encima del máximo con el importe máximo permitido, y apuesta pendiente de aprobación del operador.
Para integraciónCódigos de rechazo de la colocación (suspendido, máximo superado, cuota cambiada, límite del jugador) con los datos para cada mensaje.
Toast y notificación al completar el requisito («Requisito completado: $150,00 pasan a tu saldo real.») y al caducar el bono, con su paso al historial.
Para integraciónEvento de conversión del bono a saldo real y de caducidad, con los importes.
Hoy solo se muestran los avisos en la página de juego responsable.
PropuestaJuego responsable
Modal al llegar al límite de sesión con aviso 5 minutos antes, recordatorio de realidad con tiempo jugado y resultado, bloqueo de depósito y juego durante la pausa, y login bloqueado para cuentas autoexcluidas con la fecha de fin.
Para integraciónEstado de juego responsable incluido en la sesión y comprobado en cada depósito, lanzamiento de juego y apuesta.
No hay pantallas de error de red ni de geolocalización.
PropuestaSistema · Juego
Pantalla de país no disponible, toast de conexión perdida y recuperada, y estado «Este juego no está disponible ahora» en la portada del juego con alternativas.
Para integraciónGeolocalización por IP en el borde, estado de salud de cada proveedor de juegos y códigos de error genéricos del API.
«Reclamar» en misiones muestra el toast genérico de dinero real.
PropuestaAcceso · Club
Usar un texto por acción, por ejemplo «Inicia sesión para reclamar tu recompensa», como ya hacen torneos y mini juegos.
Para integraciónSolo front: un texto por botón protegido en lugar del toast común de data-need-auth.
Iniciar sesión
¿Nuevo en BetV1?
Correo o contraseña incorrectosRevisa tus datos. Te quedan 2 intentos antes del bloqueo temporal.
o continúa con
Prototipo: cualquier dato inicia sesión. Usa la contraseña error123 para ver el error de credenciales y un usuario con bloqueado para la cuenta bloqueada.
Crea tu cuenta
¿Ya tienes cuenta?
200% hasta $1.500 + 150 girosBono de bienvenida en tus tres primeros depósitos
1Acceso
2Datos
3Confirmar
Recuperar contraseña
Te enviaremos un enlace para crear una nueva.
Revisa tu correo
Si existe una cuenta con ese correo, recibirás un enlace válido durante 30 minutos.
Caja
Colombia · COP
Búsquedas populares
Tendencias ahora
Sin resultados para «»
Revisa la ortografía o prueba con el nombre del proveedor, por ejemplo Pragmatic o Evolution.
VR
Valentina R.ID 28074179 · VIP Oro · Nivel 14
Saldo real$2.847,50
Bono$150,00
¿Estás seguro?
Esta acción no se puede deshacer.
Prototipo · controles
Sesión iniciadaAlterna logueado / no logueado
Cambia moneda, pagos, documentos, regulación e idioma del sitio.