---
title: "POST /refund"
method: POST
path: "/refund"
tags: ["POST"]
---

# POST /refund

`POST /refund`

Submit a full or partial refund for an order that has been captured.<br><br>A successful synchronous response to this request does not mean the refund has been successfully executed, but rather that the refund has been added to the system and will be attempted. If the refund cannot be added to the system an error will be synchronously returned in the response to this message. Once the refund has been attempted, a notification will be sent indicating success or failure of the refund attempt.

## Response `200`

The order was successfully refunded in the Reach system.

## Other responses

- `400` — If present, the refund request structure was invalid and unable to be parsed.
- `404` — If present, a value of the request was unable to be found. For example, if the MerchantId provided could not be found in the given environment
- `503` — There was a system problem and the request should be tried again.
- `2XX` — If present, the order could not be refunded due to an error. An HTTP 200 status code will be returned to indicate that the request was structured properly but an error was encountered.

---

[API](https://skmtc.net/withreach/apis/reach-checkout-api.md) · [All operations](https://skmtc.net/withreach/apis/reach-checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/withreach/reach-checkout-api/versions/f95f4b8dd180/schema)