💰 Wallet (Saldo Prepago)
Gestiona el saldo prepago que financia el envío de plantillas de WhatsApp.
¿Qué es el Wallet?
El Wallet es un saldo prepago en USD asociado a cada hotel. Su función principal es financiar el envío de plantillas de WhatsApp (mensajes que el bot o el equipo inician fuera de la ventana de 24 horas y que Meta cobra por mensaje).
Cada vez que se envía una plantilla, el sistema descuenta el costo correspondiente del saldo. Si el saldo se agota, no se pueden enviar más plantillas hasta recargar.
Accede desde: Wallet en el menú lateral (/wallet).
:::note Requiere un plan de pago (Matrix o superior) En planes sin acceso, el módulo muestra un banner de actualización en lugar del saldo. :::
Interfaz del módulo
1. Saldo disponible
Tarjeta principal que muestra el saldo actual en USD y la fecha de última actualización. Si el saldo cae por debajo del umbral configurado, aparece un banner rojo de saldo bajo recordando recargar.
2. Recarga rápida
- Montos rápidos: botones de $10 / $25 / $50
- Monto personalizado: campo libre con mínimo $10 y máximo $1.000 por recarga
- Al confirmar, el sistema redirige a Stripe para completar el pago (se aceptan códigos promocionales)
- Tras el pago exitoso, vuelves al Wallet y el saldo se actualiza automáticamente
3. Costos de plantilla por mensaje
El módulo muestra una tabla de referencia con el costo por categoría de plantilla:
| Categoría de plantilla | Costo por mensaje |
|---|---|
| Marketing | $0.05 |
| Utility (utilidad) | $0.02 |
| Authentication (autenticación) | $0.03 |
Estos costos se descuentan del saldo en el momento del envío de cada plantilla.
4. Historial de transacciones
Tabla paginada (20 registros por página) con cada movimiento del saldo:
| Columna | Descripción |
|---|---|
| Fecha | Cuándo ocurrió el movimiento |
| Tipo | Recarga (top-up), Reembolso (refund) o Descuento (deduction) |
| Descripción | Detalle del movimiento (p. ej., plantilla enviada) |
| Monto | Importe del movimiento (+ para recargas/reembolsos, − para descuentos) |
| Saldo posterior | Saldo resultante tras el movimiento |
Botón «Sincronizar»
En la cabecera del módulo hay un botón «Sincronizar». Recupera desde Stripe los pagos que se completaron pero que aún no se reflejan en el saldo (por ejemplo, si la redirección posterior al pago falló). Úsalo si pagaste una recarga y el saldo no se actualizó.
Problemas comunes
| Síntoma | Causa probable | Solución |
|---|---|---|
| No veo el módulo Wallet / aparece banner de actualización | Plan no habilitado para Wallet | Actualizar a un plan de pago (Matrix o superior) |
| Pagué pero el saldo no subió | Recarga no sincronizada | Pulsar «Sincronizar» en la cabecera del Wallet |
| El bot no envía plantillas de WhatsApp | Saldo agotado | Recargar el Wallet |
| Aparece banner rojo de «saldo bajo» | Saldo por debajo del umbral | Recargar antes de que se agote para no interrumpir el envío de plantillas |