---
title: "Delete a Payer"
method: DELETE
path: "/v1/payments/payers/{payerId}"
tags: ["Payers"]
---

# Delete a Payer

`DELETE /v1/payments/payers/{payerId}`

Should you or your customers want to remove a Payer, you can do so using this API. In your DELETE request, simply add the PayerId as a slug. Please note that when a Payer is deleted, we will keep a reference to it in order to maintain the integrity of the transaction history. A success response will contain a confirmation message with a reference to the deleted payer account.

## Path parameters

- `payerId` string, required

## Response `200`

- ResponseStatus
  - `code` number
  - `desc` string
  - `messages` Message[]
    - `desc` string, required
    - `type` 'ERROR' | 'WARN' | 'INFO'

## Other responses

- `400` — Bad request response
- `401` — Unauthorized response
- `404` — Not found response
- `500` — Internal server error response

---

[API](https://skmtc.dev/spinwheel/apis/discover.md) · [All operations](https://skmtc.dev/spinwheel/apis/discover/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spinwheel/discover/revisions/55b90a2e1dd4/schema)