💰 Wallet (Prepaid Balance)
Manage the prepaid balance that funds the sending of WhatsApp templates.
What is the Wallet?
The Wallet is a prepaid balance in USD associated with each hotel. Its main purpose is to fund the sending of WhatsApp templates (messages that the bot or the team initiates outside the 24-hour window and that Meta charges for per message).
Each time a template is sent, the system deducts the corresponding cost from the balance. If the balance runs out, no more templates can be sent until you top up.
Access it from: Wallet in the side menu (/wallet).
:::note Requires a paid plan (Matrix or higher) On plans without access, the module shows an upgrade banner instead of the balance. :::
Module interface
1. Available balance
Main card showing the current balance in USD and the date it was last updated. If the balance falls below the configured threshold, a red low-balance banner appears reminding you to top up.
2. Quick top-up
- Quick amounts: $10 / $25 / $50 buttons
- Custom amount: free field with a $10 minimum and a $1,000 maximum per top-up
- On confirmation, the system redirects to Stripe to complete the payment (promo codes are accepted)
- After a successful payment, you return to the Wallet and the balance updates automatically
3. Per-message template costs
The module shows a reference table with the cost per template category:
| Template category | Cost per message |
|---|---|
| Marketing | $0.05 |
| Utility | $0.02 |
| Authentication | $0.03 |
These costs are deducted from the balance at the moment each template is sent.
4. Transaction history
Paginated table (20 records per page) with every balance movement:
| Column | Description |
|---|---|
| Date | When the movement occurred |
| Type | Recarga (top-up), Reembolso (refund), or Descuento (deduction) |
| Description | Detail of the movement (e.g., template sent) |
| Amount | Movement amount (+ for top-ups/refunds, − for deductions) |
| Resulting balance | Balance after the movement |
"Sync" button
In the module header there is a "Sync" button. It retrieves from Stripe any payments that were completed but are not yet reflected in the balance (for example, if the post-payment redirect failed). Use it if you paid for a top-up and the balance did not update.
Common issues
| Symptom | Likely cause | Solution |
|---|---|---|
| I don't see the Wallet module / an upgrade banner appears | Plan not enabled for Wallet | Upgrade to a paid plan (Matrix or higher) |
| I paid but the balance didn't increase | Top-up not synced | Click "Sync" in the Wallet header |
| The bot doesn't send WhatsApp templates | Balance depleted | Top up the Wallet |
| A red "low balance" banner appears | Balance below the threshold | Top up before it runs out to avoid interrupting template sending |