Windows, Linux, Mac, Raspberry Pi

instalación desde binario compilado descargar el binario correspondiente a la plataforma desde la carpeta dist/ macos (apple silicon) sdconn arm64 app macos (intel) sdconn amd64 app windows sdconn windows amd64 exe linux sdconn linux amd64 pc o linux tradicional sdconn linux arm64 — raspberry pi 3/4/5 con os de 64 bits (raspberry pi os 64 bit) sdconn linux armv7 — raspberry pi 3/4 con os de 32 bits (raspberry pi os 32 bit) en macos, mover el app a la carpeta aplicaciones o ejecutar desde cualquier ubicación en windows, ejecutar el exe directamente (opcional) colocar un archivo config json en el mismo directorio del ejecutable para personalizar el puerto { "port" "8484" } si no se provee este archivo, el servicio usa los valores por defecto (puerto 8484) primer inicio al ejecutar sdconn por primera vez aparece un ícono en la bandeja del sistema (menú bar en macos, system tray en windows/linux) se abre automáticamente el panel de administración en el navegador (http //localhost 8484/admin) si el navegador no se abre automáticamente, hacer click en el ícono de la bandeja y seleccionar "panel de administración" configurar credenciales las credenciales son la clave api y el token de acceso de mobbex son necesarias para que sdconn pueda crear operaciones de pago en el panel de administración, completar los campos clave api — la api key de mobbex token de acceso — el access token de mobbex presionar "guardar credenciales" las credenciales se almacenan de forma segura en el llavero del sistema operativo (keychain en macos, credential manager en windows, secret service en linux) no se guardan en archivos una vez guardadas, el panel avanza al paso de selección de conexión borrar credenciales se pueden borrar desde el panel de administración (botón "borrar credenciales") el menú de la bandeja del sistema (opción "borrar credenciales") al borrar las credenciales, el servicio queda en espera hasta que se configuren nuevas conectar un dispositivo opción 1 serial (usb) conectar el dispositivo pos al equipo con un cable usb en el panel de administración, seleccionar "serial (usb)" el servicio busca automáticamente el dispositivo en los puertos usb cuando lo encuentra, la pantalla cambia a "dispositivo conectado" el dispositivo se pone automáticamente en modo pinpad y queda listo para recibir operaciones opción 2 red (http) asegurarse de que el dispositivo pos y el equipo estén en la misma red wi fi en el panel de administración, seleccionar "red (http)" el panel muestra la ip local del equipo y ofrece dos formas de encontrar el dispositivo escaneo automático\ ip manual presionar "escanear red" sdconn busca dispositivos en la subred local (puerto 5000) seleccionar el dispositivo de la lista ingresar la ip del dispositivo y el puerto (por defecto 5000) presionar "conectar" el dispositivo muestra un pin de 6 dígitos en su pantalla ingresar el pin en el panel de administración y presionar "confirmar" si el pin es correcto, el dispositivo queda conectado y en modo pinpad reconexión automática una vez emparejado un dispositivo por red, sdconn guarda un token de confianza en futuros inicios del servicio, se reconecta automáticamente sin pedir el pin nuevamente si el dispositivo cambia de ip o no está disponible, el servicio vuelve a solicitar la selección de conexión verificar estado desde la bandeja del sistema el menú del ícono muestra el estado actual dispositivo serie — /dev/cu usbmodemn621 (conexión serial activa) dispositivo red — pos n62 (192 168 1 50 5000) (conexión por red activa) dispositivo sin conexión (sin dispositivo) desde el panel de administración abrir http //localhost 8484/admin en cualquier momento si hay un dispositivo conectado, el panel muestra directamente la pantalla de "dispositivo conectado" con los detalles de conexión desde la api curl http //localhost 8484/admin/connection status respuesta { "mode" "serial", "connected" true, "port" "/dev/cu usbmodemn621" } desconectar desde el panel de administración, en la pantalla de dispositivo conectado, presionar "desconectar" esto libera la conexión con el dispositivo borra el token de confianza guardado vuelve a la pantalla de selección de modo de conexión detener el servicio desde el menú de la bandeja del sistema, seleccionar "salir" el servicio cierra la conexión serial (si aplica), detiene el servidor http y termina el proceso descarga windows linux mac