SecurePay eSec Payment Gateway

Last Updated: 22 Dec 2016

The SecurePay eSec payment method is now deprecated and has been replaced by SecurePay's Direct Post browser redirect payment system. As a result, you should use the SecurePay Direct Post Payment Gateway when integrating Matrix with SecurePay.

The SecurePay eSec Payment Gateway asset allows you to create an eSec payment gateway, providing users with a secure way to pay for their items. In order to use the SecurePay eSec Payment Gateway, you will need a merchant account at the eSec payments Gateway website. For more information, visit the SecurePay website.

SecurePay online payment gateway and eCommerce solutions are only available to users within Australia.

The eSec payment gateway allows both VISA and MasterCard transactions.

Bookmarks to the headings on this page:     

  1. Additional Dependant Assets
  2. Details Screen
  3. Display Formatting Screen

Once you have added a SecurePay eSec Payment Gateway, you can configure its settings on its associated asset screens. The majority of these screens are the same or similar to those for a Standard Page and are described in the Asset Screens manual. In this chapter, we will describe the Details and Display Formatting screens, which are different for a SecurePay eSec Payment Gateway.

Additional Dependant Assets

The additional dependant assets of the SecurePay eSec Payment Gateway
The additional dependant assets

When you create a SecurePay eSec Payment Gateway, the Display Format Bodycopy asset is automatically created beneath it, as shown in the figure to the right.You can use this Bodycopy to define the contents and layout of the SecurePay eSec Payment Gateway form. This Bodycopy can also be accessed via the Display Formatting screen.

Details Screen

The Details screen allows you to configure the settings of the SecurePay eSec Payment Gateway. For more information about the Status, Future Status, Thumbnail and Details sections, refer to the Details Screen chapter in the Asset Screens manual.

Identifiers

This section allows you to enter your merchant ID, allowing you to accept payments from the payment gateway.

The Identifiers section of the Details screen
The Identifiers section of the Details screen

In the Merchant ID field, enter your merchant ID, supplied to you by your bank. In order to accept VISA and MasterCard payments from the eSec Payment Gateway, you will need to obtain an Internet Merchant Account Facility from your bank and complete the Merchant Application at the eSec Payments Gateway website. For more information, visit the SecurePay website.

Interface Options

This section allows you to change the wording of the buttons for the payment gateway.

The Interface Options section of the Details screen
The Interface Options section of the Details screen

The fields that are available in this section are as follows:

  • Submit Button Text: enter the text to display as the submit button. By default, this button will read Submit. This button is displayed when the keyword replacement Submit Button is used on the Display Format Bodycopy.
  • Reset Button Text: enter the text to display as the reset button. By default, this button will read Reset. This button is displayed when the keyword replacement Reset Button is used on the Display Format Bodycopy.
  • Cancel Button Text: enter the text to display as the cancel button. By default, this button will read Cancel. This button is displayed when the keyword replacement Cancel Button is used on the Display Format Bodycopy.
Testing Mode

This section allows you to modify the payment gateway to function in Test Mode.

The Testing Mode section of the Details screen
The Testing Mode section of the Details screen

In the Test Mode field, select whether or not to use the payment gateway for testing purposes only. If this field is set to On, the payment gateway will not process any payments and the Number field on the SecurePay eSec Payment Gateway form will be replaced with the test drop down menu, as shown in the figure below.

The payment gateway in Test Mode
The SecurePay eSec Payment Gateway running in Test Mode

Display Formatting Screen

The Display Formatting screen allows you to edit the Display Format Bodycopy. Please note that this Bodycopy can also be edited by right clicking on the Display Format Bodycopy in the Asset Map and selecting Edit Contents.

Display Format Bodycopy

The Display Format Bodycopy is used to define the layout of the SecurePay eSec Payment Gateway page. The default layout of the payment gateway is shown in the figure below.

An example payment gateway
The default layout of the SecurePay eSec Payment Gateway

To change the information that is being shown, click on the edit icon icon – the WYSIWYG Editor will appear where you can use the keyword replacements and formatting to set the layout of the information to show on the payment gateway page. By default, the information shown in the figure below will appear in the WYSIWYG Editor.

The WYSIWYG Editor on the Display Format Bodycopy
The WYSIWYG Editor on the Display Format Bodycopy

Keyword Replacements on the Display Format Bodycopy

A list of keyword replacements is provided in the WYSIWYG Editor toolbar on the Edit Contents screen of the Display Format Bodycopy. You can use these keyword replacements in conjunction with text, images and links etc to configure the layout of the payment gateway page. The standard keyword replacements that are available include the following:

  • Credit Card Number: this will show the credit card number field.
  • Credit Card Expiry Year: this will show the credit card expiry year field.
  • Credit Card Expiry Month: this will show the credit card expiry month field.
  • Name on card: this will show the name on card field.
  • Credit Card CCV field: this will show the credit card CCV field.
  • Credit Card Type Selector: this will show the credit card selector field. VISA and MasterCard are the options available in this field.
  • Submit Button: this will show the submit button on the payment gateway.
  • Cancel Button: this will show the cancel button on the payment gateway.
  • Reset Button: this will show the reset button on the payment gateway.
  • Transaction Amount: this will show the amount of money that is to be paid in the transaction.
  • Processing Error (empty if no error): this will show any processing errors. For example, if the user forgets to fill out a field.

Tip: The majority of these fields are compulsory when creating a working payment gateway. The Cancel Button, Reset Button, Transaction Amount and Processing Errors fields are not mandatory but are highly recommended.


Previous Chapter Next Chapter

The Latest

Let Us Know What You Think

Let us know if you spot any errors or if you have any ideas on how we can improve the Matrix Community Website.

Contact Squiz for Demo

Let us show you the true power of Squiz Matrix by giving you a personalised demonstration.