Skip to main content
Schema2020-08-27object

credit_note

Issue a credit note to adjust an invoice's amount after the invoice is finalized. Related guide: [Credit Notes](https://stripe.com/docs/billing/invoices/credit-notes).

Source
openapi/spec3.json
Commit
d70de345383d
Active snapshot
da69df7e6e11

CreditNote

object

Issue a credit note to adjust an invoice's amount after the invoice is finalized. Related guide: [Credit Notes](https://stripe.com/docs/billing/invoices/credit-notes).

amount integer
required

The integer amount in %s representing the total amount of the credit note, including tax.

created integer (unix-time)
required

Time at which the object was created. Measured in seconds since the Unix epoch.

currency string
required

Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).

customer
required

ID of the customer.

customer_balance_transaction
optionalnullable

Customer balance transaction related to this credit note.

discount_amount integer
required

The integer amount in %s representing the total amount of discount that was credited.

discount_amounts array
required

The aggregate amounts calculated per discount for all line items.

id string
required

Unique identifier for the object.

invoice
required

ID of the invoice.

livemode boolean
required

Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

memo string
optionalnullable

Customer-facing text that appears on the credit note PDF.

metadata object
optionalnullable

Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

number string
required

A unique number that identifies this particular credit note and appears on the PDF of the credit note and its associated invoice.

object string
required

String representing the object's type. Objects of the same type share the same value.

out_of_band_amount integer
optionalnullable

Amount that was credited outside of Stripe.

pdf string
required

The link to download the PDF of the credit note.

reason string
optionalnullable

Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory`

refund
optionalnullable

Refund related to this credit note.

status string
required

Status of this credit note, one of `issued` or `void`. Learn more about [voiding credit notes](https://stripe.com/docs/billing/invoices/credit-notes#voiding).

subtotal integer
required

The integer amount in %s representing the amount of the credit note, excluding tax and invoice level discounts.

tax_amounts array
required

The aggregate amounts calculated per tax rate for all line items.

total integer
required

The integer amount in %s representing the total amount of the credit note, including tax and all discount.

type string
required

Type of this credit note, one of `pre_payment` or `post_payment`. A `pre_payment` credit note means it was issued when the invoice was open. A `post_payment` credit note means it was issued when the invoice was paid.

voided_at integer (unix-time)
optionalnullable

The time that the credit note was voided.