UniPay Gateway Documentation

Are you ready?

In this tutorial, we are going to learn how to add hosted payment pages to a merchant. When adding hosted payment pages, two options are available:
- to add default HPP templates for further downloading, customization and uploading back. This is needed when a merchant/account does not have its own payment pages;
- to upload customized payment pages. This option is used if a merchant/account already has its own payment pages and does not need to download the templates and customize them for further uploading.
If you want to test live HPP templates, use these files.
We will use the following parameters:

HPP Folder Name: 2000 (corresponds to a merchant or account ID)
HPP Templates Names:
paypage_card.html (used for sale, sale-auth and credit operations done with payment cards) tokenization_card.html (used for tokenization operations done with payment cards) paypage_account.html (used for sale, sale-auth and credit operations done with bank accounts) tokenization_account.html (used for tokenization operations done with bank accounts) result.html (a page shown to a user once an operation is successfully completed)
Log in to the system using your Username and Password and switch to the Management => Merchant Perspective.

Note: To learn how to log in and select perspectives, use the prerequisite tutorial Logging in and navigating the application.
Select appropriate Merchant or Merchant Account in the top left section of the screen.
Firstly, let's learn how to create a new HPP folder and add a set of default hosted payment page templates.
Click Resourcesbutton in the top section of the screen.
Choose Pages menu item from the list.
Click Create Folderbutton , enter 2000 into the textbox and press Enter button on your keyboard.
Click Modifybutton next to the folder.
Choose Copy default page's set menu item from the list to add default HPP templates to the merchant. At this step, the resources folder containing default scripts, images and css pages is also created.
You can now download default HPP templates for subsequent customization and uploading. Let's learn how to do this.
Click Download Filebutton next to the paypage_card.html, paypage_account.html, tokenization_card.html, tokenization_account.html, result.html files to download them to your computer and customize according to your needs.
Click Upload Filebutton and select the HPP template files that have been customized to upload them and replace the default ones.
Now, let's learn how to upload merchant's/account's own payment pages.
Click Create Folderbutton , enter 2000 into the textbox and press Enter button on your keyboard.
Click Upload Filebutton next to the folder to upload custom hosted payment pages from your computer.
Click Modifybutton next to the folder.
Choose Create resources folder menu item from the list to create a resources folder. If there are any custom scripts, images and CSS files, they are required to be uploaded to this folder.
Click Removebutton to remove the custom HPPs that are no longer needed.
Finally, to verify that hosted payment pages have been copied correctly, submit the sale (via HPP) API request.
Congratulations, you are done!

You have learned how to add hosted payment page templates. Now you can do this by yourself.

Managing hosted payment pages advanced customization

Managing hosted payment pages advanced customization

Tags