Create customized PayPage designs

With the Netaxept portal's template system, you can retain the look and feel of your website throughout the payment process, even though the PayPage is hosted by Netaxept. You create the templates in your Netaxept portal.

How to use Netaxept portal’s template system

Templates are created and maintained in your Netaxept admin portal:

Netaxept Admin's Options => Terminal => Terminal design tab

You can have multiple templates stored in your Netaxept admin portal account. You use the Register call’s terminalDesign parameter to refer to a specific template - this allows you to define the desired template on a transaction basis.

The actual template‘s HTML is also entered there, together with special tags that define where the Pay Page is to be placed and where the text and images should appear.

The template system is based on custom tags embedded in normal HTML, with the ability to style templates through inline styling:

tag example

{netaxept:terminal style="color:red" /}

You can customize the formating of your templates through CSS. In Netaxept Admin you can define CSS attributes either by uploading a CSS file or by linking to it from an external source. The latter option requires the file to be accessible from a HTTPS request.

The CSS can be defined either globally, for all templates, or for a specific template. Template-specific styling of course overrides global styling.

For now, mobile template configuration in Netaxept doesn't support CSS.

In addition to the HTML and style attributes, you can change the elements around the Pay Page (such as background color and image) and within the Pay Page (such as background color, text color and terminal border).

The tag showing the actual Netaxept Pay Page is {netaxept:terminal /}. With that, you can freely position the payment window on your website. Please note the extra space between the tag name and the slash (/).

The HTML input follows JavaScript Object Notation (JSON).

Select specific terminal designs per transaction

If you only have one template, this template can be activated in Netaxept admin portal. However, if you have several templates (for example seasonal templates or different templates for special transactions), you can specify which template to use per transaction by adding its name to the Create Payment's templateName parameter (from the payPageConfigurationobject).

If the templateName parameter is sent, it will overrule any template that has been marked as active in Netaxept Admin and find the correct template from the template names in the list of available templates. If the template cannot be looked up by name from Netaxept Admin, the default template will be used.

Adding attributes by using meta tags

You can add meta tags which can be used to inform the browser of various additional information. A popular example is the ability to override the character set used in the template, telling the browser how to interpret special characters. Meta tags can be added and maintained directly below the template editor in Netaxept Admin. You have to add the entire meta tag you want to have included.

meta tag example

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

Add image to the PayPage

There are two ways for adding images to the PayPage.

You can use the image upload functionality in Netaxept Admin if your need for images is quite limited (there are some restrictions on the upload). Doing this ensures that the images are delivered through a https-connection, avoiding browser warnings to the end-user about mixed content.
You can link to images that are uploaded at a server of your choice. The advantage of this solution is that you are free to choose the format, dimensions and file sizes of the images. The disadvantage is that you are responsible yourself for ensuring the https-delivery.