---
id: refund-order
title: Refund an order
hide_title: true
description: "Management API - Use case - Refund order"
---

import Ingress from '../../../../src/components/ingress/ingress.react';

<Ingress title="Refund an order">
Use this request when you want to refund the full amount or part of an order amount
</Ingress>

## Use case

Part of, or the entire order has been returned by the customer and you want the money to be refunded.

When the order is refunded, the...

- state of the order will be `Returned` in Walley's system if the entire order is refunded.
- state of the order will be `Activated` or `Part activated` in Walley's system if part of the order is refunded.
- the funds will automatically be paid out to the customer
- the amount will be a part of the reconciliation report

## Endpoints used

[Refund order](/docs/manage/orders/refund)

## Example

The following request will refund the order with id `abcdef-12345-1234-5555-6666`

```http
POST /manage/orders/abcdef-12345-1234-5555-6666/refund HTTP/1.1
Host: api.uat.walleydev.com // Test environment. Production uses a different hostname.
Authorization: Bearer {{accessToken}}
Walley-Idempotency: 03304b06-cb33-4f78-bcea-86cb4b202ba0
Content-Type: application/json

{
  "amount": 285.0,
  "description": "Refund description",
  "actionReference": "test-refundref-123"
}
```