Custom templates

How to use individual tags

The tags available for customization are listed below. All tags are mandatory, except when explicitly mentioned otherwise.

Tags are not case sensitive – some letters are capitalized here only for easier reading. Using templateData for passing data to the template with the Register call is also possible.

Please note, that the requirements for tags might change; optional tags may become mandatory, or vice versa, and new mandatory tags can be introduced.

These changes would be enforced by the template editor in Netaxept Admin. As a consequence you would need to update your template with these tags before changing other elements in your template.

All of these tags support both class and style-tags, enabling both inline styling and styling through CSS. If you wish to hide any of the information, for example order number, this can be done by adding style display: none;.

Here is an example of a basic custom template:

<p>{netaxept:netsLogo /}</p>
<p>{netaxept:amount /}</p>
<p>{netaxept:currency /}</p>
<p>{netaxept:orderDescription /}</p>

Information tags

• light background: set theme:default
• dark backgrounds: set theme:non-color

{netaxept:netsLogo theme="non-color" class="" style="width:150px;height:45px;"}

{netaxept:amount class="information" id="amount_text" }

{netaxept:fee class="information" id="fee_text"}

{netaxept:rounding class="information" id="rounding_text"}

{netaxept:totalAmount class="information" id="total_amount_text"}

{netaxept:currency class="information" id="currency_text"}

{netaxept:orderdescription class="information" id="order_description_text"}

{netaxept:ordernumber class="information" id="order_number_text"}

Card entry fields

{netaxept:cardnumber class="card_entry" id="card_number_entry"}

{netaxept:expirydatemonth class="card_entry" id="month_card_entry"}

{netaxept:expirydateyear class="card_entry" id="year_card_entry"}

{netaxept:securitycode class="card_entry" id="security_code_entry"}

Co-branded card

{netaxept:coBrandedCard class="cobranded_card" id="cobranded_card" }

Buttons

{netaxept:paybutton class="navigation_button" id="pay_button"}

{netaxept:cancelbutton class="navigation_button" id="cancel_button"}

Error handling

{netaxept:errormessage class="error_handling" id="error_message"}

{netaxept:errorcode class="error_handling" id="error_code"}

{netaxept:cardnumbererrormessage class="error_handling" id="card_number_error"}

{netaxept:expiryerrormessage class=" error_handling" id="expiry_error"}

{netaxept:securecodeerrormessage class=" error_handling" id="security_code_error"}

Easy payment and Recurring Payment

Custom templates also work with Easy payments and Recurring payments. The API calls remain exactly as with regular templates, the only changes are some HTML adjustments.

The specific HTML for initial and subsequent transactions must appear in specifically named <div> tags in the template. The three <div> IDs below are all mutually exclusive, so only one of them will be displayed at any given time.

<div id="CardPayment">
  {netaxept:orderNumber /}
  {netaxept:amount /}
  {netaxept:cardNumber /}

Initial transaction should appear within a <div> with the ID "CardPayment" (case sensitive). Note the lack of the security code field which needs to be placed outside of the specific <div>s.

<div id="UpdateStoredPayment">
  {netaxept:cardNumber /}
  {netaxept:expiryDateMonth /}
  {netaxept:expiryDateYear /}

Initial card registration, when registering a card for later Easy or Recurring payments without performing a purchase at the same time (the Register call contains updateStoredPaymentInfo=true), should be contained within a DIV with the ID "UpdateStoredPayment".

<div id="EasyPayment">
  {netaxept:maskedPan /}
  {netaxept:issuerLogo /}
</div>

Subsequent transaction in the payment window is only applicable for Easy payment. To show the information required for the second transaction onward, you should include a <div> with the ID "EasyPayment".

Easy payment specific tags

Some of the available tags are Easy payment specific:

{netaxept:maskedpan class="ep_information" id="masked_pan"}

{netaxept:issuerlogo class="ep_information" id="issuer_logo"}

Complete sample of a custom template

Below is an example of a complete custom template which relies on a linked CSS file. It accommodates regular payments, card registration for Easy or Recurring payment and subsequent transactions for Easy payment.

<h1>Test store</h1>

<div class="order_info">
    {netaxept:netsLogo theme="non-color" style="width:150px;height:45px;"/}