---
title: "create credit note · RUAL Documentation"
description: "Credits a customer against an invoice : the accounting way to give a subscriber a month back without refunding their card. credit_balance (the default)…"
canonical: https://docs.rual.nl/block-types/stripe/stripeconnection_credit_notes_create
language: en
---

# create credit note

This block is part of the [`stripe`](https://docs.rual.nl/block-types/stripe) group and was last modified in core [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

Credits a customer against an **invoice** : the accounting way to give a subscriber a month back without refunding their card. `credit_balance` (the default) puts the amount on their Stripe balance so it comes off their next invoice; `refund` also sends the money back; `out_of_band` just records that you settled it elsewhere. The invoice id comes off **get subscription** as `latest invoice id`, or off **list invoices**.

- flow `flow`

- connection required `stripeconnection`

- invoice id required `value` in_… : must be an `open` or `paid` invoice.

- amount required `number` In the smallest currency unit. Cannot exceed what the invoice was for, less anything already credited.

- credit type `value` `credit_balance` applies it to the next invoice, `refund` sends the money back too, `out_of_band` records a settlement made elsewhere. • Suggestions: `credit_balance` `refund` `out_of_band`

Default `credit_balance`

- reason `value` `duplicate`, `fraudulent`, `order_change` or `product_unsatisfactory`. • Suggestions: `duplicate` `fraudulent` `order_change` `product_unsatisfactory`

- memo `value` A note printed on the credit note the customer sees.

- email customer `boolean` Have Stripe email the credit note to the customer.

- meta data `object`

- idempotency key `value` Optional. Reusing a key makes Stripe replay the first response instead of creating a second object : wire something stable per order, like the order GUID.

- flow `flow`

- connection `stripeconnection`

- credit note id `value`

- number `value` The human-readable credit note number, for your own bookkeeping.

- status `value` `issued` or `void`.

- amount `number`

- currency `value`

- customer id `value`

- invoice id `value`

- pdf url `value` Stripe's hosted PDF of the credit note.

- meta data `object`

- credit note `object`

- success `condition`

- error `value` Stripe's own message, or a sentinel like MISSING_SESSION_ID for a problem in the wiring.

- error code `value` Stripe's machine-readable code, e.g. `card_declined`, `resource_missing`.

- decline code `value` Why the bank refused, e.g. `insufficient_funds`. Only set on a declined card.

| `credit subscription` |
| --- |
| `credit note` |
| `credit customer` |
| `invoice credit` |
| `goodwill` |

### Version history

Introduced in [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

### Service documentation