Stripe credit note line items accept metadata
Introduced 2026-03-25 · score 0.90
HOW TO USE IT
When creating or previewing a credit note that needs per-line-item data, set `metadata` on each object in `lines`. Retrieve the credit note or its line items to read that metadata.
WHY THIS HELPS
When creating or previewing a credit note and you need per-line-item data for repository billing logic or reporting, attach metadata to each line item.
REQUIREMENTS AND LIMITATIONS
- lines (required): Array of line items making up the credit note; one of `amount`, `lines`, or `shipping_cost` must be provided.
- lines[].metadata: Key-value pairs attached to a credit note line item. Up to 50 keys; key names up to 40 characters and values up to 500 characters.
- invoice (required): ID of the invoice.
- Prerequisite: Create a customer and an invoice before creating or previewing the credit note.
- Metadata can contain up to 50 keys; key names can be up to 40 characters and values up to 500 characters.
FIRST-PARTY EVIDENCE
- https://docs.stripe.com/changelog/dahlia/2026-03-25/adds-metadata-field-to-credit-note-line-items
- https://docs.stripe.com/api/credit_notes/create?api-version=2026-03-25.dahlia
- https://docs.stripe.com/api/credit_notes/line_item?api-version=2026-03-25.dahlia
Check the installed version and the source before using it. Entry JSON