Aceptar pagos desde el Dashboard
Introducción
Esta guía es para comercios que cobran pagos a través del Dashboard de Fluxis — sin API ni código. Aprenderás a crear solicitudes de pago desde tu terminal POS, usar un QR estático en tu caja y seguir los pagos a medida que se completan.
¿Primera vez aquí? Completa el Registro y abre tu POS predeterminado desde Tu Dashboard y POS predeterminado.
Dos formas de recibir pagos
| Método | Ideal para | Cómo funciona |
|---|---|---|
| Solicitud de pago puntual | Una venta con monto conocido | Ingresa el monto en la terminal POS → el cliente escanea el QR o abre el enlace de pago |
| QR estático en la caja | Pagos de monto abierto en un lugar fijo | Imprime o muestra el QR estático del POS → el cliente escanea e ingresa el monto en su billetera |
Ambos métodos usan tu Punto de Venta predeterminado. Más información sobre el concepto en Solicitud de pago.
Crear una solicitud de pago desde la terminal POS
Usa este flujo cuando conoces el monto exacto a cobrar (por ejemplo, un checkout individual).
- Inicia sesión en el dashboard y ve a Points of Sale.
- Revisa la configuración de tu POS — aquí puedes configurar qué UAIs (combinaciones activo/red) aceptará la terminal.
- Selecciona tu moneda de referencia haciendo clic en ella, luego ingresa un monto de prueba (por ejemplo,
1.00). - Haz clic en Charge para generar la solicitud de pago.
- Muestra el código QR en pantalla al cliente, o haz clic en Send a payment link para compartir el enlace de pago.
- Revisa la solicitud generada en la tabla a la izquierda, junto con su estado actual.
El cliente paga con su billetera cripto. Fluxis detecta el pago on-chain y actualiza el estado de la solicitud automáticamente.
Las solicitudes de pago expiran después de unos 8 minutos si no se recibe pago. Crea una nueva solicitud si el cliente necesita más tiempo.
Lo que ve el cliente
El QR o enlace codifica un token NASPIP — una instrucción de pago firmada que indica a la billetera exactamente dónde y cuánto pagar. No necesitas entender el formato del token para usar el dashboard; Fluxis maneja la codificación y validación.
Imprime tu QR estático para la caja
En una tienda física, muchos comercios muestran un QR estático en la caja para que los clientes paguen sin que el personal ingrese cada monto en la terminal.
- Abre tu terminal POS (Points of Sale → Enter →).
- Localiza la opción de QR estático de este POS (representa la terminal en sí, no un monto fijo).
- Imprime o muestra el QR donde los clientes puedan escanearlo (mostrador, soporte de recibos, señalización).
- Cuando un cliente escanea, su billetera le pide ingresar el monto del pago.
El QR estático está vinculado a tu Punto de Venta, no a una transacción individual. Cada escaneo puede iniciar un nuevo pago con el monto que elija el cliente. Sigue los pagos completados en Payments en la barra lateral del dashboard.
Seguir pagos y estados
Toda la actividad aparece en Payments en la barra lateral del dashboard. Filtra por cuenta, rango de fechas o búsqueda para encontrar transacciones específicas.
Las solicitudes de pago pasan por estos estados:
| Estado | Significado | Qué hacer en el dashboard |
|---|---|---|
pending | Checkout creado; el pagador aún no eligió activo | Esperar o mostrar checkout alojado si aplica |
created | Dirección asignada; esperando pago (~8 min de expiración) | Mantener QR/enlace visible; esperar que el cliente pague |
confirmed | Pago on-chain confirmado; liquidación en proceso | Esperar completed antes de tratarlo como totalmente liquidado |
processing | Pago detectado; esperando confirmaciones blockchain | Informar al cliente que el pago está en curso |
completed | Pago recibido y confirmado | Pedido cumplido; el pago aparece en estadísticas de volumen |
expired | Sin pago a tiempo | Crear una nueva solicitud de pago para el cliente |
underpaid | El cliente envió menos de lo esperado | Contactar [email protected] |
overpaid | El cliente envió más de lo esperado | Contactar [email protected] |
failed | Error inesperado durante el procesamiento | Contactar soporte; puede necesitarse una nueva solicitud |
Casos límite
Montos inusuales (underpaid, overpaid) y fallos de procesamiento pueden requerir coordinación con soporte. Consulta Flujos de pago — Casos límite para más contexto.
Flujo de pago (perspectiva del dashboard)
Code
¿Necesitas integrar vía API?
Si quieres integrar Fluxis en tu sitio web, app móvil o backend — y recibir notificaciones automáticas cuando los pagos se completen — sigue el camino de desarrollador:
Esa guía cubre claves API, autenticación, creación de solicitudes de pago vía POST /v1/pos/:posID/payment-request y monitoreo vía webhooks o polling.
¿Necesitas ayuda?
Contáctanos en [email protected].