ClickPay provides you with a collection of API endpoints which used to process all payments, regardless of if they are through either your own payment pages, the managed payment pages, or if you are using the hosted payment pages.


Managed Form integration type is suitable for merchants with PCI SAQ A-EP. To know more about the Hosted Payment Page PCI DSS merchant requirements, please check this article.


In this article, we will walk you through how to initiate a payment request via this integration type. You will be introduced to the required parameters that need to be passed to initiate the request, along with all the possible optional parameters as well. We highly recommend that you and your team check our "Step 3.1.2 - PT2 API Endpoints | Payment workflow | Managed Form" solution article first to understand the business/logic this configuration option relay on.


The Endpoint and Related Postman Collection


In this tutorial, we will rely on the ClickPay Hosted Payment Page API Endpoint, mentioned on ClickPay API endpoints postman collection, which you can access from here. The endpoint will need to be accessed with a POST request on the below-mentioned URL


Post{{domain}}/payment/request



Please note that not using the proper endpoint URI {{domain}} will lead to authentication issues within your responses. To find the your proper domain you can read our What Is My (Region)/(endpoint URL)? solution article.


Using Managed Form. your website will display its own card entry form. However, key fields will be managed by the ClickPay gateway. You will need to include a script that replaces the sensitive card data with a payment token. Hence, there are two main parts to initiating the payment:


  1. From "The Frontend Side" (using JS), the front end from your side will send a request to ClickPay with the card details, and ClickPay will respond with the payment token.

  2. From "The Backend Side", the backend from your side will send the payment request to ClickPay with all needed payment details, and ClickPay will respond with the transaction result.
⌂ To get familiar with the whole process and the other steps, kindly navigate to our "The PT2 API Endpoints Integration Manual" solution article. 

    ⇦ And to get familiar with the rest of the steps regarding the previous step "Step 2 - Configure the integration method" kindly click here.

    ⇦ And to get familiar with the rest of the steps regarding the current step "Step 3 - Initiating the payment" click here. 

    ⇨ And to navigate to the next step in the integration process "Step 4 - Accepting the payment" kindly click here.