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

# Billing

> Buy prepaid credits, manage the cards that pay for them, and track purchases and receipts in the console.

Managed Agents uses prepaid credits in US dollars. You buy credits for your tenant from the **Billing** screen, pay by card on Stripe's secure pages, and download a receipt for every purchase.

## Before you begin

* You need the **billing**, **admin**, **owner**, or **primary owner** tenant role. Other roles don't see **Billing**. See [Organizations and roles](/managed-agents/organizations-and-roles).
* Billing is done in the console while you're signed in. Buying credits, reading the balance, and managing cards are console actions, not API-key operations.
* Credits belong to the tenant as a whole, not to one organization.

## Read your balance

Open the [Recursion console](https://recursion.labelbox.com) and click **Billing** in the sidebar. The top of the screen shows:

| Tile               | What it shows                                                            |
| ------------------ | ------------------------------------------------------------------------ |
| **Credit balance** | The credit you have, in US dollars. Purchased credit doesn't expire.     |
| **Payment method** | Your default card's brand, last four digits, and expiry, or **No card**. |

## Buy credits

<Tabs>
  <Tab title="Console">
    1. In **Billing**, click **Buy credits**.
    2. Enter a whole number of dollars in **Amount (USD)**, from $5 to $1,000. The default is \$20.
    3. Click **Buy \$20** (the button shows your amount).
    4. What happens next depends on your card:
       * **With a saved card**, your default card is charged now. You'll see **Payment received**.
       * **Without a saved card**, click **Pay \$20 on Stripe** and enter a card on Stripe's secure invoice page. The card is saved for later purchases.
       * **If your bank asks for confirmation**, finish it on the same Stripe page.
    5. Come back to the console tab. It watches the purchase and updates on its own.
  </Tab>
</Tabs>

**What success means:** the purchase shows **Paid** in **Purchases**, and the credit appears in **Credit balance** within a few seconds. The balance updates only after Stripe confirms the payment, so it can trail the purchase briefly.

Buying is safe to retry. If a purchase's response is lost and you buy the same amount again, you get the same invoice rather than a second charge.

## Cancel an unpaid purchase

If you started a purchase that goes to Stripe's page and you don't want it, click **Cancel purchase** in the drawer before opening Stripe. Closing the drawer any other way leaves the purchase payable from its row with **Pay on Stripe**. An unpaid purchase is canceled automatically about a day after it was created. A purchase that was already charged can't be canceled.

## Manage cards

Payments are card only. You enter card details on Stripe's pages; the console never shows a card field.

| To                                        | Click                                                                          |
| ----------------------------------------- | ------------------------------------------------------------------------------ |
| Add your first card                       | **Add card** on the **Payment method** tile. The new card becomes the default. |
| Change the default, remove, or add cards  | **Manage cards** on the **Payment method** tile.                               |
| Update your billing email or see invoices | **Manage in Stripe** at the top of the screen.                                 |

Stripe opens in a new tab. When you come back, the console refreshes your card. If you remove the default card, your next purchase asks for a card on Stripe's page.

## Track purchases and receipts

**Purchases** lists every purchase, newest first, with its date, credits, and status. A paid purchase has a **Receipt** link to its Stripe invoice.

| Status                 | Meaning                                                                             |
| ---------------------- | ----------------------------------------------------------------------------------- |
| **Pending**            | The purchase was started but not finished. Buy again or wait for it to be canceled. |
| **Awaiting payment**   | Waiting for a card on Stripe's page. Click **Pay on Stripe**.                       |
| **Needs confirmation** | Your bank asked for confirmation. Click **Pay on Stripe** to finish.                |
| **Processing**         | The card was charged. The credit arrives in a moment.                               |
| **Paid**               | The credit was added. The receipt is available.                                     |
| **Declined**           | The card was declined. Nothing retries it.                                          |
| **Canceled**           | The purchase was abandoned or canceled. Nothing was charged.                        |

## What can go wrong

| Message or symptom                                                          | Cause                                                           | Fix                                                                 |
| --------------------------------------------------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------- |
| **Billing** isn't in the sidebar                                            | Your tenant role isn't billing, admin, owner, or primary owner. | Ask an owner or admin to change your role.                          |
| "The card was declined. Replace it in Stripe, then try again."              | The bank declined the charge.                                   | Click **Manage cards**, add or choose another card, then buy again. |
| "Something changed since your last try, such as the saved card. Buy again." | The retry no longer matches the earlier attempt.                | Buy the credits again to start a new purchase.                      |
| **Buy credits** is disabled                                                 | The screen is still loading your card.                          | Wait a moment, or refresh.                                          |
| The amount field shows an error                                             | The amount isn't a whole number from 5 to 1,000.                | Enter a whole-dollar amount in range.                               |
| Paid, but the balance hasn't changed                                        | The credit lands a few seconds after Stripe confirms payment.   | Wait, or come back to the tab to refresh.                           |

## Limits

| Limit           | Value                                      |
| --------------- | ------------------------------------------ |
| One purchase    | $5 to $1,000, whole dollars                |
| Unpaid purchase | Canceled about 24 hours after it's created |

## Next steps

<CardGroup cols={2}>
  <Card title="Usage and cost" href="/managed-agents/usage-and-cost">
    See the model cost of a session or a whole session tree.
  </Card>

  <Card title="Organizations and roles" href="/managed-agents/organizations-and-roles">
    See who can manage billing.
  </Card>

  <Card title="Console" href="/managed-agents/console">
    Find every screen in the console.
  </Card>

  <Card title="Security" href="/managed-agents/security">
    See how payment details and credentials are handled.
  </Card>
</CardGroup>
