> ## Documentation Index
> Fetch the complete documentation index at: https://codebeans-cb-notifylyst.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Billing and credits

> How your plan's allowance and your wallet fit together, topping up, per-country rates, and where the money went.

**Usage** shows your wallet, your plan's allowance, what Shopify bills you, and what you can still
send. Two ideas explain almost everything on it.

![The Usage page: Your wallet with its balance, Your plan with when the allowance resets, Billed by Shopify, and the What you can send table.](https://mintcdn.com/codebeans-cb-notifylyst/helB_Y1ZQRw5r3Uo/images/app-24-billing-overview.png?fit=max\&auto=format\&n=helB_Y1ZQRw5r3Uo\&q=85\&s=a49685b11b768f6e3b1050078c71d131)

## Idea one: plan allowance first, then one wallet

Each cycle your plan includes an allowance of **email & web push** notifications. Every send uses
that first. Past it, sends are paid from your **wallet** — a single dollar balance that pays for
**any** channel: email, web push, SMS and WhatsApp. There is nothing to split between channels in
advance.

| Where it comes from | Behaviour |
| - | - |
| **Plan allowance** | Refilled at the start of each cycle (**Allowance resets**, which is **Not a billing date**). Unused allowance doesn't roll over. |
| **Wallet** | Money you added. Not reset by the cycle; each top-up is valid for a set time (6 months by default). Credit that expires sooner is spent first. |

> [!NOTE]
>
> **Email and web push share one allowance.** Running both doesn't give you twice the capacity.
> SMS and WhatsApp aren't in any plan's allowance — they are always paid from the wallet.

## Idea two: nothing is lost when you run out

When both the allowance and the wallet are used up, alerts **wait** — they aren't dropped and
they aren't charged. Home shows it under **Needs your attention** (for example **SMS alerts are
paused**), the Dashboard shows **N restock alerts are waiting to be sent**, and Usage shows **Sends
are waiting for credit**. As soon as you top up, or a new cycle refills the allowance, the waiting
alerts go out by themselves.

The full story: [Your allowance runs out](https://codebeans-cb-notifylyst.mintlify.site/journeys/merchant-out-of-credit.md).

## What you can send

The table on **Usage** shows each channel's state:

| Status | Meaning |
| - | - |
| **Available** | Allowance or wallet left. |
| **Unlimited** | Your plan has no limit for this channel. |
| **On wallet** | The allowance is used up; sends are paid from the wallet. |
| **Wallet empty** | Nothing left to pay with — sends wait. |
| **Not on your plan** | The channel isn't included. |
| **Setup in progress** | Not available yet — WhatsApp shows this while per-country pricing is finalised. |

## Topping up

**Usage → Add money** (or **Add credits** anywhere in the app) opens **Add credits**:

![The Add credits page with the top-up packages and their bonus credit, How your wallet is spent, and the Order summary.](https://mintcdn.com/codebeans-cb-notifylyst/helB_Y1ZQRw5r3Uo/images/app-25-add-credits.png?fit=max\&auto=format\&n=helB_Y1ZQRw5r3Uo\&q=85\&s=f1acfd003488b441fc0638d3733a0689)

| You pay | You get |
| - | - |
| \$10 | \$10.00 of credit |
| \$25 | $27.00 (+$2 free) |
| \$50 (*Most popular*) | $56.00 (+$6 free) |
| \$100 | $115.00 (+$15 free) |
| \$250 | $300.00 (+$50 free) |
| **Other** | Any whole-dollar amount from $1 to $5,000, no bonus |

Check the **Order summary** — bonus, what is added, wallet after, and **Valid until** — then confirm
**Add \$X to your wallet?** The amount is billed through Shopify as usage on your next Shopify bill;
there is no subscription, and the credit is ready to use the moment it is added. Every top-up shows
in **Usage history** with its Shopify status.

You need an active plan to top up. On a development store Shopify never bills, so top-ups are
capped (the page shows how much is left).

## Per-country rates

SMS and WhatsApp are priced by the shopper's country, and the spread is large. **See SMS and
WhatsApp rates by country** on **Add credits**, or **See rates** on **Usage history**, opens the live
list. Your cost depends on where your *shoppers* are, not where you are.

![The SMS rates by country window listing each country with its price per message.](https://mintcdn.com/codebeans-cb-notifylyst/helB_Y1ZQRw5r3Uo/images/app-26-sms-rates.png?fit=max\&auto=format\&n=helB_Y1ZQRw5r3Uo\&q=85\&s=65623d61b9037ec5a161cccc07bb9364)

## Where the money went

**Usage → Open usage history** is the ledger. The top shows your plan, the day of the cycle, and
your limits (notifications per cycle, message steps, webhook endpoints, AI connector tokens and rate
limit). Under **Activity**, switch between **Plan usage**, **Wallet** and **Purchases**, and filter by
channel, entry type, cycle and date. **Export** emails the list as a CSV.

![Usage history: the plan card with its limits, each channel's status, and the Activity list with Plan usage, Wallet and Purchases.](https://mintcdn.com/codebeans-cb-notifylyst/helB_Y1ZQRw5r3Uo/images/app-27-wallet-history.png?fit=max\&auto=format\&n=helB_Y1ZQRw5r3Uo\&q=85\&s=5675b90cb295e99d371b82404a71b677)

This is the screen that answers "why did this cycle cost more than the last?" Follow-up steps,
report emails and exports are the items that usually surprise people.

## Staying ahead of it

| Habit | Why |
| - | - |
| Check what's left before a big restock | A 2,000-person waiting list is 2,000 sends — 4,000 with a follow-up step. |
| Keep a small wallet balance if you use SMS | No plan includes SMS, so an empty wallet pauses every SMS alert. |
| Read the ledger monthly | You'll spot whether a bigger plan would cost less than paying per send. |

> [!NOTE]
>
> The [AI connector](https://codebeans-cb-notifylyst.mintlify.site/mcp/examples/spend-review.md) can do this review for you — usage, what drove the
> spend, and whether another plan fits better — in one question.

> [card] [Change your plan](https://codebeans-cb-notifylyst.mintlify.site/app/guides/change-your-plan.md)
>
> Next: switching plans.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.