Files
supabase/apps/docs/content/guides/platform/credits.mdx
Kanishk Dudeja ec260a594d docs(billing): clarify top-ups do not apply to outstanding invoices (#48220)
### Summary

This PR clarifies that credit top-ups apply only to future invoices and
cannot be used to pay or adjust outstanding invoices.

It updates the Credits FAQ, Billing FAQ, and credit top-up modal with
consistent wording.

### Testing

#### Credits FAQ


https://docs-git-kanishk-billing-2726-update-billing-fa-bd77f2-supabase.vercel.app/docs/guides/platform/credits#credit-faq

#### Billing FAQ


https://docs-git-kanishk-billing-2726-update-billing-fa-bd77f2-supabase.vercel.app/docs/guides/platform/billing-faq#payments-and-billing-cycle

#### Credit Top Up Modal

<img width="544" height="473" alt="Screenshot 2026-07-23 at 1 17 30 AM"
src="https://github.com/user-attachments/assets/5d016398-7b46-455d-8bf1-a5767d10bc48"
/>


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **Documentation**
* Added FAQ guidance explaining that credit top-ups apply only to future
invoices and cannot pay or adjust outstanding invoices.
* **Billing Updates**
* Clarified that credits are granted based on the pre-tax payment
amount.
  * Confirmed that credits are non-refundable and do not expire.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2026-07-23 01:33:36 +05:30

81 lines
3.1 KiB
Plaintext

---
id: 'credits'
title: 'Credits'
---
## Credit balance
Each organization has a credit balance. Credits are applied to future invoices to reduce the amount due. As long as the credit balance is greater than <Price price="0" />, credits will be used before charging your payment method on file.
<Image
alt="Subscription upgrade modal"
src={{
light: '/docs/img/guides/platform/credit-balance--light.png',
dark: '/docs/img/guides/platform/credit-balance--dark.png',
}}
width={2034}
height={388}
/>
You can find the credit balance on the [organization's billing page](/dashboard/org/_/billing).
### What causes the credit balance to change?
**Subscription plan downgrades:** Upon subscription downgrade, any prepaid subscription fee will be credited back to your organization for unused time in the billing cycle.\
As an example, if you start a Pro Plan subscription on January 1 and downgrade to the Free Plan on January 15, your organization will receive about 50% of the subscription fee as credits for the unused time between January 15 and January 31.
**Credit top-ups:** You self-served a credit top-up or have signed an upfront credits deal with our growth team.
## Credit top-ups
You can top up credits at any time, with a maximum of <Price price="2000" /> per top-up. These credits do not expire and are non-refundable. Credits are granted on the pre-tax amount. Any applicable taxes added at checkout are not credited.
You may want to consider this option to avoid issues with recurring payments, gain more control over how often your credit card is charged, and potentially make things easier for your accounting department.
<Admonition type="note">
If you are interested in larger (> <Price price="2000" />) credit packages, [reach out](/dashboard/support/new?subject=I%20would%20like%20to%20inquire%20about%20larger%20credit%20packages&category=Sales).
</Admonition>
### How to top up credits
1. On the [organization's billing page](/dashboard/org/_/billing), go to section **Credit Balance**
2. Click **Top Up**
3. Choose the amount
4. Choose a payment method or add a new payment method
5. Click **Top Up**
<Image
alt="Subscription upgrade modal"
src={{
light: '/docs/img/guides/platform/credit-top-up--light.png',
dark: '/docs/img/guides/platform/credit-top-up--dark.png',
}}
className="max-w-[500px]"
width={1014}
height={758}
/>
## Credit FAQ
{/* supa-mdx-lint-disable Rule004ExcludeWords */}
### Will I get an invoice for the credits purchase?
Yes, once the payment is confirmed, you will get a matching invoice that can be accessed through your [organization's invoices page](/dashboard/org/_/billing#invoices).
### Can I use a credit top-up to pay an outstanding invoice?
Credit top-ups apply only to future invoices. They cannot be used to pay or adjust outstanding invoices.
### Can I transfer credits to another organization?
Yes, you can transfer credits to another organization. Submit a [support ticket](https://supabase.help).
### Can I get a refund of my unused credits?
No, we do not provide refunds. Please refer to our [Terms of Service](/terms#1-fees).