> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trypopcorn.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Plans and credits

> Popcorn's plans, what a credit is, what uses credits, what happens when they run out, and how the Billing and usage page is laid out.

Popcorn charges a monthly plan that includes a fixed number of credits, plus any extra credits you buy. Credits pay for what your AI agent and your campaigns send. Your plan, balance and payments live on the **Billing and usage** page.

## Open the billing page

Open the workspace menu at the top of the sidebar and choose **Plan and billing**, or click the credits shown under your agent in the sidebar ("Credits", with how many are left). The sidebar only shows these to roles that can open Billing; see [Who can see Billing](#who-can-see-billing).

## What the page shows

On a paid plan the title carries a badge with your plan name, and the top right has **Manage billing** (opens Stripe's billing portal) and **Credit usage** (see [Credit usage](https://docs.trypopcorn.ai/billing/credit-usage.md)). Under it:

| Part | What it shows |
| - | - |
| **Plan** | Your plan's name and price, for example "USD 299.00 a month, billed monthly". Once the plan has ended, "Ended on" and the date instead of the price |
| **Credits left** | Credits remaining across all pools, with "of N" for the total |
| **Extra credits** | Only when you hold bought or added credits: how many are left, with "of N" |
| **Renews on** | When the plan renews. Left out when the date is unknown or already past, or once the plan has ended |
| **Credits** | A **Credits used** meter ("used / total"), plus one meter per pool when you hold more than one |
| **Automatic top-up**, **Early renewal**, **Buy credits**, **Payment method**, **Billing email** | Covered in [Top-ups, plan changes and renewal](https://docs.trypopcorn.ai/billing/top-ups-and-renewal.md) |
| **Credit costs** | A short panel with the per-message rates; see [What uses credits](#what-uses-credits) |
| **Billing history** and **Change plan** | Your invoices, and the plan list |

The **Credits** meter changes colour as credits run down. It turns amber when a quarter or less is left, with the hint "Credits are running low. Buy more or turn on automatic top-up." It turns red when none are left: "You're out of credits, so your team answers every conversation." Otherwise the hint is "Renews on" and the date. When a plan billed through Zid has ended, the hint reads "Your plan has ended, so your agent isn't replying to customers. Renew it to turn your agent back on."

> [!NOTE]
>
> The free plan shows a shorter page: a **Credit usage** button and the plan list, described as "Each plan includes monthly credits. You can buy extra credits once you're on a plan." There is no balance, **Manage billing** or **Buy credits** until you subscribe. Your free credits show in the sidebar.

## Plans

The plan list is titled **Change plan** on a paid plan and **Plans** on the free plan. Each plan is billed monthly and adds its credits at the start of every billing period.

| Plan | Credits per month | Monthly price | Listed features |
| - | - | - | - |
| **Cheese** | 4,000 | USD 299 | Multiple agents, WhatsApp integration, Marketing campaigns, E-commerce integrations |
| **Caramel 10K** | 10,000 | USD 599 | Everything in Cheese, Advanced analytics, Priority support |
| **Caramel 20K** | 20,000 | USD 999 | Everything in Cheese, Advanced analytics, Dedicated account manager |
| **Caramel 40K** | 40,000 | USD 1,699 | Everything in Cheese, Advanced analytics, Dedicated account manager |

Your current plan is marked **Current**; the others show **Upgrade** or **Downgrade**. See [Top-ups, plan changes and renewal](https://docs.trypopcorn.ai/billing/top-ups-and-renewal.md#change-your-plan) for what happens when you switch.

The public pricing page (trypopcorn.ai/pricing) also lists a **Plain** plan with 2,000 credits a month, Caramel tiers up to 60,000 credits, annual billing at a lower monthly price, and **Enterprise** with custom pricing. Those are not selectable on the Billing page.

### The free plan

A new workspace starts on the free plan with 100 free credits, which expire one month after the workspace is created. To keep your agent replying after that, choose a plan.

## What a credit is

A credit is the unit Popcorn deducts for agent replies and campaign messages. Your balance is made of up to three pools:

| Pool | Where it comes from | When it expires |
| - | - | - |
| **Free credits** | The 100 credits granted when the workspace is created | One month after creation. They are not renewed |
| **Plan credits** | Your plan's monthly allowance, added at the start of each billing period | At the end of the billing period; for a Zid plan, when Zid suspends it (at most two days later). Unused plan credits do not roll over |
| **Extra credits** | Credits you buy, automatic top-ups, and credits added by the Popcorn team | Bought credits and automatic top-ups expire one year after they are added |

Popcorn spends free credits first, then plan credits, then extra credits. Campaign refunds go back to the pool they were taken from.

## What uses credits

| Action | Cost | When it is charged |
| - | - | - |
| Agent reply in a conversation (WhatsApp or Website chat) | 1 credit per reply | When the agent starts answering a customer message. One credit covers everything the agent sends in a single reply, even when a long reply is split into several WhatsApp messages |
| Campaign message | 1 credit per 10 messages | Reserved when you launch or schedule the campaign, from the audience size. When the campaign finishes or is stopped, the cost is recalculated from messages actually sent and the difference is refunded |
| Automated campaign message | 1 credit per 5 messages | Charged after messages are sent successfully, in whole credits as sends add up |

The **Credit costs** panel on Billing lists three rows: "Template messages and agent replies" at "1 credit per message", "Bulk campaigns" at "1 credit per 10 messages" and "Automated campaigns" at "1 credit per 5 messages". Read the first row as one credit per agent reply, as in the table above. Messages your team sends from the Inbox, including templates sent one by one, do not use credits.

Messages that fail to send are not charged: campaigns are settled on messages that reached WhatsApp, and automated campaigns only count successful sends.

Test chats from Home and setup are free. A chat you start from **Try your agent** on Home, or from the agent step of setup, is a test conversation. It uses no credits and stays in **Test conversations** in the [Inbox](https://docs.trypopcorn.ai/inbox/overview.md). If your workspace has no credits left, the agent stays quiet in a test chat, as it does for a customer. Chats in the **Test your agent** panel of the agent editor and on the sandbox WhatsApp number are charged like any other agent reply.

## What happens when credits run out

When your total balance across all pools reaches zero:

* The agent stops replying. Each new customer message is handed over to your team: the conversation lands in **Needs you** with "Your agent is out of credits, so it isn't replying". An admin (or the only member) gets a **Conversation Handover - Credits Exhausted** notification in the app, and the agent's Slack or email handover notifications fire if they are set up.
* A banner appears across the app: **Your agent stopped replying to customers**, with "You're out of credits, so your team answers every conversation until you top up." Its button reads **Top up credits** (opens Billing at **Buy credits**) on a paid plan and **Choose a plan** on the free plan. Roles that can't open Billing see "Ask your account owner or an admin to top up." instead of a button.
* The agent card in the sidebar reads **Stopped, out of credits**.
* Campaigns cannot be launched, because the credits for the audience cannot be reserved.
* Automated campaigns keep running, but their messages are not sent and appear in the campaign's results as **Not sent: out of credits**.

The agent resumes automatically once credits are available again, whether from a purchase, an automatic top-up or your next plan renewal.

> [!TIP]
>
> Popcorn emails the workspace Owner when usage crosses 50%, 80% and 95% of the credits allocated for the period (subject: **Popcorn AI: Your organization has reached 80% usage threshold**, for example) and again when credits are exhausted (**Popcorn AI: Your organization has exhausted its credits**). Each alert is sent once, and can be sent again after a renewal or top-up brings usage back down. Turn on automatic top-up to avoid the interruption; see [Top-ups, plan changes and renewal](https://docs.trypopcorn.ai/billing/top-ups-and-renewal.md).

## When a Zid plan ends

This applies only to plans billed through the Zid App Market. When Zid suspends your plan at the end of a period (Zid then shows the app as Not Activated), the plan has ended and your agent stops answering customers, even if you still hold credits, extra credits included:

* Conversations still with the agent show "Your plan has ended, so your agent isn't replying". Each new customer message is handed to your team and lands in **Needs you**, and the conversation reads "Your plan ended, so *agent* handed this to your team". An admin (or the only member) gets a **Conversation Handover - Plan Ended** notification in the app, and the agent's Slack or email handover notifications fire if they are set up.
* The agent card in the sidebar reads **Stopped, plan ended**.
* The banner **Your plan has expired** appears, and on the Billing page **Plan** reads "Ended on" and the date.
* The period's plan credits stop at the suspension. Extra credits are kept for when the plan is back.

Renew in the Zid App Market to turn the agent back on. If you don't, Zid removes the app five days after the end date and Popcorn removes the plan; the agent stays stopped until you subscribe again. See [Renewal](https://docs.trypopcorn.ai/billing/top-ups-and-renewal.md#renewal).

## How you are billed

Where you subscribed determines where your plan is managed. Extra credits are always bought by card on the Billing page, whichever way your plan is billed.

### Directly, by card (Stripe)

Choosing a plan on the Billing page opens Stripe to complete the subscription. The plan activates, and its credits are added, when Stripe confirms the payment. From then on:

* **Manage billing** and **Update payment method** open Stripe's billing portal for your account.
* Invoices appear under **Billing history**.
* The subscription renews monthly on the same date. **Renews on** shows the next date.

### Through the Zid App Market

Subscribe to Popcorn in the Zid App Market and connect your Zid store in **Integrations**. The plan is applied to your workspace once the store is linked; if you subscribed before connecting, Popcorn applies the subscription as soon as the connection completes. Popcorn's Cheese plan is offered on Zid monthly or yearly, and plan credits are added for each subscription period Zid reports.

When a Zid period ends without a renewal, Zid suspends the plan, usually within a day of the end date. Until then your plan and its remaining plan credits keep working, for at most two days past the end date. The suspension ends the plan and stops your agent; see [When a Zid plan ends](#when-a-zid-plan-ends) and, for renewals, [Top-ups, plan changes and renewal](https://docs.trypopcorn.ai/billing/top-ups-and-renewal.md#renewal).

### Through the Salla App Store

Subscribe to Popcorn in the Salla App Store with your Salla store connected in **Integrations**. Subscription starts, renewals and trials from Salla activate the plan and add its credits for the period Salla reports; cancellations and expiries (including an expired trial) remove the plan immediately.

> [!WARNING]
>
> If your plan is billed through Zid or Salla, change or cancel it in that app store. The **Upgrade** and **Downgrade** buttons on the Billing page create a separate card subscription with Stripe, which would bill you twice.

## Who can see Billing

**Plan and billing** appears for Owners, Admins and Managers. Only Owners and Admins can change anything: buy credits, change the plan, turn on automatic top-up, set the billing email, or open the billing portal. Managers can view the page and [Credit usage](https://docs.trypopcorn.ai/billing/credit-usage.md). Agents and Viewers do not see it. See [Team and roles](https://docs.trypopcorn.ai/settings/team-and-roles.md).

## Related

> [card] [Credit usage](https://docs.trypopcorn.ai/billing/credit-usage.md)
>
> See where credits went, by source and per conversation or campaign.

> [card] [Top-ups, plan changes and renewal](https://docs.trypopcorn.ai/billing/top-ups-and-renewal.md)
>
> Buy credits, set up automatic top-up, renew early, and change plans.

> [card] [Campaign credits and delivery](https://docs.trypopcorn.ai/campaigns/delivery-and-reachability.md)
>
> How campaign statuses and failed messages relate to what you pay.

> [card] [Automated campaigns](https://docs.trypopcorn.ai/campaigns/automated-campaigns.md)
>
> Why automated messages were not sent, including when credits ran out.


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