# Create a credit note

Create a new credit note.

Endpoint: POST /credit-notes
Version: V5
Security: bearerAuth, basicAuth

## Request fields (application/json):

  - `invoice_id` (string, required)
    ID of the invoice
    Example: PMMlaE5wbg0

  - `amount` (number, required)
    Amount of the credit note
    Example: 2000

  - `number` (string)
    Number of the credit note
    Example: CN-001

  - `reason_code` (string, required)
    Reason code for the credit note
    Enum: "chargeback", "duplicate", "fraudulent", "requested_by_customer", "missing_remittance", "overpayment_on_invoice", "invoice_was_refunded", "double_payment_on_invoice", "missing_invoice_in_resolve", "credit_transfer", "other"

  - `reason_message` (string)
    Reason message for the credit note
    Example: reason_message

  - `credit_note_url` (string)
    URL for the publicly-accessible credit note PDF.
    Example: https://example.com/credit_note_url.pdf

## Response 200 fields (application/json):

  - `status` (string)
    Status of the credit note action
    Enum: "pending", "processing", "failed", "completed"

## Response 400 fields (application/json):

  - `error` (object)

  - `error.message` (string)
    A short string, describing error details
    Example: Validation error

  - `error.type` (string)
    A short string, describing error type
    Enum: "validation_error"

  - `error.details` (array)

  - `error.details.path` (string)
    Path to the field failed validation
    Example: path.to.field

  - `error.details.message` (string)
    Detailed description of the error
    Example: `[field]` is required

## Response 401 fields (application/json):

  - `error` (object)

  - `error.message` (string)
    A short string, describing error details
    Example: Invalid merchant credentials

  - `error.type` (string)
    A short string, describing error type
    Enum: "authentication_error"

## Response 404 fields (application/json):

  - `error` (object)

  - `error.message` (string)
    A short string, describing error details
    Example: [entity] not found

  - `error.type` (string)
    A short string, describing error type
    Enum: "not_found_error"

## Response 429 fields (application/json):

  - `error` (object)

  - `error.message` (string)
    A short string, describing error details
    Example: Too many requests

  - `error.type` (string)
    A short string, describing error type
    Enum: "rate_limit_error"