Getting the paylink settings

To get the current paylink settings for a merchant:

1

Use the GET method with the /rest/v2/settings/terminal/paylink endpoint.

2

Add the following header parameter in the request.

Name	Data type	Required?	Description
api-key	String	Required	The API key used to securely access the service.

The following response code appears when Paylink settings are retrieved successfully:

{
    "code": "200",
    "status": "SUCCESS",
    "exchange-id": "ID-clearent-gss-2-af985d57-7d87-4ba6-88c7-249b1b6d7283",
    "links": [
        {
            "rel": "terminal",
            "href": "https://gateway-sb.clearent.net/rest/v2/settings/terminal"
        }.
        {
            "rel": "hpp",
            "href": "https://gateway-sb.clearent.net/rest/v2/settings/terminal/hpp"
        },
        {
            "rel": "self",
            "href": "https://gateway-sb.clearent.net/rest/v2/settings/terminal/paylink"
        }
    ],
    "payload": {
        "paylink": {
            "terminalId": 42930,
            "enabled": true,
            "metadata": {
                "show-billing-address": "true
                "require-billing-address": "true",    
            },
            "success-url": "https://www.website.com/success",
            "cancel-url": "https://www.website.com/cancel"
        },
        "payloadType": "paylink-settings"
    }
}

The following table describes the fields in the response body for the retrieved Paylink settings:

Name	Data type	Description
status	Text	A text in response to your API authentication request, such as: Success: The API request was authenticated successfully. Fail: The API request failed authentication.
exchange-id	String	The GUID (Global Unique Identifier) associated with the paylink settings.
links	Array	List of links associated with the merchant’s paylink settings.
rel	Text	The current status of the paylink setting. This field shows self when the setting is enabled for a merchant.
href	Text	The URL associated with the merchant’s paylink settings.
payload	Object	Contains the details of the payload settings.
payload.paylink	Object	Contains the details of the paylink settings and configurations
payload.paylink.terminalId	Text	The internal terminal ID associated with the merchant’s paylink settings.
payload.paylink.enabled	Boolean	Indicates whether the paylink setting is enabled. true – The paylink setting is enabled. false – The paylink setting is disabled.
payload.paylink.metadata	Object	Contains the details of the paylink configurations and attributes.
payload.paylink.metadata.show-billing-address	Boolean	Indicates whether the billing address section is shown on the payment form. true – The billing address section is shown. false – The billing address section is hidden.
payload.paylink.metadata.required-biiling-address	Boolean	Indicates whether the billing address section is required on the payment form. true – The billing address section is required. false – The billing address section is optional.
payload.success-url	String	The URL where customers are redirected after a successful payment.
payload.cancel-url	String	The URL where customers are redirected after canceling a payment.
payload.payloadType	String	The payload type classification.

The following table describes the HTTP status codes in the response body:

Code	Description
200	The paylink settings retrieved successfully.
401	Unauthorized
403	Forbidden