# Create a credit note

Create a new credit note.

Endpoint: POST /credit-notes
Version: V5
Security: 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 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"