Hosted Page Integration

Hosted Page v2 is the new HiPay hosted payment page, where you can redirect your customers to securely process the payment.

With this integration HiPay will automatically display your company’s information, the order and your chosen payment methods.

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 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 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 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.

You can find more information in this article.

Server to server notifications

These notifications allow you to be notified, in a secured way, when a transaction is created and its status changes. You can configure them on the BO TPP > Integration > Notifications.

You can find more information in this article.

Signature 

Useful for increasing the security of the exchanges between your server and HiPay. You can find them here: BO TPP > Integration > Security Parameters.

You can find more information in this article.

 

iFrame

This is a hybrid solution in which the buyer remains on your website to make the payment. To use this integration you need to generate a hosted payment page (as above) with a special template. This allows you to 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 a HiPay Module, you won’t need to integrate the Hpayment API. Please follow the CMS Module documentation.

At the moment, Hosted Page v2 is only available on Magento 2, Prestashop & Shopify.

e-Terminal

At the moment, Hosted Page v2 is not available for HiPay’s eTerminal.

Hosted Page v1

You can still use Hosted Page v1, here you have the API swagger.

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 not migrate to the new Hosted Page for the moment.

Related Articles