Netaxept hosted payment window

 

Netaxept payment window is available in two- and single-page mode and in mini layout version. After decided between two, single and mini, you can choose either to use our standard payment window or customize it, totally or partially, to retain the look and feel of your website or app throughout the purchase and checkout process, and still feel secured since the actual payment window is hosted by Nets. Modifications can be done via API and in Netaxept Admin. Read more about the terminal customisation >

 

Netaxept payment window in two-page mode

In two-page mode the customer will see first the page where they can choose the desired payment method. After it is selected, they are directed to the actual payment window or directly to the site of the selected payment method provider for entering their payment method information.

Two-page payment window is the default terminal option and can be used for all payment methods and optimised for both web and mobile. The standard version for web looks as below.

 

Netaxept payment window in single page mode

In single page mode the customer is directed directly to the actual payment window to enter their card details into the corresponding fields, with the supported card options displayed as small icons above the card number field. After entering the card number, the card type will be identified, and the correct card type will light up as visual feedback to the customer.

Single page payment window is supported only for cards and web terminals. If you are looking to implement other payment methods as well, we suggest you to implement a separate step in your site for selecting a payment method and implementing a path using single page for cards and a separate path for other payment methods. In that case, you need to send the name(s) of the payment method(s) in the "Payment method action list" parameter along the Register call.

To activate the single page mode, set terminalSinglePage=true in the Register call. The standard version for web looks as below.

 

Netaxept payment window in mini layout mode

For maximum control of the design of your checkout page, Netaxept has a mini payment window. This window is optimized to be as small as possible covering only input fields for a payment card. The minimized version is great to use within the Terminal design templates, in order to give you most of the web page area for your own design.

The mini payment window is supported both web and mobile terminals, but only for cards. If you are looking to implement other payment methods as well, we suggest you to implement a separate step in your site for selecting a payment method and implementing a path using single page for cards and a separate path for other payment methods. In that case, you need to send the name(s) of the payment method(s) in the "Payment method action list" parameter along the Register call.

To activate mini layout mode, set terminalLayout=mini in the Register call. Besides this, you need to design a template you want to use in mini layout mode and activate it either in Netaxept Admin or by specifying the template name in "terminalDesign" parameter in the Register call.

Since the mini payment window is optimized for staying as small as possible, error messages are not displayed inside the payment window. Instead, you can place the error message anywhere else on your webpage by using the specific error tag {netaxept:errorMessage /}. When using mini payment window, both the two special tags {netaxept:terminal /} and {netaxept:errorMessage /} need to be present in Netaxept Admin's Template design section for the mini payment window.

In mini payment window, no information about the order or merchant is displayed by default. Therefore, we recommend passing in "templateData" parameter in the Register call, to include for example the transaction amount and description of the order, if applicable.

 

Transaction flow

When implementing Netaxept hosted payment window, the basic payment flow goes as follows.

  1. Start the payment process by sending the Register call to Netaxept, and set serviceType=B to let us know you will be using a Netaxept hosted payment window. Read more about the Register call >
  2. In Register call, you also need to define whether you want your customers to select the payment method on your site or on Netaxept's payment window.
  • Payment method selected on your site: Implement a separate step in your site for selecting a payment method and send the name of the selected payment method to Netaxept in "paymentMethodActionList" parameter along the Register call. Netaxept's payment window is displayed as single-page mode for cards. For other payment methods, the payment window is skipped and the customer is directed directly from your site to the selected payment method site for completing the payment.
  • Payment method selected on Netaxept's payment window: The customer is directed from your site to Netaxept's payment window where they will see all the payment methods available in your webshop via Netaxept. After selected the payment method, they are directed to the actual payment window or to the selected payment method site for completing the payment. If you want to define the order of the payment methods on Netaxept's payment window, send "paymentMethodActionList" element along the Register call and list all the payment methods in the desired order. Otherwise, the use of this element is not necessary for this option.
  1. After the successful registration, use the Terminal call to redirect the customer’s web browser to the checkout. The payment window shows up based on your specifications done in the Register call. Read more about the Terminal phase >
  2. If the Response code is "OK", make the financial operation, like authorization (AUTH) or authorization & capture (SALE), to the transaction by using the Process call. Read more about the Process call >