---
title: "Create Credit Note"
method: POST
path: "/invoices/{captureId}/credit-notes"
tags: ["Captures"]
---

# Create Credit Note

`POST /invoices/{captureId}/credit-notes`

**Purpose:**

To refund against a previous capture. This can be done against part of the captured amount (partial refund) or its entire amount (full refund).

**Preconditions:** 

- `captureId`: The unique identifier of the capture
- `amount`: The amount to be refunded

**Success:** 

- Response Code: `HTTP 201`

**Attention:**

- The amount provided in the refund request does not exceed the amount of the capture.

## Path parameters

- `captureId` string, uuid, required

## Request body

- CreateCreditNoteRequest — Create Credit Note
  - `external_code` string, required
  - `amount` AmountDTO, required — The amount object with split values for net, gross and tax
    - `gross` number, float, required — Value greater than 0, with max. 2 decimals. It should equal to net + tax.
    - `net` number, float, required — Value greater than 0, with max. 2 decimals.
    - `tax` number, float, required — Value greater than or equal to 0, with max. 2 decimals.
  - `comment` string
  - `line_items` LineItemsRequest[] — Line items from the invoice which this credit note is created for.
    - `external_id` string, nullable
    - `title` string
    - `description` string, nullable
    - `quantity` number
    - `category` string, nullable
    - `brand` string, nullable
    - `gtin` string, nullable
    - `mpn` string, nullable
    - `amount_gross` number — Value is in cents
    - `amount_net` number, nullable — Value is in cents
    - `amount_tax` number, nullable — Value is in cents
    - `tax_rate` number, nullable — Value is in cents
    - `unit_price` number — Value is in cents
    - `total_discount_amount` number, nullable — Value is in cents
    - `product_url` string, nullable
    - `image_url` string, nullable
    - `quantity_unit` string, nullable
    - `type` string, nullable

## Response `201`

Credit note successfully created

- object
  - `uuid` string, uuid, required

## Other responses

- `400` — Invalid Request Data
- `401` — Unauthorized request or invalid credentials
- `403` — Forbidden Request. The operation cannot be completed.
- `404` — Resource Not Found
- `500` — Unexpected Server Error

---

[API](https://skmtc.net/billie/apis/billie-direct-api.md) · [All operations](https://skmtc.net/billie/apis/billie-direct-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/billie/billie-direct-api/versions/8cce15617825/schema)