---
updatedAt: 2025-09-24T00:50:47.000Z
agentTools:
  projectIndex: https://docs.skipify.com/llms.txt
---

# Invalidating Paylinks

Learn how to invalidate a Paylink

<HTMLBlock>{`
<style>
.App {
  --font-family: 'poppins', 'helvetica';
}
</style>
`}</HTMLBlock>

<HTMLBlock>{`
<style>
  /* Terrell From ReadMe Here */
  .markdown-body .rdmd-table table {
    table-layout: fixed;
}

</style>
`}</HTMLBlock>

# Overview

An invalid Paylink will no longer display the option for customers to submit payments when they view the order payment site. Instead, the site will display an error message that explains the link is canceled or expired.

You are able to directly control link invalidation in a couple ways:

* You can set an expiration date and time, which will automatically expire your Paylink after the date and time have passed.
* You can send an API call to Skipify to cancel a previously created Paylink.

Invalidating via the `expiration` field:

When [creating a Paylink](https://docs.skipify.com/docs/creating-paylinks), you can set a specific `datetime` for when the link expires. After that `datetime`, the link will become invalid and the status of the Paylink will be "Expired."

# API Request

> 👍 This endpoint uses API Key Authentication
>
> Check out our [API KEY Authentication Section](https://docs.skipify.com/docs/api-authentication-api-key) to learn more

The endpoint for this request uses the payment's `paylinkId`, which was originally provided in the response body when you [created the Paylink](https://docs.skipify.com/docs/creating-paylinks).

To invalidate a Paylink, send an API call to:

> **Staging**:`PATCH https://paylinks.staging.skipify.com/{paylinkId}/cancel`
>
> **Production**:`PATCH https://paylinks.skipify.com/{paylinkId}/cancel`

# API Response

| Code            | Description                                             |
| :-------------- | :------------------------------------------------------ |
| 204 No Content  | Successfully canceled a Paylink                         |
| 400 Bad Request | Returned if Paylink has already been paid, or Cancelled |
| 404             | Paylink was not found                                   |

***

<HTMLBlock>{`
<a href="https://www.skipify.com/get-in-touch"><img src="https://files.readme.io/279452f-CTA_Contact_Footer_1440x205_Final.png" alt="Skipify baner with link to contact us form"></a>
`}</HTMLBlock>