Hosted Page Integration

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

Workflow HiPay Entreprise Hosted Page

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 the payment_product_list to 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.

Related Articles