# LimeChat Wallet

### <mark style="color:green;">1) What is Wallet?</mark>

Wallet is a **prepaid balance** that LimeChat uses to deduct WhatsApp usage charges automatically. It helps you:

* maintain a prepaid balance for messaging
* run broadcasts without manual billing steps
* track deductions through UI and downloadable reports

> **Important:** Wallet billing follows **Meta’s WhatsApp pricing rules** (category + recipient market, billable status logic). LimeChat uses Meta’s rules directly for charging.

### <mark style="color:green;">LimeCoins (Wallet unit)</mark>

**LimeCoins** are the unit shown in the Wallet UI. They represent the **usable balance available for WhatsApp messaging charges** inside LimeChat.

Why LimeCoins:

* LimeCoins provide a consistent internal unit for wallet usage and reporting.
* All deductions and usage views within LimeChat are shown in LimeCoins.

### <mark style="color:green;">2) Wallet setup</mark>

To enable billing via Wallet, go to **Wallet** → click **Initiate Wallet**.

You will be asked for:

* **Email** (used for payment links/invoices)
* **Phone number** (used for payment communications)

Once initiated, your wallet becomes active and ready for recharges.

All the concerned communications will be done on the defined Email and Phone Number.

<figure><img src="/files/EWYpJT4Rs5GaPnLvCNTI" alt=""><figcaption></figcaption></figure>

### <mark style="color:green;">3) Adding funds</mark>

#### 3.1 Recharge flow

1. Open **Wallet**
2. Click **Add Funds**
3. Enter the amount
4. Complete payment on the redirected payment page
5. After a successful payment, your **wallet balance updates automatically**

<figure><img src="/files/pQ0BzjkVI5q8BAAsYEsg" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/PKA8fjAHfSP5yqoQwNVL" alt=""><figcaption></figcaption></figure>

#### 3.2 When you’ll see the prompt

If your wallet balance is low (or zero), LimeChat will show a **low-balance banner** on the wallet page with an **Add Funds** option.

#### 3.3 How balance is reflected

Wallet balance is shown in **LimeCoins** (the wallet unit displayed in the UI).\
You can track all recharges and deductions in **Transaction History**.

#### 3.4 Taxes (GST)

All wallet recharges are subject to **18% GST** (as applicable). This will be reflected as part of the overall billing/recharge computation.

####

### <mark style="color:green;">4) How deductions happen (WhatsApp usage)</mark>

#### 4.1 What usage is deducted from Wallet

Wallet deductions apply to WhatsApp message usage, including:

* **Broadcast messages** (templates)
* **Automation flow messages** (templates)
* **Agent-sent WhatsApp messages** (where templates apply)

#### 4.2 How we calculate charges

Charges are calculated based on **Meta’s pricing rules** (category + recipient market + billable conditions). LimeChat uses Meta’s APIs directly for these calculations.

#### 4.3 Deduction frequency

Wallet deductions are **aggregated and deducted hourly** (not in real-time per message), for broadcasts deductions are done as the broadcast is triggered.

#### 4.4 Usage visibility (UI + reports)

You will have:

* a **Credit History table in the UI** to view deductions and usage summary, and
* a **downloadable report** for deeper breakdown and reconciliation (ledger-style view).

<figure><img src="/files/oF1achE6s02DSjHYpT7L" alt=""><figcaption><p><strong>Credit History</strong></p></figcaption></figure>

### <mark style="color:green;">5) Broadcast billing (Instant vs Scheduled)</mark>

Broadcasts can be run:

* **Instant** (send now)
* **Scheduled** (send at a later time)

**Important rule:**\
Whether you schedule the broadcast or send it right away, you must have the **required wallet balance at the time of setup/publish** (so the broadcast cost can be validated and reserved).

<figure><img src="/files/ELuCPu7yHsqUZ4DHDNzw" alt=""><figcaption></figcaption></figure>

### <mark style="color:green;">6) Instant Broadcast</mark>

#### 6.1 Before publishing: cost estimation + wallet check

When you create an instant broadcast, LimeChat estimates the cost before publishing.

At publish time:

* we calculate an **estimated broadcast cost**
* we check your **wallet balance**
* if balance is sufficient, you can publish the broadcast

> Once an instant broadcast starts, it will complete. We do not stop a broadcast mid-run.

#### 6.2 Audience selection: Segment vs CSV

You can create broadcasts using either:

* **Segments** (audience defined by filters/rules)
* **CSV Upload** (audience uploaded by you)

Both methods follow the same wallet logic; only estimation differs.

### <mark style="color:green;">7) Broadcast with Segments (How estimation works)</mark>

When using a segment:

1. You select the segment
2. LimeChat estimates:
   * expected audience size
   * estimated cost

**Estimation behavior:**

* If estimation completes quickly, you’ll see the estimated cost before publishing.
* If estimation takes longer, LimeChat may ask you to input an approximate audience size so you can proceed without waiting.

### <mark style="color:green;">8) Broadcast with CSV (How estimation works)</mark>

When using CSV upload:

1. You upload the CSV
2. LimeChat computes the number of valid recipients
3. Estimated cost is calculated using:
   * number of recipients
   * template category
   * expected billable messages

### <mark style="color:green;">9) Scheduled Broadcasts</mark>

Scheduled broadcasts add one extra step because the audience can change over time.

#### 9.1 What happens at trigger time

When a scheduled broadcast is about to start, LimeChat:

1. **Freezes the audience** (segment is locked to a fixed list)
2. Computes the final **estimated cost**
3. Checks your wallet balance again (safety check)

#### 9.2 If wallet balance is low at trigger time

If your wallet balance is insufficient at trigger time, the **entire scheduled broadcast fails**.\
There is no partial send.

#### 9.3 How to retrigger a failed scheduled broadcast

To send it again:

1. Add Funds to the wallet
2. Open the failed broadcast
3. Re-trigger it as a fresh broadcast (you don’t need to rebuild the flow again)

### <mark style="color:green;">10) Wallet deductions for Automations & Agent Messaging</mark>

#### 10.1 Automation flows (template sends)

If your automation sends WhatsApp templates (e.g., abandoned cart, order updates), those sends are:

* priced as per Meta rules
* included in hourly wallet deductions
* visible in the Usage table and downloadable report

#### 10.2 Agent messages (human sends)

When an agent sends WhatsApp messages that require templates (based on WhatsApp policy/window), those are:

* priced as per Meta rules
* deducted from wallet in hourly cycles
* visible in usage views and reports

### <mark style="color:green;">11) What you can monitor</mark>

From Wallet + reports, you can track:

* current wallet balance (LimeCoins)
* **Transaction History** (recharges)
* **Usage table** (usage + deductions)
* downloadable report (ledger-style breakdown)
* broadcast-specific spend (by campaign)
* automation spend vs agent spend


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://limechatai.gitbook.io/limechat-product-guide/helpdesk/limechat-wallet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.