Invalidating Paylinks

Learn how to invalidate a Paylink

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, 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 HMAC

Check out our API Authentication section 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.

To invalidate a Paylink, send an API call to:

Staging:PATCH https://stage-paylinks.skipify.com/{paylinkId}/cancel

Production:PATCH https://paylinks.skipify.com/{paylinkId}/cancel

API Response

CodeDescription
204 No ContentSuccessfully canceled a Paylink
400 Bad RequestReturned if Paylink has already been paid, or Cancelled
404Paylink was not found


Skipify baner with link to contact us form