Conversión estática desde DOCX. Fuente: /home/sebas/work/projects/ballbox/docs/tcn-maquinas-recibido-2026-05-26/PARTE 3 - EasyCoin BillWallet Operacion Comercial y Arquitectura Futura.docx
EasyCoin, BillWallet, Operación Comercial y Arquitectura Futura
Una vez validado el funcionamiento mecánico y la conectividad de la máquina, el siguiente objetivo fue validar el flujo real de cobro.
La empresa utilizada para pagos es:
EasyCoin
La gestión de dispositivos y cuentas se realiza mediante:
BillWallet
Se recibió un dispositivo EasyCoin.
La instalación fue realizada junto con personal de la empresa.
Resultado:
Instalación exitosa.
Se realizaron pruebas reales.
Resultado observado:
Usuario selecciona producto.
Usuario realiza pago.
EasyCoin recibe confirmación.
Máquina libera el canal.
Producto cae correctamente.
Estado:
Durante las pruebas apareció un valor de balance en pantalla.
Sin embargo:
No se observó modificación visible del balance cuando ingresó dinero.
A pesar de ello:
La máquina liberó correctamente el producto.
Hipótesis:
El balance visible pertenece al firmware TCN y no al flujo principal de EasyCoin.
Pendiente:
Confirmar con EasyCoin.
BillWallet es la plataforma de administración utilizada por EasyCoin.
Cada dispositivo queda asociado a una cuenta BillWallet.
Importante:
La asociación se realiza con el usuario.
NO con el dispositivo.
Arquitectura observada:
Dispositivo
↓
Usuario BillWallet
↓
MercadoPago
Consecuencia:
Un usuario puede administrar múltiples dispositivos.
Todos los dispositivos cobran al mismo MercadoPago.
Cuenta BallBox
↓
Máquina Club A
Máquina Club B
Máquina Club C
Máquina Club D
↓
Todos los pagos llegan a la misma cuenta MercadoPago.
BallBox recibe toda la recaudación.
Ventajas:
Control total de ventas.
Control total de stock.
Conciliación simplificada.
Pago mensual a clubes.
Menor riesgo de diferencias de inventario.
Posibilidad de aprovechar flujo de caja.
Mayor responsabilidad administrativa.
Mayor responsabilidad financiera.
Necesidad de conciliación periódica.
Posibles cuestiones impositivas futuras.
Alternativa:
Cada club crea su propio usuario BillWallet.
Cada club conecta su propio MercadoPago.
Resultado:
Los fondos llegan directamente al club.
BallBox no administra dinero ajeno.
Menor responsabilidad financiera.
Menor control.
Menor visibilidad.
Más difícil verificar ventas.
Posibilidad de discrepancias de stock.
BillWallet permite agregar usuarios.
Posible implementación:
Club:
Administrador Club
BallBox:
Administrador BallBox
Objetivo:
Acceder a métricas y monitoreo.
Pendiente:
Validar si un administrador puede eliminar a otro usuario.
Cada cuenta BillWallet genera un QR.
Proceso observado:
Configurar MercadoPago.
Generar QR.
Descargar QR.
Imprimir QR.
Colocar QR en la máquina.
Si cambia el MercadoPago:
El QR cambia.
Por lo tanto:
Debe reemplazarse el QR físico.
Siempre verificar:
□ QR actualizado
□ MercadoPago correcto
□ Impresión correcta
□ QR visible para usuarios
Descubrimiento muy importante.
EasyCoin ofrece API.
Credenciales disponibles:
API Key
API Secret
La API permitiría:
Consultar dispositivos.
Consultar estado.
Acreditar pagos.
Liberar productos.
Obtener eventos.
Integrar sistemas externos.
Pendiente:
Documentación completa.
Este descubrimiento cambia significativamente el potencial del proyecto.
Arquitectura posible:
↓
Backend BallBox
↓
API EasyCoin
↓
Máquina
↓
Producto
Compra desde aplicación
Usuario compra desde ATC.
ATC procesa operación.
EasyCoin recibe autorización.
Máquina libera producto.
Beneficios de socios
Socios premium reciben:
descuentos
productos gratis
promociones
Canje de puntos
Puntos ATC
↓
Producto físico
Torneos
Premios automáticos.
Packs de bienvenida
Nuevo socio:
tubo de pelotas
grip
bebida
Liberados automáticamente.
Tanto la máquina TCN como EasyCoin poseen antenas.
Actualmente ambas permanecen dentro del gabinete.
El gabinete es metálico.
Posible degradación de señal.
Ante problemas de comunicación:
Sacar antena al exterior.
Repetir pruebas.
Medir mejora.
Posicionar máquina.
Conectar energía.
Verificar tierra.
Configurar red.
Verificar cloud.
Configurar EasyCoin.
Configurar MercadoPago.
Descargar QR.
Colocar QR.
Configurar productos.
Configurar precios.
Configurar stock.
Configurar publicidad.
Probar todos los canales.
Realizar compra real.
Confirmar liberación.
Pegar QR legal detrás.
Entregar máquina.
Actualmente:
Máquina
↓
OurVend
↓
EasyCoin
↓
BillWallet
↓
MercadoPago
Hipótesis futura:
Máquina
↓
Backend BallBox
↓
EasyCoin
↓
↓
Usuarios
Objetivo:
Controlar experiencia completa.
Sin depender operativamente de OurVend.
Analizar Text.
Analizar ImageGoods.
Analizar v3Skins.
Analizar Android/data/com.tcn.vending.
Obtener documentación API EasyCoin.
Probar liberación remota.
Probar acreditación remota.
Capturar tráfico TCP.
Comprender autenticación.
Evaluar backend BallBox propio.