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

> ## Agent Instructions
> Prefer the qBraid CLI for programmatic platform actions: pip install 'qbraid-cli>=0.12', then run `qbraid configure` once with an API key from https://account.qbraid.com/account/api-keys.
> Always install the latest packages (pip install -U qbraid qbraid-cli); do not pin versions from memory. qbraid-cli below 0.12.0 is incompatible with the current API.
> Device IDs use the QRN format vendor:provider:type:name (e.g. qbraid:qbraid:sim:qir-sv, rigetti:rigetti:qpu:cepheus-1-108q). Legacy underscore IDs are deprecated.
> The REST API base URL is https://api-v2.qbraid.com/api/v1, authenticated with an X-API-Key header.
> Free simulators cost no credits; QPU and GPU jobs consume credits. Surface the estimated cost to the user before submitting a paid job.
> For account signup, API keys, credits, and end-to-end action recipes, see https://qbraid.com/llms.txt.

# Buy Credits

> Top up your credit balance with a preset or custom amount, and apply a promo code at checkout.

You can buy credits any time as a one-time top-up. They're priced at $0.01 per credit and work across every pay-as-you-go resource on qBraid.

<Warning>
  Buying credits is only available in your **qBraid Default** workspace (the
  default). If you're working inside an organization, the Buy credits section is
  hidden and you'll see a [Request
  credits](https://docs-v2-staging.qbraid.com/v2/account/organizations/credit-requests) button instead. Org admins
  buy credits for the team from [Organizations >
  Credits](https://docs-v2-staging.qbraid.com/v2/account/organizations/credits#buy-credits-for-the-org).
</Warning>

## How to buy

<Steps>
  <Step title="Switch to qBraid Default">
    Open the workspace switcher in the top-left of the dashboard and select
    **qBraid Default**.
  </Step>
  <Step title="Open Wallet">
    Click **Account > Wallet** in the sidebar, or open
    [account.qbraid.com/account/wallet](https://account.qbraid.com/account/wallet)
    directly.
  </Step>
  <Step title="Scroll to Buy credits">
    The section sits below the Credits Overview card.
  </Step>
  <Step title="Pick an amount">
    Click a preset card, or type a dollar amount in **Custom**. The credit count
    updates as you type.
  </Step>
  <Step title="Add a promo code (optional)">
    Drop the code into the field next to **Purchase**.
  </Step>
  <Step title="Click Purchase">Stripe handles checkout in a new tab.</Step>
</Steps>

<Check>
  When you come back to the wallet, the credits are already in your balance.
</Check>

<Frame>
  <video
    src="https://storage.googleapis.com/qbraid-static-assets/qbraid-docs/wallet/buy-credits.mp4"
    autoPlay
    muted
    loop
    playsInline
    aria-label="Buying credits"
  />
</Frame>

<Tip>
  The exchange rate (like `$1 = 100 credits`) appears next to the **Buy
  credits** heading. If qBraid changes the rate later, credits you already own
  keep their original value.
</Tip>

## Apply a promo code on the wallet

<Steps>
  <Step title="Switch to qBraid Default">
    Open the workspace switcher and select **qBraid Default**.
  </Step>
  <Step title="Open Wallet">Click **Account > Wallet** in the sidebar.</Step>
  <Step title="Scroll to Buy credits">
    Pick a preset or enter a custom amount.
  </Step>
  <Step title="Type the code">
    Drop it in the **Promo code** field next to **Purchase**.
  </Step>
  <Step title="Click Purchase">Stripe applies the discount at checkout.</Step>
</Steps>

## Apply a promo code on Stripe Checkout

<Steps>
  <Step title="Start a purchase">
    Follow the steps above without entering a promo code on the wallet.
  </Step>
  <Step title="On Stripe Checkout, click Add promotion code">
    A small text field appears.
  </Step>
  <Step title="Paste the code and click Apply">
    The discount appears on the order summary.
  </Step>
  <Step title="Complete the order">Click **Complete Order**.</Step>
</Steps>

If the discount zeros out your total, the credits land in your wallet right away without a card charge.

<Frame>
  <video
    src="https://storage.googleapis.com/qbraid-static-assets/qbraid-docs/wallet/promo-code.mp4"
    autoPlay
    muted
    loop
    playsInline
    aria-label="Applying a promo code"
  />
</Frame>

## If you can't see the Purchase button

If you joined an organization and don't have purchase permissions, the **Purchase** button is replaced with **Request credits**. See [Credit Requests](https://docs-v2-staging.qbraid.com/v2/account/organizations/credit-requests).

## Outstanding balance

If your usage went past your balance, a red banner appears at the top of the wallet with the amount you owe. Your next purchase covers that first, then any leftover credits get added to your wallet.