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

# Understanding Tokens

> Learn how Beat Request tokens work, what each request costs, how refunds and renewals behave, and what happens when your plan changes.

Tokens control how many Beat Requests you can create during the current monthly cycle. Your plan sets the limit, and the request duration decides how many tokens are spent.

***

## How Tokens Work

<CardGroup cols={2}>
  <Card title="Create a Request" icon="plus">
    **24 hours** costs **1 token**, **48 hours** costs **2**, and **72 hours** costs **3**.
  </Card>

  <Card title="Renew an Expired Request" icon="rotate-left">
    Eligible expired requests always cost **1 token** to renew, even if the original request cost more.
  </Card>

  <Card title="Monthly Allowance" icon="coins">
    Your plan decides how many tokens you can hold during the monthly cycle.
  </Card>

  <Card title="Plan Changes" icon="arrows-rotate">
    Starting, resuming, or changing a paid plan resets your balance to that plan's token limit.
  </Card>
</CardGroup>

Unused tokens do not roll forward forever. BeatPass refreshes your balance on the monthly cycle and shows a **reset date** in the token status area.

***

## Token Allowance by Plan

The number of tokens you receive depends on your BeatPass subscription:

| Plan                  | Monthly Tokens |
| --------------------- | -------------- |
| **Explorer** (Free)   | 1              |
| **Classic** (\$29/mo) | 1              |
| **Plus** (\$45/mo)    | 3              |
| **Pro** (\$59/mo)     | 5              |

<Note>
  Your current token balance is shown in the Beat Requests experience, alongside your monthly limit and reset date.
</Note>

***

## Checking Your Token Balance

You can see your current token balance in several places:

1. **Beat Requests Section** — Your balance is displayed prominently
2. **Before Creating a Request** — Shows tokens remaining
3. **After Creating a Request** — Updated balance confirmation

Your token status includes:

* **Current tokens** — How many you have right now
* **Monthly limit** — Your total allowance for the month
* **Used this month** — How many you've already used
* **Reset date** — When your tokens will refresh
* **Days until reset** — How much time is left in the current cycle

***

## Using Tokens

### When Tokens Are Consumed

A token is used when you:

* **Successfully submit** a beat request
* **Renew** an eligible expired request

### When Tokens Are NOT Used

Tokens are not consumed when you:

* Browse other people's requests
* Monitor request counts or notifications
* Start creating a request but don't submit

***

## Getting Tokens Back (Refunds)

You can get tokens refunded by **deleting your request**:

1. Go to your active requests
2. Delete a request you no longer need
3. BeatPass refunds as many tokens as it can without pushing you above your plan limit

The refund amount matches the original cost:

* **24h request** — 1 token refunded
* **48h request** — Up to 2 tokens refunded
* **72h request** — Up to 3 tokens refunded

<Warning>
  Token refunds are capped at your plan's monthly limit. If refunding would push your balance above the cap, only the amount needed to reach the cap is returned.
</Warning>

### Refund Conditions

| Scenario                                   | Tokens Refunded?              |
| ------------------------------------------ | ----------------------------- |
| Delete active request, below cap           | Full cost (1, 2, or 3 tokens) |
| Delete active request, partially below cap | Partial (up to the cap)       |
| Delete expired request                     | No                            |
| Request expires naturally                  | No                            |
| You're at max token limit                  | No (already at cap)           |

<Note>
  When a request is removed by BeatPass on your behalf, the refunded token still goes back to **you**. Tokens are only refunded to the original request owner, and only if your current balance is below your plan's cap.
</Note>

### Staying Under the Cap

* You can never hold more tokens than your plan's monthly allowance (e.g., a 3-token plan will never show 4 tokens)
* Refunds stop once your balance reaches that limit, even if multiple requests are deleted
* Plan changes reset the balance to the new plan limit immediately

***

## Token Reset Cycle

BeatPass refreshes tokens on a **monthly cycle**. Your token status area shows the reset date and how many days remain in the current cycle.

* On reset day, your balance is set back to your plan's full monthly allowance.
* Unused tokens do not carry over — they are replaced by the fresh balance.

### Important Dates

* **Reset date** — Shown in your token status
* **Days until reset** — Also shown in the same status area
* **Unused tokens** — Lost at reset (don't carry over)

<Tip>
  If you have tokens left and know you need more requests this month, use them before the reset date instead of letting them expire.
</Tip>

***

## Running Out of Tokens

If your token balance reaches zero:

1. **You cannot create new requests** until tokens reset
2. **Existing requests continue** as normal
3. **You can still receive submissions** on active requests
4. **Options to get more:**
   * Wait for monthly reset
   * Change to a plan with a higher token allowance
   * Delete an existing request (if below cap)

### What You See

When out of tokens, you'll see a message like:

> "You've used all your tokens for this month. Your tokens will reset on \[date]."

For free users:

> "You've used all your tokens for this month. Upgrade to get more tokens or wait until next month."

***

## Upgrading for More Tokens

If your current token limit is too small for how often you use Beat Requests:

1. Click your **profile avatar** → **Billing**
2. Use **Change plan** to review your options
3. Pick a plan with a higher Beat Request allowance
4. After the change takes effect, BeatPass resets your token balance to the new plan limit

<Info>
  BeatPass does not sell one-off token packs today. Tokens come from your current plan and the monthly reset cycle.
</Info>

***

## Common Questions

<AccordionGroup>
  <Accordion title="Do unused tokens carry over?">
    No. They are replaced by your refreshed monthly balance on the reset cycle.
  </Accordion>

  <Accordion title="What happens if I downgrade my plan?">
    BeatPass resets your token balance to the new plan's allowance when the subscription change is processed.
  </Accordion>

  <Accordion title="Can I buy extra tokens?">
    Currently, tokens are only available through your subscription plan. Upgrading your plan is the way to get more monthly tokens.
  </Accordion>

  <Accordion title="Why wasn't my token refunded when I deleted a request?">
    Tokens are only refunded if you're below your plan's monthly limit. If you're already at the maximum, the system doesn't add extra tokens.
  </Accordion>
</AccordionGroup>

***

## Related Topics

<CardGroup cols={2}>
  <Card title="Creating Requests" icon="plus" href="/help/beat-requests/creating-requests">
    Learn how to use your tokens to create requests.
  </Card>

  <Card title="Plans & Pricing" icon="credit-card" href="/help/plans-and-pricing">
    Compare plans and their token allowances.
  </Card>
</CardGroup>

<Snippet file="sections/need-help.mdx" />
