shell bypass 403
# PaymentLinks
Method | HTTP request | Description
------------- | ------------- | -------------
[**PGCancelLink**](PaymentLink.md#PGCancelLink) | **Post** /links/{link_id}/cancel | Cancel Payment Link
[**PGCreateLink**](PaymentLink.md#PGCreateLink) | **Post** /links | Create Payment Link
[**PGFetchLink**](PaymentLink.md#PGFetchLink) | **Get** /links/{link_id} | Fetch Payment Link Details
[**PGLinkFetchOrders**](PaymentLink.md#PGLinkFetchOrders) | **Get** /links/{link_id}/orders | Get Orders for a Payment Link
## PGCancelLink
> PGCancelLink($x_api_version, $link_id, $x_request_id = null, $x_idempotency_key = null, GuzzleHttp\Client $http_client = null)
Cancel Payment Link ([Docs](https://docs.cashfree.com/reference/pgcancellink))
### Example
```php
$link_id = "my_link_id_test";
try {
$result = $cashfree->PGCancelLink($x_api_version, $link_id, null, null, null);
} catch (Exception $e) {
echo 'Exception when calling PGCancelLink: ', $e->getMessage(), PHP_EOL;
}
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**linkId** | **string** | The payment link ID for which you want to view the details. |
**xApiVersion** | **string** | API version to be used. Format is in YYYY-MM-DD | [default to "2022-09-01"]
**xRequestId** | **string** | Request id for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to cashfree |
### Response
```json
{
"cf_link_id": 1996567,
"link_id": "my_link_id",
"link_status": "ACTIVE",
"link_currency": "INR",
"link_amount": 100,
"link_amount_paid": 0,
"link_partial_payments": true,
"link_minimum_partial_amount": 20,
"link_purpose": "Payment for PlayStation 11",
"link_created_at": "2021-09-30T17:05:01+05:30",
"customer_details": {
"customer_name": "John Doe",
"customer_phone": "9999999999",
"customer_email": "john@example.com"
},
"link_meta": {
"title": "link_meta",
"description": "Payment link meta information object",
"type": "object",
"example": {
"notify_url": "https://ee08e626ecd88c61c85f5c69c0418cb5.m.pipedream.net",
"upi_intent": false,
"return_url": "https://b8af79f41056.eu.ngrok.io"
},
"properties": {
"notify_url": {
"type": "string",
"description": "Notification URL for server-server communication. It should be an https URL."
},
"upi_intent": {
"type": "boolean",
"description": "If \"true\", link will directly open UPI Intent flow on mobile, and normal link flow elsewhere"
},
"return_url": {
"type": "string",
"description": "The URL to which user will be redirected to after the payment is done on the link. Maximum length: 250."
},
"payment_methods": {
"type": "string",
"description": "Allowed payment modes for this link. Pass comma-separated values among following options - \"cc\", \"dc\", \"ccc\", \"ppc\", \"nb\", \"upi\", \"paypal\", \"app\". Leave it blank to show all available payment methods"
}
},
"x-readme-ref-name": "LinkMetaEntity"
},
"link_url": "https://payments-test.cashfree.com/links/o1tf1nvcvjhg",
"link_expiry_time": "2021-10-14T15:04:05+05:30",
"link_notes": {
"title": "link_notes",
"type": "object",
"description": "Key-value pair that can be used to store additional information about the entity. Maximum 5 key-value pairs",
"example": {
"key_1": "value_1",
"key_2": "value_2"
},
"additionalProperties": {
"type": "string"
},
"x-readme-ref-name": "LinkNotesEntity"
},
"link_auto_reminders": true,
"link_notify": {
"title": "link_notify",
"type": "object",
"description": "Payment link Notify Object for SMS and Email",
"example": {
"send_sms": false,
"send_email": true
},
"properties": {
"send_sms": {
"type": "boolean",
"description": "If \"true\", Cashfree will send sms on customer_phone"
},
"send_email": {
"type": "boolean",
"description": "If \"true\", Cashfree will send email on customer_email"
}
},
"x-readme-ref-name": "LinkNotifyEntity"
}
}
```
## PGCreateLink
> PGCreateLink($x_api_version, $create_link_request, $x_request_id = null, $x_idempotency_key = null, GuzzleHttp\Client $http_client = null)
Create Payment Link ([Docs](https://docs.cashfree.com/reference/pgcreatelink))
### Example
```php
$link_customer_details_entity = new \Cashfree\Model\LinkCustomerDetailsEntity();
$link_customer_details_entity->setCustomerName("John Doe");
$link_customer_details_entity->setCustomerPhone("9999999999");
$link_customer_details_entity->setCustomerEmail("john@cashfree.com");
$link_notify_entity = new \Cashfree\Model\LinkNotifyEntity();
$link_notify_entity->setSendSms(false);
$link_notify_entity->setSendEmail(true);
$link_meta_response_entity = new \Cashfree\Model\LinkMetaResponseEntity();
$link_meta_response_entity->setNotifyUrl("https://ee08e626ecd88c61c85f5c69c0418cb5.m.pipedream.net");
$link_meta_response_entity->setUpiIntent(false);
$link_meta_response_entity->setReturnUrl("https://b8af79f41056.eu.ngrok.io");
$create_link_request = new \Cashfree\Model\CreateLinkRequest();
$create_link_request->setLinkId("my_link_id_test");
$create_link_request->setLinkAmount(100);
$create_link_request->setLinkCurrency("INR");
$create_link_request->setLinkPurpose("Payment for PlayStation 11");
$create_link_request->setCustomerDetails($link_customer_details_entity);
$create_link_request->setLinkPartialPayments(true);
$create_link_request->setLinkMinimumPartialAmount(10);
$create_link_request->setLinkExpiryTime("2024-03-18T19:14:24+05:30");
$create_link_request->setLinkNotify($link_notify_entity);
$create_link_request->setLinkAutoReminders(false);
$create_link_request->setLinkNotes(["key_1" => "value_1", "key_2" => "value_2"]);
$create_link_request->setLinkMeta($link_meta_response_entity);
try {
$result = $cashfree->PGCreateLink($x_api_version, $create_link_request, null, null, null);
} catch (Exception $e) {
echo 'Exception when calling PGCreateLink: ', $e->getMessage(), PHP_EOL;
}
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**xApiVersion** | **string*** | API version to be used. Format is in YYYY-MM-DD | [default to "2022-09-01"]
**createLinkRequest** | **CreateLinkRequest*** | Request Body to Create Payment Links |
**xRequestId** | **string** | Request id for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to cashfree |
### Response
```json
{
"cf_link_id": 1996567,
"link_id": "my_link_id",
"link_status": "ACTIVE",
"link_currency": "INR",
"link_amount": 100,
"link_amount_paid": 0,
"link_partial_payments": true,
"link_minimum_partial_amount": 20,
"link_purpose": "Payment for PlayStation 11",
"link_created_at": "2021-09-30T17:05:01+05:30",
"customer_details": {
"customer_name": "John Doe",
"customer_phone": "9999999999",
"customer_email": "john@example.com"
},
"link_meta": {
"title": "link_meta",
"description": "Payment link meta information object",
"type": "object",
"example": {
"notify_url": "https://ee08e626ecd88c61c85f5c69c0418cb5.m.pipedream.net",
"upi_intent": false,
"return_url": "https://b8af79f41056.eu.ngrok.io"
},
"properties": {
"notify_url": {
"type": "string",
"description": "Notification URL for server-server communication. It should be an https URL."
},
"upi_intent": {
"type": "boolean",
"description": "If \"true\", link will directly open UPI Intent flow on mobile, and normal link flow elsewhere"
},
"return_url": {
"type": "string",
"description": "The URL to which user will be redirected to after the payment is done on the link. Maximum length: 250."
},
"payment_methods": {
"type": "string",
"description": "Allowed payment modes for this link. Pass comma-separated values among following options - \"cc\", \"dc\", \"ccc\", \"ppc\", \"nb\", \"upi\", \"paypal\", \"app\". Leave it blank to show all available payment methods"
}
},
"x-readme-ref-name": "LinkMetaEntity"
},
"link_url": "https://payments-test.cashfree.com/links/o1tf1nvcvjhg",
"link_expiry_time": "2021-10-14T15:04:05+05:30",
"link_notes": {
"title": "link_notes",
"type": "object",
"description": "Key-value pair that can be used to store additional information about the entity. Maximum 5 key-value pairs",
"example": {
"key_1": "value_1",
"key_2": "value_2"
},
"additionalProperties": {
"type": "string"
},
"x-readme-ref-name": "LinkNotesEntity"
},
"link_auto_reminders": true,
"link_notify": {
"title": "link_notify",
"type": "object",
"description": "Payment link Notify Object for SMS and Email",
"example": {
"send_sms": false,
"send_email": true
},
"properties": {
"send_sms": {
"type": "boolean",
"description": "If \"true\", Cashfree will send sms on customer_phone"
},
"send_email": {
"type": "boolean",
"description": "If \"true\", Cashfree will send email on customer_email"
}
},
"x-readme-ref-name": "LinkNotifyEntity"
}
}
```
## PGFetchLink
> PGFetchLink($x_api_version, $link_id, $x_request_id = null, $x_idempotency_key = null, GuzzleHttp\Client $http_client = null)
Fetch Payment Link Details ([Docs](https://docs.cashfree.com/reference/pgfetchlink))
### Example
```php
$link_id = "my_link_id_test";
try {
$result = $cashfree->PGFetchLink($x_api_version, $link_id, null, null, null);
} catch (Exception $e) {
echo 'Exception when calling PGFetchLink: ', $e->getMessage(), PHP_EOL;
}
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**linkId** | **string*** | The payment link ID for which you want to view the details. |
**xApiVersion** | **string*** | API version to be used. Format is in YYYY-MM-DD | [default to "2022-09-01"]
**xRequestId** | **string** | Request id for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to cashfree |
### Response
```json
{
"cf_link_id": 1996567,
"link_id": "my_link_id",
"link_status": "ACTIVE",
"link_currency": "INR",
"link_amount": 100,
"link_amount_paid": 0,
"link_partial_payments": true,
"link_minimum_partial_amount": 20,
"link_purpose": "Payment for PlayStation 11",
"link_created_at": "2021-09-30T17:05:01+05:30",
"customer_details": {
"customer_name": "John Doe",
"customer_phone": "9999999999",
"customer_email": "john@example.com"
},
"link_meta": {
"title": "link_meta",
"description": "Payment link meta information object",
"type": "object",
"example": {
"notify_url": "https://ee08e626ecd88c61c85f5c69c0418cb5.m.pipedream.net",
"upi_intent": false,
"return_url": "https://b8af79f41056.eu.ngrok.io"
},
"properties": {
"notify_url": {
"type": "string",
"description": "Notification URL for server-server communication. It should be an https URL."
},
"upi_intent": {
"type": "boolean",
"description": "If \"true\", link will directly open UPI Intent flow on mobile, and normal link flow elsewhere"
},
"return_url": {
"type": "string",
"description": "The URL to which user will be redirected to after the payment is done on the link. Maximum length: 250."
},
"payment_methods": {
"type": "string",
"description": "Allowed payment modes for this link. Pass comma-separated values among following options - \"cc\", \"dc\", \"ccc\", \"ppc\", \"nb\", \"upi\", \"paypal\", \"app\". Leave it blank to show all available payment methods"
}
},
"x-readme-ref-name": "LinkMetaEntity"
},
"link_url": "https://payments-test.cashfree.com/links/o1tf1nvcvjhg",
"link_expiry_time": "2021-10-14T15:04:05+05:30",
"link_notes": {
"title": "link_notes",
"type": "object",
"description": "Key-value pair that can be used to store additional information about the entity. Maximum 5 key-value pairs",
"example": {
"key_1": "value_1",
"key_2": "value_2"
},
"additionalProperties": {
"type": "string"
},
"x-readme-ref-name": "LinkNotesEntity"
},
"link_auto_reminders": true,
"link_notify": {
"title": "link_notify",
"type": "object",
"description": "Payment link Notify Object for SMS and Email",
"example": {
"send_sms": false,
"send_email": true
},
"properties": {
"send_sms": {
"type": "boolean",
"description": "If \"true\", Cashfree will send sms on customer_phone"
},
"send_email": {
"type": "boolean",
"description": "If \"true\", Cashfree will send email on customer_email"
}
},
"x-readme-ref-name": "LinkNotifyEntity"
}
}
```
## PGLinkFetchOrders
> PGLinkFetchOrders(x_api_version: string, link_id: string, x_request_id?: string, x_idempotency_key?: string, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<OrderEntity[], any>>
Get Orders for a Payment Link ([Docs](https://docs.cashfree.com/reference/pglinkfetchorders))
### Example
```php
$link_id = "my_link_id_test";
try {
$result = $cashfree->PGLinkFetchOrders($x_api_version, $link_id, null, null, null);
} catch (Exception $e) {
echo 'Exception when calling PGLinkFetchOrders: ', $e->getMessage(), PHP_EOL;
}
```
### Parameters
Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**linkId** | **string*** | The payment link ID for which you want to view the details. |
**xApiVersion** | **string*** | API version to be used. Format is in YYYY-MM-DD | [default to "2022-09-01"]
**xRequestId** | **string** | Request id for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to cashfree |
### Response
```json
[
{
"cf_order_id": 2149460581,
"created_at": "2023-08-11T18:02:46+05:30",
"customer_details": {
"customer_id": "409128494",
"customer_name": "Johmn Doe",
"customer_email": "pmlpayme@ntsas.com",
"customer_phone": "9876543210"
},
"entity": "order",
"order_amount": 22,
"order_currency": "INR",
"order_expiry_time": "2023-09-09T18:02:46+05:30",
"order_id": "order_3242Tq4Edj9CC5RDcMeobmJOWOBJij",
"order_meta": {
"return_url": "https://example.com/return/{order_id}",
"notify_url": "https://example.com/notify",
"payment_methods": "cc"
},
"order_note": "some order note LIST",
"order_splits": [],
"order_status": "ACTIVE",
"order_tags": {
"name": "John",
"age": "19"
},
"payment_session_id": "session_a1VXIPJo8kh7IBigVXX8LgTMupQW_cu25FS8KwLwQLOmiHqbBxq5UhEilrhbDSKKHA6UAuOj9506aaHNlFAHEqYrHSEl9AVtYQN9LIIc4vkH",
"payments": {
"url": "https://sandbox.cashfree.com/pg/orders/order_3242Tq4Edj9CC5RDcMeobmJOWOBJij/payments"
},
"refunds": {
"url": "https://sandbox.cashfree.com/pg/orders/order_3242Tq4Edj9CC5RDcMeobmJOWOBJij/refunds"
},
"settlements": {
"url": "https://sandbox.cashfree.com/pg/orders/order_3242Tq4Edj9CC5RDcMeobmJOWOBJij/settlements"
},
"terminal_data": null
}
]
```