---
title: "Void refund"
method: POST
path: "/v1/refunds/{refund_id}/void"
tags: ["Refunds"]
---

# Void refund

`POST /v1/refunds/{refund_id}/void`

Void a refund by the refund ID.

See the refund `non_voidable_reason_code` for details on if the refund is eligible for a void.

## Parameters

- `#/paths/~1v1~1payins/get/parameters/0` — unresolved $ref
- `#/paths/~1v1~1refunds~1%7Brefund_id%7D/get/parameters/1` — unresolved $ref

## Request body

- object
  - `idempotency_key` string, required — A unique identifier provided by the platform. This key will be used to detect subsequent retries of the same request. Subsequent requests with the same key will return the result of the first request, regardless if the first request succeeded or failed. This identifier should be generated by the platform and can be max 255 characters.
  - `reason` 'CORRECTION' | 'DUPLICATE' | 'REQUESTED_BY_CUSTOMER', required — The reason to void this refund.
  - `metadata` Schema — unresolved $ref

## Response `200`

OK

- object
  - `status` Status — unresolved $ref
  - `data` Data — unresolved $ref
  - `errors` Errors — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `404` — unresolved $ref
- `409` — Conflict on the requested resource.
- `5XX` — unresolved $ref

---

[API](https://skmtc.dev/rainforestpay/apis/authentication.md) · [All operations](https://skmtc.dev/rainforestpay/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rainforestpay/authentication/revisions/529a0dab0f90/schema)