# Create a refund for an order

**POST /order/{orderNumber}/refund**

Create a refund (bank transfer back to the customer) for an existing order.

- `plannedDate` must be in the future (the date the bank transfer should be initiated).
- If the customer's bank details are not yet known, the refund starts in status `BANKDETAILS_MISSING` and Komfortkasse asks the customer to provide their IBAN. Once received, it transitions to `NEW` and is executed at `plannedDate`.
- `externalReference` is your own reference (e.g. RMA number) and must be unique per shop. Re-using a reference of an existing refund returns an error.

See also [Refunds](https://komfortkasse.freshdesk.com/support/solutions/articles/14000152280).


## Servers
- Production: https://ssl.komfortkasse.eu/api/v2 (Production)


## Authentication methods
- Api key


## Parameters

### Path parameters
- **orderNumber** (string)
  Order number (unique per shop).


### Body: application/json (object)

- **externalReference** (string)
  Reference given by you.
- **amount** (number)
  Refund amount. Format: `0.00`.
- **currency** (string)
  Refund currency.
- **plannedDate** (string)
  Planned date (date when the bank transfer should be initiated — can be delayed for technical or other reasons, e.g. waiting for bank details).


## Responses
### 200
Refund created.

#### Body: application/json (object)
- **externalReference** (string)
  Reference given by you.
- **amount** (number)
  Refund amount. Format: `0.00`.
- **currency** (string)
  Refund currency.
- **plannedDate** (string)
  Planned date (date when the bank transfer should be initiated — can be delayed for technical or other reasons, e.g. waiting for bank details).
- **id** (string)
  Unique ID (given by Komfortkasse).
- **executionDate** (string)
  Date when bank transfer has been executed (`null` if not yet processed).
- **referenceNumber** (string)
  Reference given by Komfortkasse (typically starts with 'KKBT').
- **status** (string)
  Refund status (read only):
  - `NEW` — will be transferred to bank if plannedDate is reached
  - `BANKDETAILS_MISSING` — waiting for bank details from customer
  - `IN_PROCESS` — being processed
  - `PROCESSED` — processed by bank
  - `RETURNED` — returned to original account
  - `ERROR` — error
  - `CANCELLED` — manually cancelled before executed
  - `LEGACY` — old bank transfer, will not be processed

  See also [Detail view refunds](https://komfortkasse.freshdesk.com/support/solutions/articles/14000152539) for a longer explanation of each status.

### 400
Invalid request — for example missing required fields or wrong format.

#### Body: application/json (object)
- **error** (string)
  Error message.

### 401
Authentication failed — API key missing or invalid.

#### Body: application/json (object)
- **error** (string)
  Error message.

### 404
Resource not found (e.g. unknown order number).

#### Body: application/json (object)
- **error** (string)
  Error message.


[Powered by Bump.sh](https://bump.sh)