The Hosted Page version 2 is the new payment page hosted by HiPay, where you can redirect your customers to securely process the payment.
With this integration, HiPay will automatically display the information of your company, the order and payment methods that you choose.
With this option you can benefit from a single point of contact, adaptable payment pages, and the PCI-DSS Standard. You can therefore outsource heavy security requirements that are related to payment acceptance.
Integration
In order to request a Hosted Page, you need to integrate the Hpayment API. We recommend you to use the PHP SDK to simplify the API integration.
Example (required fields only):
orderid: unique order id. Ex: ORDER_1583157210
description: order short description. Ex. Sales
amount: Total order amount. Ex: 9.99
currency: Order ISO 4217 three-character currency code. Ex: EUR
Before calling the API, you need to make sure you have all the required information:
Private Credentials
Needed for making the API Call. You can find them here: BO TPP > Integration > Security Parameters.
IP Address Restriction
When using the Hosted Page v2, you need to disable the IP Address restriction. You can change that here: BO TPP > Integration > Security Parameters.
Redirect Pages
We use the redirect pages to redirect the customer after a payment. You can either send the links on the hpayment API call, or set them on the BO TPP > Integration > Redirect Pages.
Here you have an article to better understand this concept.
Server to server notifications
These notifications allow you to be notified in a secured way when a transaction is created and when its status changes. You can configure them on the BO TPP > Integration > Notifications.
Here you have an article to better understand this concept.
Signature
Useful for increasing the security of the exchanges between your server and HiPay. You can find them here: BO TPP > Integration > Security Parameters.
Here you have an article to better understand this concept.
iFrame
This is a hybrid solution in which the buyer remains on your website to make payment. In order to use this integration you need to generate a hosted payment page (as above) with a special template, allowing you to properly display it in an iFrame.
In order to do so, set the parameter template with the iframe-js value on the Hpayment API.
CMS Integration
If you use a CMS with an HiPay Module, you won’t need to integrate the Hpayment API. Please follow the documentation of the CMS Module.
At the moment, the Hosted Page v2 is only available on Magento 2, Prestashop & Shopify.
e-Terminal
At the moment, the Hosted Page v2 is not available using HiPay’s eTerminal.
Hosted Page v1
You can still use the Hosted Page v1, here you have the API swagger of that version.
Compatibility
The new Hosted Page backward compatibility is assured on almost all cases. The only features that are not maintained at the moment are:
payment_product_category_list(hpayment parameter): you can use thepayment_product_listto specify the payments means to be displayed on the Hosted Page.css(hpayment parameter): for security reasons, the Hosted Page styling will be done using the Console Hosted Page Section.Mix Payment and Multi card payment: if you want to keep using these features, we recommend you to not migrate to the new Hosted Page for the moment.
