---
title: "Delete a merchant"
method: DELETE
path: "/v1/merchants/{merchantId}"
tags: ["Merchant Management"]
---

# Delete a merchant

`DELETE /v1/merchants/{merchantId}`

Soft-delete a merchant. The merchant is hidden from listings and can no longer accept new payments. Already-deleted merchants return `deleted: true` so the call is idempotent.

## Path parameters

- `merchantId` string, required

## Response `200`

Merchant deleted

- object
  - `id` string, required — Merchant ID
  - `deleted` boolean, required — Whether the merchant was successfully deleted

## Other responses

- `401` — Unauthorized
- `404` — Not found

---

[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)