Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Billing
    Overview
    About the Billing APIs
    Subscriptions
    Invoicing
      Overview
      API quickstart
      Integrate with the API
      Invoicing without code
        Use the Dashboard
        Manage invoices
        Issue credit notes
      Invoice lifecycle
      Preview invoices
      Edit invoices
      Schedule invoice finalisation
      Status transitions and finalisation
      Send customer emails
      Generate credit notes
      Invoice customers
      Customers
      Customer credit balance
      Customer tax IDs
      Invoice payments
      Hosted Invoice Page
      Create invoice payment plans
      Payment methods for invoices
      Automated collections
      Invoice customisation
      Customise invoices
      Invoice rendering templates
      Group invoice line items
      Summarise line items
      Global invoicing
      Best practices
      Multi-currency customers
      Other invoicing features
      Products and prices
      Manage bulk invoice line items
      Taxes
    Usage-based billing
    Connect and Billing
    Tax and Billing
    Quotes
    Revenue recovery
    Automations
    Scripts
    Revenue recognition
    Customer management
    Entitlements
    Test your integration
Tax
Reporting
Data
Startup incorporation
HomeFinance automationBillingInvoicingInvoicing without code

Issue credit notes

Use the Dashboard to adjust or refund finalized invoices with credit notes.

Copy page

Credit notes are documents that decrease the amount of an open or paid invoice. The difference between issuing a credit note and adjusting the amount of an invoice by revising it is that a credit note doesn’t void and replace the original invoice. Some example scenarios where you might use credit notes include:

  • You accidentally overbilled a customer—You accidentally charged your customer 110 USD instead of 100 USD because of a data entry mistake. Use a credit note to give your customer a 10 USD credit for the overcharge.
  • You’re short on inventory—You billed your customer for five items, but when it’s time to ship them you realize you only have three items left in stock. Use a credit note to refund your customer for the two items they didn’t receive.
  • Discounts – You and your customer negotiate a discount on an invoice. Instead of voiding the invoice and issuing a new one, you can use a credit note to adjust the amount owed on the existing invoice.

A credit note reduces the amount due without recording any payment. However, if a credit note reduces the balance of an open invoice to 0, the invoice status changes to paid. For information on invoice statuses, see the Invoicing overview.

Note

For information about working with credit notes using the API, see Generate credit notes programmatically.

Get started

When you issue a credit note for an open invoice, it decreases the amount due on the invoice. When you issue a credit note for a paid invoice, you credit the customer’s account balance or give them a refund outside Stripe.

The sum of all credit notes issued for an invoice can’t exceed the ​​total amount of the invoice. For a paid invoice, the sum of the refund, credit, and out-of-band payment amounts must equal the credit note total.

When you create a credit note, you can apply credit amounts in three ways:

  • Discount a fixed amount from an invoice line item.
  • Discount a quantity from an invoice line item. The total discount is the discount quantity times the unit price of that line item.
  • Apply a discount to the total invoice amount by adding a custom discount line item with a description, quantity, and unit price. The total discount is the quantity times the unit price.

We recommend discounting invoice line items when possible, because it associates each credit with a line item. Adding a custom discount line item can make reporting and tracking difficult, because the credit isn’t associated with a real invoice line item.

Note

You can’t combine discount types on an invoice line item. For example, if you discount a line item quantity, then a future credit note can only discount that line item by quantity, not by amount. If you discount a line item amount, then a future credit note can only discount that line item by amount, not by quantity.

Create a credit note

You can create credit notes for open or paid invoices.

  1. Open the Invoices page in the Dashboard.

  2. Select the open or paid invoice you want to add a credit note to.

  3. Click More and select Issue a credit note.

  4. Select a reason for the credit note.

  5. (Optional) Perform the following actions:

    • Edit line item credit quantities or amounts.

    • Click Add item to add a custom line item.

    • Click Set item tax to select a tax rate to use for credit purposes.

  6. If the invoice is paid, choose whether to refund the customer’s card, credit their balance, or refund the amount outside of Stripe (for example, cash).

  7. Click Issue credit note to submit the credit note.

Note

Open invoices can’t have a credit note with a pending payment_intent.

Issue a credit note in the Dashboard

Credit balances and discounts

When you issue a credit note on an invoice with an applied customer credit balance, funds are sometimes credited to the credit balance instead of the initial payment method. For example, if a credit balance of 150 USD is applied to an invoice for 200 USD, then the finalised invoice is for 50 USD. If you issue a credit note for 50 USD or less, the funds are refunded to the customer’s payment method. Anything above 50 USD is added to the customer’s credit balance and is applied to the next invoice.

Discounts apply proportionally to all the line items on an invoice. For example, applying a 50% discount to an invoice with 10 line items at 10 USD each changes the amount of each line item to 5 USD. If you then apply a credit note for one line item, it reduces the invoice amount by 5 USD.

Fixed-amount discounts work the same way. If you apply a 10 USD discount to an invoice with 10 line items at 10 USD, each line item is 10% of the sum amount and is discounted by 10% * 10 USD = 1 USD. The amount of each line item becomes 9 USD. If you then apply a credit note for one line item, it reduces the invoice amount by 9 USD.

If you want to credit the original line item amount, you can make up the difference by adding a custom discount line item to the credit note. For example, if a discount reduced a line item’s credit amount from 10 USD to 9 USD, you can add a custom discount line item for 1 USD.

Voiding credit notes

You can void a credit note only if it’s on an open invoice. Voiding a credit note reverses its adjustment, increasing the amount due on the invoice by the amount of the credit note.

To void a credit note in the Dashboard, click the overflow menu () at the top right of the credit note, then select Void credit note.

Crediting negative line items

You can also credit negative invoice line items.

The following restrictions apply:

  • The total amount of the credit note must remain positive.
  • The total amount credited to a negative line item must be negative.
  • The total amount credited to a negative line item can’t be less than the line item amount.

You also can’t credit a negative amount on a custom credit note line item. We only support negative amounts on credit note line items that are tied to invoice line items.

See also

  • Stripe data
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access programme.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc