# PaymentSITE ## Overview PaymentSITE is a hosted payment page that can be integrated into a merchant’s system to process payments. Upon accessing the PaymentSITE, either where it is embedded or via a standalone URL, the customer can enter their payment details and any other relevant information like their name, address, and phone number. PaymentSITE tokenizes all card data and keeps the merchant out of scope for PCI compliance. The most popular form integration flow for developers is to build their own secure form with [iFields](https://docs.solapayments.com/products/ifields) for the user to enter their information, and then submit the transaction via our [Transaction API](https://docs.solapayments.com/api/transaction). By doing so, the developer maintains full control over the UI and behavior of the integration. When using a PaymentSITE, the developer gives up much control and is limited to whatever is supported by PaymentSITE. The advantage of PaymentSITE is that it is a quicker and easier implementation since the developer does not need to build the secure payment form and API calls directly. In addition, the user can utilize PaymentSITE’s built-in features and customizations without the developer needing to do additional work. {% hint style="info" %} PaymentSITE use requires initial sign-up. To get more information or sign-up, contact support. {% endhint %} ## Getting started ### Transaction types The PaymentSite can be configured to process various different payment types: `Sale` , `AuthOnly` , and `Save`. For more details on what each of these commands is used for see [Transaction API](https://docs.solapayments.com/api/transaction) ## Implementation ### Initiation methods #### **Redirect** The PaymentSite is implemented so that when the user is ready to pay, they are redirected out of the merchants system, to the PaymentSite to enter their payment information. #### **iFrame** When the user is ready to pay, the PaymentSite is opened in an iFrame in the merchants system. #### Pre-populate fields Most fields that are on the PaymentSite (besides the sensitive payment details) can be pre-populated by the merchants system before the user is directed to the page. This can be done by specifying the “key” and “values” of those fields separated by the “&” symbol in the URL query string. The “key“ value needs to match exactly the html “name“ element of the field; you can find that by inspecting the page using the developer tools of a browser. You can also look at the [Transaction API](https://docs.solapayments.com/api/transaction) by transaction type to find most fields. Example: {% hint style="info" %} **Note:** The merchant can log into the Cardknox portal to control what fields are available on the page. If you try to pre populate a field that is not added to the page, the system will just ignore it. {% endhint %} Here is a list of specific settings fields that can be set in the query string in addition to the above. **Settings** | Name | Description | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | xRedirectURL | This is the URL that the page will be redirected after the user submits the payment and the transaction is approved. If this is not specified, the user will stay on the PaymentSITE page and receive a message that the payment went through successfully. | | xRedirectURL\_NotApproved | This is the URL that the page will be redirected after the user submits the payment and the transaction is not approved. If this is not specified, the user will stay on the PaymentSITE page and receive a message that the payment did not go through, and they will be able to try again | | xPostUrl | This is the URL the webhook will be sent to after the user submits the payment. | {% hint style="info" %} Accounts need a setting enabled by a Cardknox Support Team member to use the `xPostUrl` field. {% endhint %} ### Response methods **Redirect** Typically, after the transaction is completed by the user, the PaymentSite will automatically redirect the user back to the merchants system. There are two ways how to specify the redirect URL 1. Set the Redirect URL in the Cardknox PaymentSite backend settings 2. Set the `xRedirectURL` parameter in the query string when directing the user to the PaymentSITE. The redirect will return the response parameter in the redirect quarry string. For a full list of response fields see [Response parameters](https://docs.cardknox.com/api/transaction#response-parameters) **Example:**\ **Webhook** The merchant's site can be notified of transaction responses via webhook notifications. This can be implemented in one of several ways: 1. Utilize [account webhooks](https://docs.solapayments.com/products/webhooks) to receive webhooks for any transaction that is processed on an account 2. Set the webhook URL in the Sola PaymentSite backend settings 3. Set the `xPostUrl` the parameter in the query string when directing the user to the PaymentSITE. {% hint style="info" %} To set an `xPostUrl`, please note that you need to contact Gateway Support to enable the setting for this method to function correctly. {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.solapayments.com/products/paymentsite.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.