---
title: "Mark a payment as refunded"
method: POST
path: "/v1/refunds"
tags: ["Refunds"]
---

# Mark a payment as refunded

`POST /v1/refunds`

Request a full refund for a payment. Calling a second time on the same payment returns 409.

## Headers

- `Merchant-Id` string, required
- `WCP-Version` string

## Request body

- object
  - `paymentId` string, required — Payment ID to refund

## Response `200`

Payment marked as refunded

- object
  - `paymentId` string, required — Payment ID that was marked as refunded

## Other responses

- `400` — Bad request
- `401` — Unauthorized — missing or invalid API key, or missing merchant id
- `404` — Payment not found
- `409` — Payment is already refunded
- `500` — Internal error
- `502` — Bad gateway

---

[API](https://skmtc.net/walletconnect/apis/walletconnect-pay-api.md) · [All operations](https://skmtc.net/walletconnect/apis/walletconnect-pay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/walletconnect/walletconnect-pay-api/revisions/8e5708191dde/schema)