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

# Credits

> How lead credits and AI decision packs work.

## Two separate currencies

Majarrah bills brokers in two independent balances:

<CardGroup cols={2}>
  <Card title="Lead credits" icon="phone">
    Consumed when a buyer reveals your phone number or books a viewing on your listing.
  </Card>

  <Card title="AI decisions" icon="brain">
    Consumed when you or a buyer request an AI decision on one of your listings.
  </Card>
</CardGroup>

They're tracked separately so a burst of AI usage doesn't drain your lead runway, and vice versa.

## Where credits come from

* **Your plan's monthly grant**. Every plan (Basic / Growth / Pro / Agency) includes a fixed monthly allocation, refreshed at the start of your billing cycle.
* **Top-up packs**. When you need more mid-cycle, buy packs of 5 / 20 / 50 credits at any time.
* **Trials and promos**. New workspaces get a starter grant. Ghost-broker claimants inherit a 90-day Pro trial.

## Where credits go

Every debit is logged in **Billing → Ledger** with:

* Timestamp
* Reason (phone reveal, viewing booking, AI decision — with pack type)
* Property + buyer involved
* Balance before and after

If something looks wrong, click **Dispute** on the row and it flags the transaction for support review.

## Refunds

Every AI decision pack ships with a 24-hour refund guarantee. If the pack didn't deliver value:

<Steps>
  <Step title="Open Billing → Packs">
    Find the pack purchase.
  </Step>

  <Step title="Click Request refund within 24 hours">
    Explain briefly what didn't work.
  </Step>

  <Step title="We refund automatically">
    Refunds land back on your payment method within 3-5 business days.
  </Step>
</Steps>

Lead credits are not individually refundable, but if you spot an obvious error (a bot reveal, a fake booking), disputing the ledger row triggers a review.

## Balance alerts

Under **Settings → Notifications**, enable low-balance alerts. You'll get an email + push notification when either balance drops below the threshold you set. Never miss a buyer because you ran out mid-day.

<Note>
  Balances don't expire. Unused credits and decisions roll over month-over-month.
</Note>