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

# Billing

> Pay for sponsorship with a saved card, and cap your monthly spend

Sponsorship is pay-as-you-go: your users' fees are sponsored as they happen, and Rhinestone invoices your organization once a month for what it used, charged automatically to a card you save in the dashboard.

Billing is organization-wide — every project in your organization shares one card, one invoice, and one usage limit. Everything lives in the [Dashboard](https://dashboard.rhinestone.dev) under **Settings → Sponsorship**.

## Saving a card

Owners and admins press **Save card**, enter their card details in the hosted Stripe form, and submit. Submitting authorizes Rhinestone to charge that card automatically once a month for that month's sponsorship usage — there is no separate consent step.

<Frame>
  <img src="https://mintcdn.com/rhinestone/WLCLr9EDLmgSvAE_/images/dashboard/sponsorship/card-billing.png?fit=max&auto=format&n=WLCLr9EDLmgSvAE_&q=85&s=292d266f75e38508ba9409d21ae9d9f4" width="2880" height="1800" data-path="images/dashboard/sponsorship/card-billing.png" />
</Frame>

The card shows as **Ready** once the setup is confirmed. If the confirmation is still settling, the panel says the card was submitted and setup is processing, with a **Check again** action.

Other roles see the card state read-only.

## Invoices and payment history

Your organization gets one invoice per calendar month. Press **Manage** to open the billing portal in a new tab, where you can download past invoices and update the card on file.

<Note>Every organization admin is emailed when an invoice is ready, and when a payment needs attention — a failed charge, or a bank asking to authenticate the payment.</Note>

## Accrued usage this period

The **Accrued sponsorship usage** panel shows gross usage for the current billing period, labeled with the period's dates. **Show usage details** reveals the breakdown: **Sponsored gas**, **Bridge fees**, **Swap fees** and **Protocol fees**.

<Frame>
  <img src="https://mintcdn.com/rhinestone/WLCLr9EDLmgSvAE_/images/dashboard/sponsorship/usage.png?fit=max&auto=format&n=WLCLr9EDLmgSvAE_&q=85&s=c068b34e59987855fafab8d762d80dad" width="2880" height="1800" data-path="images/dashboard/sponsorship/usage.png" />
</Frame>

<Note>Gross usage is informational, not an estimate of the final invoice amount: credits are applied when the invoice closes.</Note>

## Monthly usage limit

The **Monthly usage limit** panel is an optional organization-wide hard cap on sponsored spend for the **UTC calendar month** — a different window from the billing period above. It shows **Month-to-date spend** and **Monthly limit**; the limit reads `Unlimited` when no limit is set.

Owners and admins press **Edit** to set, change, or unset the limit.

<Frame>
  <img src="https://mintcdn.com/rhinestone/WLCLr9EDLmgSvAE_/images/dashboard/sponsorship/usage-limit.png?fit=max&auto=format&n=WLCLr9EDLmgSvAE_&q=85&s=1f708f67f17705da4a1f34abd186fde0" width="2880" height="1800" data-path="images/dashboard/sponsorship/usage-limit.png" />
</Frame>

<Warning>The cap is hard, not advisory. Setting a limit at or below current month-to-date spend makes subsequent sponsored work refuse immediately — your users then pay their own fees, so their intents keep working.</Warning>

### Limit alerts

When a limit is set, Rhinestone emails your organization admins at 90%, 95%, and 99% of it, once per threshold per calendar month. No limit means no alerts.

## Sponsorship credits

Credits appear as **Available credits** and are shared by every project in your organization. They are consumed before anything becomes billable, so an invoice only charges what they didn't cover.

## Testnets

Testnet sponsorship is free and unmetered: it doesn't accrue usage and doesn't count against the monthly limit. You don't need a card to try sponsorship on testnets.

## Per-project limits vs the monthly cap

The **Per-intent limits** panel under **Spending controls** on the same page is unrelated: it caps per-intent spend for the selected project, on mainnet only. The monthly usage limit caps total sponsored spend across the whole organization for the calendar month.

See [Gas & fee sponsorship](/smart-wallet/gas-sponsorship/overview) for what sponsorship covers and how to enable it in code.
