---
title: "Delete a payment link"
description: "Permanently deletes a payment link."
protocol: rest
method: DELETE
endpoint: "/v1/payment-links/{id}"
baseUrl: "https://api.gravv.xyz"
group: "Payment Links"
auth:
  label: "Api-Key"
  name: "Api-Key"
  in: header
---

# Delete a payment link

<Endpoint method="DELETE" path="/v1/payment-links/{id}" />

Permanently deletes a payment link.

## Path Parameters

<ParamField name="id" path="id" type="string" required>
  Unique identifier of the payment link.
</ParamField>

## Responses

| Status | Description |
| --- | --- |
| `200` | Payment link deleted successfully. |
| `400` | Invalid request parameters. |
| `404` | Payment link not found. |

### 200 response

<ResponseField name="message" type="string" required>
  Confirmation message for the deletion.
</ResponseField>

<ResponseExample>

```json title="Response"
{
  "message": "Payment link deleted successfully"
}
```

</ResponseExample>

### 400 response

<ResponseField name="data" type="null" required>
</ResponseField>

<ResponseField name="error" type="string" required>
  Human-readable error message.
</ResponseField>

<ResponseExample>

```json title="Response"
{
  "data": null,
  "error": "Invalid request parameters"
}
```

</ResponseExample>

### 404 response

<ResponseField name="data" type="any" required>
  Always null for error responses.
</ResponseField>

<ResponseField name="error" type="string" required>
  Human-readable error message.
</ResponseField>

<ResponseField name="error" type="any">

  <Expandable title="properties">
    <ResponseField name="code" type="any">
    </ResponseField>

    <ResponseField name="message" type="any">
    </ResponseField>

  </Expandable>
</ResponseField>

<ResponseExample>

```json title="Response"
{
  "data": null,
  "error": {
    "code": "NOT_FOUND",
    "message": "Payment link not found",
    "details": {}
  }
}
```

</ResponseExample>

## Authorization

- **ApiKeyAuth**