# Update a credit note

> PATCH /transactions/{transaction_id}

Source: https://docs.trykintsugi.com/reference/2026-07-21/update-a-credit-note

PATCH /transactions/{transaction_id}

Update a credit note

Update an existing credit note (a transaction whose `type` is `FULL_CREDIT_NOTE` or `PARTIAL_CREDIT_NOTE`). A true partial update: every field — `externalId`, `date`, `totalAmount`, `currency`, `description`, `marketplace`, `status` and `items` — is optional, and one you omit keeps the credit note's current stored value rather than being reset to a default. Send `status` as `CANCELLED` to reverse the credit note without deleting it; omitted, it stays whatever it already is (it does NOT default to `COMMITTED`). Calling this on a transaction that is not a credit note answers `400`; on one already `CANCELLED` also answers `400`. A locked or already-filed credit note answers `409`. Updating a credit note you do not own answers `404`, identical to one that does not exist. `PUT /transactions/{transactionId}` amends an ordinary transaction; it does not accept a credit note.

Category: Transactions

Path parameters:
transaction_id (string, required) - The unique identifier of the credit note to update.

Request body:
externalId (string) - Your stable identifier for the credit note. Omit to keep the stored one.
date (string) - When the credit note was issued. Omit to keep the stored date.
status (string) - Lifecycle state of the credit note. Send `CANCELLED` to reverse it without deleting it; amounts and lines are otherwise unaffected. Omit to keep the current status — it does NOT default to `COMMITTED`.
  allowed values: PENDING, COMMITTED, CANCELLED
currency (CurrencyEnum) - ISO-4217 currency of every amount sent. Omit to keep the stored currency.
  allowed values: AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD (and 150 more, see the reference page)
totalAmount (string) - Total credit note amount. Omit to keep the stored amount — there is no default of `0.00`.
description (string) - Free-text description of the credit note. Omit to keep the stored description.
marketplace (boolean) - True for a marketplace or reseller credit note. Omit to keep the credit note's current marketplace flag.
items (TransactionItemWrite[]) - Lines to credit. Each must carry the `externalId` of the original sale's line it reverses, exactly like the credit-note create. Omit to keep the credit note's stored lines.
  externalProductId (string, required) - Your identifier for the product on this line.
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt