# Create credit note by transaction id

> POST /v1/transactions/{original_transaction_id}/credit_notes

Source: https://docs.trykintsugi.com/reference/create-credit-note-by-transaction-id

API version: v1 (legacy API)

POST /v1/transactions/{original_transaction_id}/credit_notes

Create credit note by transaction id

Create a new credit note for a specific transaction. Idempotent on ``(organization_id, connection_id, source, external_id)`` for the same parent: a re-POST returns ``200`` with the stored credit note unchanged. The same external id against a different parent still conflicts. Use PUT to update fields.

Category: Transactions

Path parameters:
original_transaction_id (string, required)

Request body:
external_id (string, required) - Unique identifier for the credit note in the external system.
external_friendly_id (string) - Human-readable identifier for the credit note, often used for display purposes.
secondary_external_id (string) - Secondary external identifier, reserved for marketplace/channel source ids (paired with secondary_source).
date (string, required) - Date when the credit note was issued or created.
status (string, required) - Current state of the credit note in its lifecycle.
  allowed values: PENDING, CANCELLED, COMMITTED
description (string) - Brief explanation or reason for issuing the credit note.
total_amount (number | string, required) - Total monetary value of the credit note, including all items and taxes.
marketplace (boolean) - Indicates whether this credit note is associated with a marketplace transaction.
tax_amount_imported (number | string) - Pre-calculated total tax amount for the entire credit note, if provided by the external system.
tax_rate_imported (number | string) - Pre-calculated overall tax rate for the credit note, if provided by the external system.
taxable_amount (number | string) - Total portion of the credit note amount subject to taxation.
currency (CurrencyEnum, required) - The currency used for all amounts in this credit note.
  allowed values: AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD (and 150 more, see the reference page)
addresses (TransactionAddressBuilder[]) - A list of TransactionAddressBuilder objects or None if no addresses are provided. This field represents the addresses associated with the transaction.
  phone (string) - Phone number associated with the address.
  street_1 (string) - Primary street address.
  street_2 (string) - Additional street address details, such as an apartment or suite number.
  city (string) - City where the customer resides.
[truncated, see the reference page]

---

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