PARTE 3 - EasyCoin BillWallet Operacion Comercial y Arquitectura Futura

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

Ballbox

Documentación Maestra De Investigación Y Operación

Parte 3

EasyCoin, BillWallet, Operación Comercial y Arquitectura Futura

Introducción

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

Instalación Del Dispositivo Easycoin

Se recibió un dispositivo EasyCoin.

La instalación fue realizada junto con personal de la empresa.

Resultado:

Instalación exitosa.

Prueba De Cobro

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:

Confirmado.

Observación Sobre El Balance

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

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.

Relación Entre Dispositivos Y Mercadopago

Arquitectura observada:

Dispositivo

Usuario BillWallet

MercadoPago

Consecuencia:

Un usuario puede administrar múltiples dispositivos.

Todos los dispositivos cobran al mismo MercadoPago.

Ejemplo Ballbox

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.

Ventajas Del Modelo Centralizado

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.

Desventajas Del Modelo Centralizado

Mayor responsabilidad administrativa.

Mayor responsabilidad financiera.

Necesidad de conciliación periódica.

Posibles cuestiones impositivas futuras.

Modelo Descentralizado

Alternativa:

Cada club crea su propio usuario BillWallet.

Cada club conecta su propio MercadoPago.

Resultado:

Los fondos llegan directamente al club.

Ventajas

BallBox no administra dinero ajeno.

Menor responsabilidad financiera.

Desventajas

Menor control.

Menor visibilidad.

Más difícil verificar ventas.

Posibilidad de discrepancias de stock.

Usuarios Adicionales

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.

Qr De Pago

Cada cuenta BillWallet genera un QR.

Proceso observado:

Configurar MercadoPago.

Generar QR.

Descargar QR.

Imprimir QR.

Colocar QR en la máquina.

Observación Importante

Si cambia el MercadoPago:

El QR cambia.

Por lo tanto:

Debe reemplazarse el QR físico.

Regla Operativa

Siempre verificar:

□ QR actualizado

□ MercadoPago correcto

□ Impresión correcta

□ QR visible para usuarios

Api Easycoin

Descubrimiento muy importante.

EasyCoin ofrece API.

Credenciales disponibles:

API Key

API Secret

Posibilidades Detectadas

La API permitiría:

Consultar dispositivos.

Consultar estado.

Acreditar pagos.

Liberar productos.

Obtener eventos.

Integrar sistemas externos.

Pendiente:

Documentación completa.

Integración Futura Con Atc

Este descubrimiento cambia significativamente el potencial del proyecto.

Arquitectura posible:

Atc

Backend BallBox

API EasyCoin

Máquina

Producto

Casos De Uso Posibles

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.

Antenas

Tanto la máquina TCN como EasyCoin poseen antenas.

Actualmente ambas permanecen dentro del gabinete.

Riesgo Identificado

El gabinete es metálico.

Posible degradación de señal.

Recomendación

Ante problemas de comunicación:

Sacar antena al exterior.

Repetir pruebas.

Medir mejora.

Procedimiento De Instalación En Club

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.

Hipótesis Estratégica Mayor

Actualmente:

Máquina

OurVend

EasyCoin

BillWallet

MercadoPago

Hipótesis futura:

Máquina

Backend BallBox

EasyCoin

Atc

Usuarios

Objetivo:

Controlar experiencia completa.

Sin depender operativamente de OurVend.

Próximos Experimentos Prioritarios

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.

Fin Parte 3