---
title: "Refund or cancel an existing Payment"
method: POST
path: "/payments/{id}/refunds"
tags: ["Payments"]
---

# Refund or cancel an existing Payment

`POST /payments/{id}/refunds`

## Path parameters

- `id` string, uuid, required

## Headers

- `Trace-Id` string
- `End-User-Agent` string
- `End-User-Ip` string
- `End-User-OS` string
- `End-User-Device-Id` string
- `End-User-Device-Manufacturer` string
- `End-User-Device-Model` string

## Request body

- PaymentRefundRequest
  - `payer` PayerId, required
    - `id` string, uuid, required

## Response `200`

Payment refunded successfully

- PaymentRefund
  - `status` 'REFUNDED' | 'REFUND_FAILED' — Representation of whether the Payment was successfully refunded or not

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.dev/plastiq/apis/plastiq-public-api.md) · [All operations](https://skmtc.dev/plastiq/apis/plastiq-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plastiq/plastiq-public-api/revisions/cfd776dd9ac5/schema)