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
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 |
Updated 3 months ago