> For the complete documentation index, see [llms.txt](https://docs.omypayments.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omypayments.com/getting-started/markdown/balance-notifications.md).

# Balance Notifications

Keep your **address-flow** wallets topped up and avoid payment failures by letting our Telegram bot watch your native-currency balances for you.

Merchants that use **address flow** (a dedicated pool of deposit addresses) must always hold enough native currency (e.g., ETH, BTC, MATIC) to cover miner fees and on-chain actions. Our **Omy Payments Liquidity Bot** sends an alert as soon as any address-pool balance drops below the minimum we enforce, so you can refill in time.

#### 1. Prerequisites

| Requirement              | Details                                                                                                       |
| ------------------------ | ------------------------------------------------------------------------------------------------------------- |
| **Address-flow enabled** | Address flow is provisioned manually. Contact **OMY Payments support** to have it activated for your account. |
| **Telegram account**     | You’ll set up a private group in Telegram.                                                                    |
| **Dashboard access**     | Permissions to edit **Account → Notifications** in the OMY dashboard.                                         |

#### 2. One-time setup (≈ 3 min)

1. **Create a private group** in Telegram (⋯ → *New Group*).
2. **Invite the bot**: `@omypayments_liquid_bot` (display name *OmyPaymentsLiquidityBot*).
3. **Find the group ID**
   * Send `/start` to the group.
   * Add the `@getmyid_bot` to the group.
   * Copy the numeric `-100xxxxxxxxxx` ID.
4. **Save the ID in your dashboard**
   * Go to **Account → Notifications → Balance alerts**.
   * Paste the group ID and click **Save**.

That’s it—no extra API keys or webhooks required.

**Notification example:**

`ALERT!` \
`Payment address (hot) balance is 0.000077655418896013 BNB (0.05 USD)`\
`Minimum recommendation balance: 0.029338571071720820 BNB (20 USD)`\
`Address: 0x0000`