Update PayLink details

In this manual, we will guide you on the correct method to update the PayLink details/features using a specified endpoint. We strongly recommend that you and your team review thePayLinks | Payment Workflowmanual first to grasp the business logic behind this integration type.

---

The Endpoint and Related Postman Collection

In this tutorial, we will rely on the PayTabs cancel Transaction API Endpoint, mentioned on the PayTabs API endpoints postman collection, which you can access fromhere. The endpoint will need to be accessed with a POST request on the below-mentioned URL

POST	{{domain}}/payment/link/update

Be Aware Of

Please note that not using the proper endpoint URL {domain} will lead to authentication issues within your responses. To find the your proper domain you can read ourWhat is my (Region)/(endpoint URL)?tutorial article.

KSA

https://secure.paytabs.sa/payment/link/update

UAE

https://secure.paytabs.com/payment/link/update

Egypt

https://secure-egypt.paytabs.com/payment/link/update

Oman

https://secure-oman.paytabs.com/payment/link/update

Jordan

https://secure-jordan.paytabs.com/payment/link/update

Kuwait

https://secure-kuwait.paytabs.com/payment/link/update

Global

https://secure-global.paytabs.com/payment/link/update

---

How to Update PayLink ?

Once your invoice is initiated, it can be classified as one of three statuses: "paid," "pending," or "canceled." For more information on invoice statuses, please refer to our PayLink manual. This article specifically outlines the proper method for changing the status of a particular invoice using the Invoice Cancel request.

---

The Minimum Required Parameters

To initiate a query invoice request, there are minimum required parameters that need to be passed with valid information. The specification of these required parameters is clarified below according to the query type:

Via Put Request

In the PUT request type, you can cancel the status by sending a PUT request with only the { link_id } as a parameter in the URL. Below is a sample request that demonstrates how to cancel an invoice with the ID "2075865."

Via Post Request

In the POST request type, we simply use a POST request with only the "link_id" and "profile_id" as payload parameters to cancel the invoice. As shown below

Parameter	Data Type	Required	Purpose
profile_id	INT	✔	The merchant Profile ID you can get from your PayTabs dashboard. For more information please check ourHow to get your account information from PT2 Dashboard?tutorial article. To know more about this parameter please click here profile_id.
	{ "profile_id": 263 }
link_id	INT	✔	Indicates the invoice reference you want to query. To know more about this parameter please click here invoice .
	{ "link_id": 263 }

---

Sample Request Payloads

Via Put Request

As we mentioned before, you can cancel the status by sending a PUT request with only the { link_id } as a parameter in the URL. Below is a sample request that demonstrates how to cancel an invoice with the ID "2075865."

Via Post Request

For post request, you need to set as usual the API key and the profile ID in the request as shown below:

{
  "profile_id": 79010,
  "link_id": {{link_id}}
}

---

Sample Response Payloads

{
    "message": "Invoice has been cancelled"
}