Skip to content

Update credit note

PUT
/v1/credit_notes/{credit_note_id}

Update a credit note (only allowed in draft status).

credit_note_id
required
Credit Note Id
string format: uuid
CreditNoteUpdate
object
description
Any of:
string
credit_amount_cents
Any of:
number
refund_amount_cents
Any of:
number
total_amount_cents
Any of:
number
taxes_amount_cents
Any of:
number
reason
Any of:
CreditNoteReason
string
Allowed values: duplicated_charge product_unsatisfactory order_change order_cancellation fraudulent_charge other
status
Any of:
CreditNoteStatus
string
Allowed values: draft finalized
credit_status
Any of:
CreditStatus
string
Allowed values: available consumed voided
refund_status
Any of:
RefundStatus
string
Allowed values: pending succeeded failed

Successful Response

CreditNoteResponse
object
id
required
Id
string format: uuid
number
required
Number
string
invoice_id
required
Invoice Id
string format: uuid
customer_id
required
Customer Id
string format: uuid
credit_note_type
required
Credit Note Type
string
status
required
Status
string
credit_status
Any of:
string
refund_status
Any of:
string
reason
required
Reason
string
description
Any of:
string
credit_amount_cents
required
Credit Amount Cents
string
/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/
refund_amount_cents
required
Refund Amount Cents
string
/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/
balance_amount_cents
required
Balance Amount Cents
string
/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/
total_amount_cents
required
Total Amount Cents
string
/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/
taxes_amount_cents
required
Taxes Amount Cents
string
/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/
currency
required
Currency
string
issued_at
Any of:
string format: date-time
voided_at
Any of:
string format: date-time
created_at
required
Created At
string format: date-time
updated_at
required
Updated At
string format: date-time

Only draft credit notes can be updated

Unauthorized

Credit note not found

Validation error